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 秒)。
   パーツの長さ (ms)	(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());

        // Clientの設定
        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>")
                // リクエストレベルの設定を上書きして、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();
    }

}