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

コンソール

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

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

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

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

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

   説明

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

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 などの Credentials 認証情報を設定します。
        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()) // サービスレベルの設定
                // クライアントレベルの設定を上書きし、Endpoint、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();
    }

}