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

コンソール

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

2. 左側のナビゲーションペインで、機能管理 > ライブストリームのカプセル化 を選択します。

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

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

   パラメーター	説明
   AppName	すべてのアプリケーションに適用するには、アスタリスク (*) を入力します。特定のアプリケーションを対象とする場合は、アップストリーミング URL の AppName を入力します。
   StreamName	すべてのストリームに適用するには、アスタリスク (*) を入力します。特定のストリームを対象とする場合は、ストリーム名を入力します。
   プロトコル	コンテナフォーマットと再生プロトコルを選択します。有効な値： 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()) // サービスレベルの設定
                // クライアントレベルの設定上書き。Endpoint、Httpリクエストパラメーターなどを設定できます
                .overrideConfiguration(
                        ClientOverrideConfiguration.create()
                                  // Endpointについては https://api.aliyun.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();
    }

}