PlayChoosenShow - - Alibaba Cloud ドキュメントセンター

使用上の注意

エピソードリストにエピソードを追加してライブストリームを開始した後、この操作を呼び出してエピソードを切り替えることができます。エピソードリストにエピソードを追加する方法については、「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);
    }