制作スタジオを開始します。

使用状況ノート

制作スタジオにプレビューシーンやプログラムシーンがない場合は、このようなシーンを作成して開始し、オーディオやビデオの処理を開始します。

QPS制限

1人のユーザーが1秒あたり最大10件のクエリ (QPS) を実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 StartCaster

実行したい操作。 値をStartCasterに設定します。

CasterId String 必須 80787064-1c94-4dc1-85ce-9409960a ****

制作スタジオのID。

CreateCaster インターフェイスを使用して制作スタジオを作成する場合は、レスポンスのCasterIdパラメーターの値を確認します。

ApsaraVideo Live Consoleを使用して制作スタジオを作成する場合は、コンソールにログインし、次のパスを使用して制作スタジオのIDを確認します。

制作スタジオ > 制作スタジオ管理

注 CasterIdは、Production Studio Managementページの [名前] 列に反映されます。
RegionId String 任意 cn-shanghai

リージョンの ID

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String 6EBD1AC4-C34D-4AE1-963E-B688A228BE31

リクエストの ID です。
PvwSceneInfos SceneInfoの配列

プレビューシーンに関する情報。
SceneInfo
SceneId String b5f8c837-ceeb-424f-b30b-68e94e86 ****

シーンのID。
StreamUrl String rtmp:// abclive/caster/definc.flv

プロダクションスタジオのプレビューシーンのストリーミングURL。 値はサードパーティの取り込みURLではありません。
PgmSceneInfos SceneInfoの配列

プログラムシーンに関する情報。
SceneInfo
SceneId String b5f8c837-ceeb-424f-b30b-68e94e86 ****

シーンのID。
StreamUrl String rtmp:// abclive/caster/******.flv

制作スタジオのプログラムシーンのストリーミングURL。 値はサードパーティの取り込みURLではありません。
StreamInfos StreamInfoの配列

サードパーティの取り込みURLに関する情報。
StreamInfo
TranscodeConfig String lld

制作スタジオのトランスコードに関する設定。 設定可能な値は以下のとおりです。

  • lsd: 標準定義。
  • lld: 低い定義。
  • lud: 超高い定義。
  • lhd: 高解像度。
VideoFormat String flv

シーンが再生のためにストリームをトランスコードするフォーマット。 設定可能な値は以下のとおりです。

  • flv
  • rtmp
  • m3u8
OutputStreamUrl String rtmp:// abclive/caster/******.flv

ストリーミングURL。

例

リクエストの例

https://live.aliyuncs.com/?Action=StartCaster
&CasterId=80787064-1c94-4dc1-85ce-9409960a ****
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

<StartCasterResponse>
  <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
  <PvwSceneInfos>
        <SceneId>b5f8c837-ceeb-424f-b30b-68e94e86 ****</SceneId>
        <StreamUrl>rtmp:// aliLive/caster/1975ee99db904ebb83908d43bc878188?auth_key=1506396160-0-0-063397072a9980fd418d43eb00e0 ****</StreamUrl>
  </PvwSceneInfos>
  <PgmSceneInfos>
        <SceneId>b5f8c837-ceeb-424f-b30b-68e94e86 ****</SceneId>
        <StreamUrl>rtmp:// aliLive/caster/1975ee99db904ebb83908d43bc878188?auth_key=1506396160-0-0-063397072a9980fd418d43eb00e02e10</StreamUrl>
        <StreamInfos>
              <VideoFormat>flv</VideoFormat>
              <OutputStreamUrl>http:// aliLive/caster/fb628e2469f94f2aa2c0c219af8b2527_lld.flv?auth_key=1506396160-0-0-7de771a77102680861853af862d5 ****</OutputStreamUrl>
              <TranscodeConfig>lld</TranscodeConfig>
        </StreamInfos>
        <StreamInfos>
              <VideoFormat>rtmp</VideoFormat>
              <OutputStreamUrl>rtmp:// aliLive/caster/fb628e2469f94f2aa2c0c219af8b2527_lld?auth_key=1506396160-0-0-77ed32cd82ed32ccd51a832b5765 ****</OutputStreamUrl>
              <TranscodeConfig>lld</TranscodeConfig>
        </StreamInfos>
        <StreamInfos>
              <VideoFormat>m3u8</VideoFormat>
              <OutputStreamUrl>http:// aliLive/caster/fb628e2469f94f2aa2c0c219af8b2527.m3u8?auth_key=1506396160-0-0-d51f0512dcf76aa749f79f53ae64 ****</OutputStreamUrl>
              <TranscodeConfig>lld</TranscodeConfig>
        </StreamInfos>
  </PgmSceneInfos>
</StartCasterResponse>

JSON 形式 

{
    "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
    "PvwSceneInfos": [
        {
           "SceneId":"b5f8c837-ceeb-424f-b30b-68e94e86 ****" 、
           "StreamUrl":"rtmp:// aliLive/caster/1975ee99db904ebb83908d43bc878188?auth_key=1506396160-0-0-063397072a9980fd418d43eb00e0 ****"
        }
    ],
    "PgmSceneInfos": [
      {
         "SceneId":"b5f8c837-ceeb-424f-b30b-68e94e86 ****" 、
         "StreamUrl":"rtmp:// aliLive/caster/1975ee99db904ebb83908d43bc878188?auth_key=1506396160-0-0-063397072a9980fd418d43eb00e0 ****" 、
         "StreamInfos": [
                {
                    "VideoFormat": "flv" 、
                    "OutputStreamUrl": "http:// aliLive/caster/fb628e2469f94f2aa2c0c219af8b2527_lld.flv?auth_key=1506396160-0-0-7de771a77102680861853af862d5 ****" 、
                    "TranscodeConfig": "lld"
                },
                {
                    "VideoFormat": "rtmp" 、
                    "OutputStreamUrl": "rtmp:// aliLive/caster/fb628e2469f94f2aa2c0c219af8b2527_lld? auth_key=1506396160-0-0-77ed32cd82ed32ccd51a832b5765 **** "、
                    "TranscodeConfig": "lld"
                },
                {
                    "VideoFormat": "m3u8" 、
                    "OutputStreamUrl": "http:// aliLive/caster/fb628e2469f94f2aa2c0c219af8b2527.m3u8?auth_key=1506396160-0-0-d51f0512dcf76aa749f79f53ae6421d2" 、
                    "TranscodeConfig": "lld"
                }
            ]
      }
    ]
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。