ModifyShowList - ApsaraVideo Live - Alibaba Cloud ドキュメントセンター

使用上の注意

この操作により、プレイリスト内の番組の位置、プレイリストの再生回数、プレイリスト内で最も優先度の高い番組が再生される特定の時点を変更できます。

QPS制限

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

デバッグ

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

リクエストパラメーター


パラメーター	タイプ	必須／任意	例	説明
アクション	String	はい	ModifyShowList	実行する操作です。値をModifyShowListに設定します。
CasterId	文字列	必須	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。注 AddShowIntoShowListまたはDescribeShowList操作を呼び出し、応答パラメーターShowIdの値を確認してプログラムIDを取得できます。
RepeatTimes	Integer	いいえ	5	プレイリストが再生される追加の回数。注 RepeatTimesパラメーターは、繰り返し回数を指定します。たとえば、値を0に設定すると、プレイリストは1回再生されます。値を1に設定すると、プレイリストは2回再生されます。
スポット	Integer	任意	1	プレイリスト内のプログラムの位置。プレイリスト内の位置を変更するプログラムのIDをスポットに配置します。注値は0以上で、プレイリスト内のプログラムの総数以下でなければなりません。
HighPriorityShowId	文字列	いいえ	a2b8e671-2fe5-4642-a2ec-bf93880e ****	最優先のプログラム。注このパラメーターは、プレイリストの開始前にのみ設定できます。
HighPriorityShowStartTime	文字列	いいえ	2021-11-23T12:30:00	最も優先度の高い番組が再生される時間。形式: _yyyy-MM-dd'T'HH:mm:ss_。注このパラメーターは、プレイリストの開始前にのみ設定できます。このパラメーターを設定した後、指定された時点に達すると、再生中のプログラムが停止し、プレイリストで最も優先度の高いプログラムが再生を開始します。

応答パラメータ


パラメーター	データ型	例	説明
RequestId	String	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8	リクエストの ID です。

例

リクエストの例

http(s):/live.aliyuncs.com/?Action=ModifyShowList
&CasterId=LIVEPRODUCER_POST-cn-0pp1czt ****
&<共通リクエストパラメーター>

成功応答のサンプル

XML 形式

<ModifyShowListResponse> 
  <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</ModifyShowListResponse>

JSON 形式

{"RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"}

エラーコード

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

サンプルコード


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


プライベート静的CommonResponse ModfiyShowList(DefaultAcsClientクライアント、String casterId、String showId、整数repeatTimes、整数スポット、
                                                 String highPriorityShowId、String highPriorityShowStartTime) はClientException {をスローします

        CommonRequest modfiyShowListRequest=新しいCommonRequest();
        modfiyShowListRequest.setSysDomain("live.aliyuncs.com");
        modfiyShowListRequest.setSysVersion("2016-11-01");
        modfiyShowListRequest.setSysAction("ModifyShowList");
        if (casterId != null) {
            modfiyShowListRequest.putQueryParameter("CasterId" 、casterId);
        }
        if (showId != null) {
            modfiyShowListRequest.putQueryParameter("ShowId" 、showId);
        }
        if (repeatTimes != null) {
            modfiyShowListRequest.putQueryParameter("RepeatTimes", repeatTimes.toString());
        }
        if (spot != null) {
            modfiyShowListRequest.putQueryParameter("Spot", spot.toString());
        }
        if (highPriorityShowId != null) {
            modfiyShowListRequest.putQueryParameter("HighPriorityShowId", highPriorityShowId.toString());
        }
        if (highPriorityShowStartTime != null) {
            modfiyShowListRequest.putQueryParameter("HighPriorityShowStartTime", highPriorityShowStartTime.toString());
        }
        CommonResponse modfiyShowListResponse = client.getCommonResponse(modfiyShowListRequest);
        System.out.println("プレイリストの属性が変更された場合、次の値が返されます。" + JSON.toJSONString(modfiyShowListResponse));
        modfiyShowListResponseを返します。

    }

public void modifyShowList() throws ClientException {
        DefaultAcsClient client = initClient(ACCESS_KEY_ID, ACCESS_KEY_SECRET);
        文字列showId= "";
        整数repeatTimes=10;
        文字列highPriorityShowId="";
        文字列highPriorityShowStartTime = "2021-11-23T12:30:00";
        modfiyShowList (クライアント、testCasterId、showId、repeatTimes、0、highPriorityShowId、highPriorityShowStartTime);
    }