指定したエピソードに切り替えます。

使用上の注意

エピソードリストにエピソードを追加してライブストリームを開始した後、この操作を呼び出してエピソードを切り替えることができます。 エピソードリストにエピソードを追加する方法については、「AddShowIntoShowList」をご参照ください。

QPS制限

Alibaba Cloudアカウントを使用して、この操作を呼び出すために1秒あたり最大10件のリクエストを送信できます。 1秒あたりの呼び出し数が制限を超えると、スロットリングがトリガーされます。 これはビジネスに影響を与える可能性があります。 この操作を呼び出すときは、制限に注意することをお勧めします。 詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。

デバッグ

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

リクエストパラメーター

パラメーター タイプ 必須 例 説明
操作 String 必須 PlayChoosenShow

実行する操作。The operation that you want to perform. 値をPlayChoosenShowに設定します。

CasterId String 必須 LIVEPRODUCER_POST-cn-0pp1czt ****

プロダクションスタジオインスタンスのID。

  • インスタンスがCreateCaster操作を呼び出して作成された場合は、レスポンスパラメーターCasterIdの値を確認してインスタンスIDを取得します。
  • インスタンスがApsaraVideo Liveコンソールで作成された場合、[Production Studio Management] ページでインスタンスIDを取得します。 ページに移動するには、ApsaraVideo Liveコンソールにログインし、左側のナビゲーションウィンドウで [Production Studios] をクリックします。
注 [Production Studio Management] ページのインスタンスの [名前] 列に表示される値は、インスタンスのIDです。
ShowId String 必須 a2b8e671-2fe5-4642-a2ec-bf93880e ****

切り替え先のエピソードのID。

注 エピソードIDは、AddShowIntoShowListまたはDescribeShowListのレスポンスパラメーターから取得できます。

応答パラメータ

パラメーター データ型 例 説明
RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

リクエストの ID です。

ShowId String a2b8e671-2fe5-4642-a2ec-bf93880e ****

エピソードのID。

例

リクエストの例

http(s):// live.aliyuncs.com/?Action=PlayChoosenShow
&CasterId=LIVEPRODUCER_POST-cn-0pp1czt ****
&ShowId=a2b8e671-2fe5-4642-a2ec-bf93880e ****
&<共通リクエストパラメーター>

成功応答のサンプル

XML形式 

<PlayChoosenShowResponse> 
  <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
  <ShowId>a2b8e671-2fe5-4642-a2ec-bf93880e ****</ShowId>
</PlayChoosenShowResponse>

JSON形式 

{"RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8","ShowId":"a2b8e671-2fe5-4642-a2ec-bf93880e ****"}

エラーコード

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

サンプルコード


public static DefaultAcsClient initClient(String accessKeyId, String accessKeySecret) throws ClientException {
        String regionId = "cn-shanghai"; 
        DefaultProfile profile = DefaultProfile.getProfile(regionId、accessKeyId、accessKeySecret);
        DefaultAcsClientクライアント=新しいDefaultAcsClient (プロファイル);
        クライアントを返します。
    }

private static void playChoosenShow(DefaultAcsClientクライアント、String casterId、String showId) throws ClientException {
        CommonRequest playChoosenShow=新しいCommonRequest();
        playChoosenShow.setSysDomain (「live.aliyuncs.com」);
        playChoosenShow.setSysVersion("2016-11-01");
        playChoosenShow.setSysAction("playChoosenShow");
        playChoosenShow.putQueryParameter("CasterId" 、casterId);
        playChoosenShow.putQueryParameter("ShowId" 、showId);
        CommonResponse playChoosenShowResponse = client.getCommonResponse(playChoosenShow);
        System.out.println("showIdの手動切り替え:" + showId + "completed");
    }

public void playChooseShow() がClientExceptionをスロー {
        DefaultAcsClient client = initClient(ACCESS_KEY_ID, ACCESS_KEY_SECRET);
        文字列showId= "";
        playChoosenShow (クライアント、testCasterId、showId);
    }