ApsaraVideo Live:ライブストリームのカプセル化

コンソール

1. ApsaraVideo Live コンソールにログインします。

2. 左側メニューで、機能管理 > ライブストリームのカプセル化 を選択します。

3. ストリーミングドメインを選択し、追加 をクリックします。

4. [カプセル化設定] ダイアログボックスで、次のパラメータを設定します。

   パラメータ	説明
   AppName	すべてのアプリケーションに適用するには、アスタリスク (*) を入力します。特定のアプリケーションを対象とするには、取り込み URL の AppName を入力します。値は 255 文字以内にする必要があります。
   StreamName	すべてのストリームに適用するには、アスタリスク (*) を入力します。特定のストリームを対象とするには、ストリーム名を入力します。値は 255 文字以内にする必要があります。
   プロトコル	コンテナフォーマットと再生プロトコルを選択します。有効な値： HLS - CMAF LL-HLS - CMAF LL-HLS - TS DASH - CMAF HLS & DASH - CMAF
   セグメント数	マニフェストファイルあたりのセグメント数を指定します。有効な値: 3～5。
   セグメント長 (秒)	HLS または DASH の場合： 1～10 の整数を入力します。GOP サイズの倍数に設定してください (推奨 GOP: 5 秒)。 LL-HLS の場合： 1 または 2 を入力します。GOP サイズの倍数に設定してください (推奨 GOP: 1 秒)。
   パート長 (ミリ秒)	(LL-HLS のみ)： パーシャルセグメントの期間を指定します。有効な値: 200～1,000。セグメント長の 3 分の 1 よりわずかに大きい値を推奨します。
   トランスコードストリーム	トランスコードされたストリームをカプセル化するかどうかを指定します。有効な値： ソースストリームのみ トランスコードストリームを含む

   説明

   ストリーミングドメインが中国本土以外のライブセンター (シンガポール、ドイツ、日本、またはインドネシア) を使用している場合、再生遅延が増加する可能性があります。本番環境で使用する前に、設定をテストしてください。

5. [OK] をクリックします。

API

AddLivePackageConfig API を呼び出して、カプセル化設定を追加します。

<Your RegionId>、<Your DomainName>、<Your AppName>、<Your StreamName> などのプレースホルダーを置き換えてください。

有効なプロトコル値については、「AddLivePackageConfig」をご参照ください。

サンプルコード

// このファイルは自動生成されています。編集しないでください。
package demo;

import com.aliyun.auth.credentials.Credential;
import com.aliyun.auth.credentials.provider.StaticCredentialProvider;
import com.aliyun.core.http.HttpClient;
import com.aliyun.core.http.HttpMethod;
import com.aliyun.core.http.ProxyOptions;
import com.aliyun.httpcomponent.httpclient.ApacheAsyncHttpClientBuilder;
import com.aliyun.sdk.service.live20161101.models.*;
import com.aliyun.sdk.service.live20161101.*;
import com.google.gson.Gson;
import darabonba.core.RequestConfiguration;
import darabonba.core.client.ClientOverrideConfiguration;
import darabonba.core.utils.CommonUtil;
import darabonba.core.TeaPair;

//import javax.net.ssl.KeyManager;
//import javax.net.ssl.X509TrustManager;
import java.net.InetSocketAddress;
import java.time.Duration;
import java.util.*;
import java.util.concurrent.CompletableFuture;
import java.io.*;

public class AddLivePackageConfig {
    public static void main(String[] args) throws Exception {

        // HttpClient を設定します。
        /*HttpClient httpClient = new ApacheAsyncHttpClientBuilder()
                .connectionTimeout(Duration.ofSeconds(10)) // 接続タイムアウト時間を設定します。デフォルトは 10 秒です。
                .responseTimeout(Duration.ofSeconds(10)) // レスポンスタイムアウト時間を設定します。デフォルトは 20 秒です。
                .maxConnections(128) // 接続プールサイズを設定します。
                .maxIdleTimeOut(Duration.ofSeconds(50)) // 接続プールタイムアウトを設定します。デフォルトは 30 秒です。
                // プロキシを設定します。
                .proxy(new ProxyOptions(ProxyOptions.Type.HTTP, new InetSocketAddress("<YOUR-PROXY-HOSTNAME>", 9001))
                        .setCredentials("<YOUR-PROXY-USERNAME>", "<YOUR-PROXY-PASSWORD>"))
                // https 接続の場合は、証明書を設定するか、証明書を無視する必要があります (.ignoreSSL(true))。
                .x509TrustManagers(new X509TrustManager[]{})
                .keyManagers(new KeyManager[]{})
                .ignoreSSL(false)
                .build();*/

        // 認証情報 (ak、secret、token を含む) を設定します。
        StaticCredentialProvider provider = StaticCredentialProvider.create(Credential.builder()
                // 環境変数 ALIBABA_CLOUD_ACCESS_KEY_ID と ALIBABA_CLOUD_ACCESS_KEY_SECRET が設定されていることを確認してください。
                .accessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                .accessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"))
                //.securityToken(System.getenv("ALIBABA_CLOUD_SECURITY_TOKEN")) // STS トークンを使用します。
                .build());

        // クライアントを設定します。
        AsyncClient client = AsyncClient.builder()
                .region("<Your RegionId>") // リージョン ID
                //.httpClient(httpClient) // 設定された HttpClient を使用します。それ以外の場合は、デフォルトの HttpClient (Apache HttpClient) を使用します。
                .credentialsProvider(provider)
                //.serviceConfiguration(Configuration.create()) // サービスレベルの設定
                // クライアントレベルの設定を上書きし、エンドポイント、HTTP リクエストパラメータなどを設定できます。
                .overrideConfiguration(
                        ClientOverrideConfiguration.create()
                                  // エンドポイントについては、https://api.alibabacloud.com/product/live を参照してください。
                                .setEndpointOverride("live.aliyuncs.com")
                        //.setConnectTimeout(Duration.ofSeconds(30))
                )
                .build();

        // API リクエストのパラメータを設定します。
        AddLivePackageConfigRequest addLivePackageConfigRequest = AddLivePackageConfigRequest.builder()
                .regionId("<Your RegionId>")
                .domainName("<Your DomainName>")
                .appName("<Your AppName>")
                .streamName("<Your StreamName>")
                .protocol("<Protocol>")
                // リクエストレベルの設定を上書きし、HTTP リクエストパラメータなどを設定できます。
                // .requestConfiguration(RequestConfiguration.create().setHttpHeaders(new HttpHeaders()))
                .build();

        // API リクエストの戻り値を非同期で取得します。
        CompletableFuture<AddLivePackageConfigResponse> response = client.addLivePackageConfig(addLivePackageConfigRequest);
        // API リクエストの戻り値を同期的に取得します。
        AddLivePackageConfigResponse resp = response.get();
        System.out.println(new Gson().toJson(resp));
        // 戻り値の非同期処理
        /*response.thenAccept(resp -> {
            System.out.println(new Gson().toJson(resp));
        }).exceptionally(throwable -> { // 例外処理
            System.out.println(throwable.getMessage());
            return null;
        });*/

        // 最後に、クライアントを閉じます。
        client.close();
    }

}