指定したプレビューシーンを開始します。

使用状況ノート

この操作は、PVWシーンにのみ適用されます。

QPS制限

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

デバッグ

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

リクエストパラメーター

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

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

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

制作スタジオのID。

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

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

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

注 CasterIdは、Production Studio Managementページの [名前] 列に反映されます。
SceneId String 必須 242b4e2c-c30f-4442-85ba-2e3e4e3d ****

シーンのID。

このパラメーターは、シーンがプレビューシーンの場合にのみ有効です。 シーンの詳細については、「プロダクションスタジオのシーンの照会」をご参照ください。

RegionId String 任意 cn-shanghai

リージョンの ID

レスポンスパラメーター

パラメーター データ型 例 説明
RequestId String CF60DB6A-7FD6-426E-9288-122CC1A52FA7

リクエストの ID です。
StreamUrl String http:// live/caste r/example.org

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

例

リクエストの例

http(s):// live.aliyuncs.com/?Action=StartCasterScene
&CasterId=80787064-1c94-4dc1-85ce-9409960a ****
&SceneId=242b4e2c-c30f-4442-85ba-2e3e4e3d ****
&<共通リクエストパラメーター>

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

XML 形式 

<StartCasterSceneResponse>
      <RequestId>CF60DB6A-7FD6-426E-9288-122CC1A52FA7</RequestId>
      <RequestId>http:// live/caster/example.org</RequestId>
</StartCasterSceneResponse>

JSON 形式 

{
    "RequestId": "CF60DB6A-7FD6-426E-9288-122CC1A52FA7" 、
    "StreamUrl":"http:// live/caste r/example.org"
}

エラーコード

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