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

使用状況ノート

この操作を呼び出す前に、最新のプレイリストモードでプロダクションスタジオインスタンスを作成し、そのインスタンスにメディアリソースを追加する必要があります。操作を呼び出してプロダクションスタジオインスタンスを作成する方法については、「CreateCaster」をご参照ください。

重要

ApsaraVideo VODからメディアリソースを選択する場合、ホストされたObject Storage Service (OSS) バケットに保存されているリソースを選択することを推奨します。カスタムOSSバケットに保存されているリソースには有効期間があります。カスタムOSSバケットに保存されているリソースを選択するときは、有効性に注意してください。
プロダクションスタジオインスタンスにメディアリソースを追加する場合は、ApsaraVideo LiveおよびApsaraVideo VODからリソースを選択することを推奨します。ストリーミングURLを指定してサードパーティのストリームを追加すると、ストリームの再生に失敗することがあります。サードパーティのストリームの品質と有効性に注意を払う必要があります。

QPS制限

この操作は、アカウントごとに1秒あたり最大10回呼び出すことができます。 If the number of the calls per second exceeds the limit, throttling is triggered. その結果、あなたのビジネスが影響を受ける可能性があります。この操作を呼び出すときは、制限に注意することをお勧めします。詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。

デバッグ

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

リクエストパラメーター


パラメーター	データ型	必須／任意	例	説明
操作	String	必須	AddShowIntoShowList	実行する操作です。値をAddShowIntoShowListに設定します。
CasterId	String	必須	LIVEPRODUCER_POST-cn-0pp1czt ****	プロダクションスタジオインスタンスのID。インスタンスがCreateCaster操作を呼び出して作成された場合は、レスポンスパラメーターCasterIdの値を確認してインスタンスIDを取得します。インスタンスがApsaraVideo Liveコンソールで作成された場合、[Production Studio Management] ページでインスタンスIDを取得します。ページに移動するには、ApsaraVideo Liveコンソールにログインし、左側のナビゲーションウィンドウで [Production Studios] をクリックします。注 [Production Studio Management] ページのインスタンスの [名前] 列に表示される値は、インスタンスのIDです。
ResourceType	String	必須	vod	リソースタイプ。設定可能な値は以下のとおりです。 live: ライブストリーミングリソース vod: オンデマンドリソース pic: イメージ注 When you select media resources from ApsaraVideo VOD, we recommend that you select resources that are stored in hosted Object Storage Service (OSS) buckets. カスタムOSSバケットに保存されているリソースには有効期間があります。カスタムOSSバケットに保存されているリソースを選択するときは、有効性に注意してください。 ApsaraVideo Liveから、またはサードパーティのURLをライブストリーミングリソースとして使用して、メディアリソースを追加できます。 ApsaraVideo VODから、またはサードパーティのURLを使用してメディアリソースを追加したり、オンデマンドリソースとして画像を追加したりできます。
RegionId	String	いいえ	cn-上海	リージョンの ID
ShowName	String	いいえ	liveShow ****	The name of the episode.
ResourceUrl	String	いいえ	http:// **/atestObject **.m3u8	リソースのURL。
ResourceId	String	任意	a2b8e671-2fe5-4642-a2ec-bf93880e****	リソースのID。
期間	Long	No	20	エピソードの持続時間 (秒単位) 。注 RepeatTimesパラメーターとDurationパラメーターのいずれかのみを指定できます。
RepeatTimes	Integer	任意	0	最初の再生が完了した後にエピソードが繰り返される回数。デフォルト値は 0 です。注 You can specify only one of the RepeatTimes and Duration parameters. RepeatTimesパラメーターは、繰り返し回数を指定します。 For example, if you set the value to 0, the episode is to be played once. 値を1に設定すると、エピソードは2回再生されます。
スポット	整数	いいえ	1	エピソードリスト内のエピソードの位置。ポジションインデックスは0から始まります。デフォルトでは、エピソードはエピソードリストに追加されます。

レスポンスパラメーター


パラメーター	データ型	例	説明
RequestId	String	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8	リクエストのID。
ShowId	String	a2b8e671-2fe5-4642-a2ec-bf93880e ****	エピソードのID。

例

リクエストの例

http(s)://live.aliyuncs.com/?Action=AddShowIntoShowList
&CasterId=LIVEPRODUCER_POST-cn-0pp1czt****
&ResourceType=vod
&<Common request parameters>

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

XML 形式

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

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 client = new DefaultAcsClient(profile);
        return client;
    }

プライベート静的CommonResponse addShowIntoShowList(DefaultAcsClientクライアント、文字列showName、文字列resourceId、文字列resourceUrl、
                                                      文字列resourceType, 整数スポット, 整数repeatTimes,
                                                      String casterId、長時間) はClientException {をスローします
        CommonRequest addShowIntoShowListRequest=新しいCommonRequest();
        addShowIntoShowListRequest.setSysDomain("live.aliyuncs.com");
        addShowIntoShowListRequest.setSysVersion("2016-11-01");
        addShowIntoShowListRequest.setSysAction("AddShowIntoShowList");


  
        if (casterId == null | | resourceType == null) {
            ヌルを返します。
        }
        if (resourceId == null && resourceUrl == null) {
            nullを返します。
        }
        addShowIntoShowListRequest.putQueryParameter("CasterId" 、casterId);
        addShowIntoShowListRequest.putQueryParameter("ResourceType", resourceType);
        if (showName != null) {
            addShowIntoShowListRequest.putQueryParameter("ShowName" 、showName);
        }
        if (resourceUrl != null) {
            addShowIntoShowListRequest.putQueryParameter("ResourceUrl", resourceUrl);
        }
        if (resourceId != null) {
            addShowIntoShowListRequest.putQueryParameter("ResourceId" 、resourceId);
        }
        if (spot != null) {
            addShowIntoShowListRequest.putQueryParameter("Spot" 、spot.toString());
        }
        if (repeatTimes != null) {
            addShowIntoShowListRequest.putQueryParameter("RepeatTimes", repeatTimes.toString());
        }
        if (duration != null) {
            addShowIntoShowListRequest.putQueryParameter("Duration", duration.toString());
        }
        CommonResponse addShowIntoShowListResponse = client.getCommonResponse(addShowIntoShowListRequest);
        addShowIntoShowListResponseを返します。
    }


    public void addshows() throws ClientException {
        DefaultAcsClient client = initClient(ACCESS_KEY_ID, ACCESS_KEY_SECRET);
        String[] resourceIds = new String[]{"698d2b23581f476ea71107703e647d1e", "9c97e83e211a435b9f797e4e20eeea27", "76c6addaa41c438985666a8a964fa5e5"};
        for (int i = 0; i < resourceIds.length; i ++) {
            文字列showName = "ShowName#" + i;
            整数repeatTimes = i;
            addShowIntoShowList(client, showName, resourceIds[i], null, "vod", null, repeatTimes, testCasterId, null);
        }
    }