ApsaraVideo Live:ライブストリーム录音

ストレージ方法の比較

ApsaraVideo VODまたはOSSバケットにライブストリームを保存できます。 ストレージ方法はさまざまなシナリオで使用されます。 ビジネス要件に基づいてストレージ方法を選択できます。

制限事項

オーディオとビデオのエンコード形式

ApsaraVideo Liveは、最初にライブストリームをTSセグメントにスライスする必要があります。 取り込むライブストリームのオーディオとビデオのエンコード形式は、TS形式の要件を満たす必要があります。 FLVおよびISO/IEC 13818-1規格に基づいて、記録機能は次のエンコード形式をサポートします。

• ビデオ: H.264、高効率ビデオコーディング (HEVC) 、およびMPEG-4

• オーディオ: 高度なオーディオコーディング (AAC) とMP3

異常なライブストリーム

ライブストリーム録画機能は、通常のライブストリームの録画ファイルを生成できます。 通常のライブストリームは、サポートされるフォーマットで符号化されるストリーム、安定したフレームレートを有するストリーム、およびタイムスタンプが単調かつ線形に増加されるストリームを含みます。 ライブストリームのフレームレートが不安定な場合や、ライブストリームのタイムスタンプがジャンプする場合は、互換性が広いため、ライブストリーム用の記録ファイルを生成することもできます。 しかしながら、取り込まれたライブストリーム上で重大な例外が検出された場合、特徴は、取り込まれたライブストリームのための記録ファイルを生成することに失敗し得ます。重大な例外は、長期間にわたって検出されたビデオフレームがないこと、予期しないタイムスタンプが増加すること、ならびにオーディオおよびビデオヘッダの欠落を含みます。

前提条件

ApsaraVideo VODが有効化されています。 詳細については、「ApsaraVideo VODの有効化」をご参照ください。

VODバケットを有効にして、ApsaraVideo VODに録画ファイルを保存できます。 詳細については、「VODバケットの有効化」をご参照ください。

ストレージ設定の構成Configure storage settings

前提条件が満たされたら、ApsaraVideo VODに録画ファイルを保存するために必要な設定を構成できます。

ApsaraVideo Liveは、ApsaraVideo VODに録画ファイルを保存するための次の方法を提供します。

1. ApsaraVideo Liveコンソールで設定を行います。 詳細については、「ApsaraVideo VODでの録画の保存」をご参照ください。

2. API操作を呼び出します。 詳細については、「AddLiveRecordVodConfig」をご参照ください。次のセクションでは、SDK for Javaを使用して、ApsaraVideo VODに保存する録画ファイルの設定を行う方法について説明します。

//Replace the content in the angle brackets <> with actual values.
DefaultProfile profile = DefaultProfile.getProfile("<regionId>", "<ALIBABA_CLOUD_ACCESS_KEY_ID>", "<ALIBABA_CLOUD_ACCESS_KEY_SECRET>");
IAcsClient client = new DefaultAcsClient(profile);   
AddLiveRecordVodConfigRequest addLiveRecordVodConfigRequest=new AddLiveRecordVodConfigRequest();
addLiveRecordVodConfigRequest.setDomainName("<DomainName>");
addLiveRecordVodConfigRequest.setAppName("<AppName>");
addLiveRecordVodConfigRequest.setStreamName("<StreamName>");
addLiveRecordVodConfigRequest.setVodTranscodeGroupId("VOD_NO_TRANSCODE");
//The address of the VOD bucket.
addLiveRecordVodConfigRequest.setStorageLocation("<StorageLocation>");
AddLiveRecordVodConfigResponse dddLiveRecordVodConfigResponse = null;
try {
    dddLiveRecordVodConfigResponse = client.getAcsResponse(addLiveRecordVodConfigRequest);
} catch (ClientException e) {
    e.printStackTrace();
}
 System.out.println(new Gson().toJson(dddLiveRecordVodConfigResponse));

録音のコード変換

記録ファイルはM3U8形式で保存されます。 録音ファイルを別の形式で保存する場合は、トランスコーディングを設定できます。 トランスコードを設定するためのサンプルコード:

 addLiveRecordVodConfigRequest.setVodTranscodeGroupId("<TranscodeGroupId>");

録音のマージ

以下のシナリオでは、録音をマージできます。

1. ライブストリームが中断されたが、以内に180秒で再取り込みされた場合、中断の前後に生成された録画ファイルは自動的に1つの録画ファイルにマージされます。

2. ライブストリームの持続時間が記録サイクルを超える場合、記録サイクルの前後に生成される記録ファイルをマージすることができる。 ライブストリームの持続時間が記録サイクルを超えた後、新しい記録ファイルが生成される。 例えば、記録サイクルが5分であり、ストリーム取り込み期間が8分である場合、ストリームが取り込まれた後に2つの記録ファイルが生成されます。

記録サイクルを設定するためのサンプルコード:

//Unit: seconds. Valid values: 300 to 21600.
addLiveRecordVodConfigRequest.setCycleDuration(<300>);

異なる記録サイクルの記録ファイルをマージする場合は、マージ設定を構成できます。

記録ファイルをマージするためのサンプルコード:

addLiveRecordVodConfigRequest.setAutoCompose("ON");
addLiveRecordVodConfigRequest.setComposeVodTranscodeGroupId("<TranscodeGroupId>");

記録ファイルの管理

ApsaraVideo Liveコンソールで、VODバケットに保存されている録画ファイルを表示できます。 詳細については、「録画の表示」をご参照ください。 録画ファイルを管理するには、ApsaraVideo VODを使用します。 詳細については、「メディア資産管理」をご参照ください。

前提条件

OSSが有効化され、OSSバケットが作成されます。 詳細については、「OSS の設定」をご参照ください。

ストレージ設定の構成

前提条件が満たされたら、必要な設定を設定して、OSSバケットに記録ファイルを保存できます。

ApsaraVideo Liveは、OSSバケットに記録ファイルを保存するための次の方法を提供します。

1. OSSコンソールでの設定: 詳細については、「OSSでの記録の保存」をご参照ください。

2. API操作の呼び出し: 詳細については、「AddLiveAppRecordConfig」をご参照ください。次のセクションでは、SDK for Javaを使用して、OSSバケットに保存するファイルを記録するための設定を行う方法について説明します。

        //Replace the content in the angle brackets <> with actual values.
        DefaultProfile profile = DefaultProfile.getProfile("<regionId>", "<ALIBABA_CLOUD_ACCESS_KEY_ID>", "<ALIBABA_CLOUD_ACCESS_KEY_SECRET>");
        IAcsClient client = new DefaultAcsClient(profile);   
        AddLiveAppRecordConfigRequest addLiveAppRecordConfigRequest=new AddLiveAppRecordConfigRequest();
        addLiveAppRecordConfigRequest.setAppName("<AppName>");
        addLiveAppRecordConfigRequest.setStreamName("<StreamName>");
        addLiveAppRecordConfigRequest.setDomainName("<DomainName>");
        addLiveAppRecordConfigRequest.setOssEndpoint("<OssEndpoint>");
        addLiveAppRecordConfigRequest.setOssBucket("<OssBucket>");
        List<AddLiveAppRecordConfigRequest.RecordFormat> formatList=new ArrayList<AddLiveAppRecordConfigRequest.RecordFormat>();
        AddLiveAppRecordConfigRequest.RecordFormat m3u8Format=new AddLiveAppRecordConfigRequest.RecordFormat();
        m3u8Format.setFormat("m3u8");
        //The name of the recording file that is stored in the OSS bucket.
        m3u8Format.setOssObjectPrefix("<record/{AppName}/{StreamName}/{EscapedStartTime}_{EscapedEndTime}>");
        //The name of the segment.
        m3u8Format.setSliceOssObjectPrefix("<record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}>");
        formatList.add(m3u8Format);
        addLiveAppRecordConfigRequest.setRecordFormats(formatList);
        AddLiveAppRecordConfigResponse addLiveAppRecordConfigResponse = null;
        try {
            addLiveAppRecordConfigResponse = client.getAcsResponse(addLiveAppRecordConfigRequest);
        } catch (ClientException e) {
            e.printStackTrace();
        }
        System.out.println(new Gson().toJson(addLiveAppRecordConfigResponse));

録音のコード変換

録画ファイルのサイズを小さくしたい場合は、トランスコードされたストリームを録画してビデオビットレートを調整し、ビデオ品質に影響を与えることなくビデオ圧縮率を向上させることができます。

トランスコードされたストリームを記録するためのサンプルコード:

        //Replace the content in the angle brackets <> with actual values.        
        List<AddLiveAppRecordConfigRequest.TranscodeRecordFormat> transcodeFormatList=new ArrayList<AddLiveAppRecordConfigRequest.TranscodeRecordFormat>();
        AddLiveAppRecordConfigRequest.TranscodeRecordFormat m3u8TranscodeFormat=new AddLiveAppRecordConfigRequest.TranscodeRecordFormat();
        m3u8TranscodeFormat.setFormat("m3u8");
        //The name of the recording file for the transcoded stream in an OSS bucket.
        m3u8TranscodeFormat.setOssObjectPrefix("<transcodeRecord/{AppName}/{StreamName}/{EscapedStartTime}_{EscapedEndTime}>");
        //The name of the segment of the transcoded stream.
        m3u8TranscodeFormat.setSliceOssObjectPrefix("<transcodeRecord/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}>");
        transcodeFormatList.add(m3u8TranscodeFormat);
        addLiveAppRecordConfigRequest.setTranscodeRecordFormats(transcodeFormatList);
        List<String> transcodeTemplateList=new ArrayList<String>();
        //The ID of the transcoding template.
        transcodeTemplateList.add("lld");
        addLiveAppRecordConfigRequest.setTranscodeTemplatess(transcodeTemplateList);

マージの中断期間の設定

ライブストリームが中断されたが、中断期間for merge内に再び取り込まれた場合、生成された録画ファイルは自動的に1つの録画ファイルにマージされます。 デフォルトでは、中断時間は180秒です。

ビジネス要件に基づいて、マージの中断期間を設定できます。 サンプルコード：

//Unit: seconds. Valid values: 15 to 21600.
addLiveAppRecordConfigRequest.setDelayTime(<180>);

マージの中断時間が経過した後に録画ファイルを生成したくない場合は、ライブストリームが終了した直後に録画ファイルを生成するようにシステムを設定できます。 ストリーム取り込みコールバックを設定できます。 ストリーム取り込みプロセスが完了したという通知を受け取ったら、RealTimeRecordCommand操作を呼び出して、マージの中断期間の設定を無効にすることができます。 詳細については、「RealTimeRecordCommand」をご参照ください。

ストリームのコールバックを設定する方法の詳細については、「ストリーム取り込みステータスのコールバック」をご参照ください。 マージの中断期間の設定を無効にするためのサンプルコード:

        //Replace the content in the angle brackets <> with actual values.
        RealTimeRecordCommandRequest realTimeRecordCommandRequest=new RealTimeRecordCommandRequest();
        realTimeRecordCommandRequest.setCommand("cancel_delay");
        realTimeRecordCommandRequest.setAppName("<AppName>");
        realTimeRecordCommandRequest.setStreamName("<StreamName>");
        realTimeRecordCommandRequest.setDomainName("<DomainName>");
        RealTimeRecordCommandResponse realTimeRecordCommandResponse = null;
        try {
            realTimeRecordCommandResponse = client.getAcsResponse(realTimeRecordCommandRequest);
        } catch (ClientException e) {
            e.printStackTrace();
        }
        System.out.println(new Gson().toJson(realTimeRecordCommandResponse));

記録ルールの設定

[ストレージ設定の設定] セクションで、ライブストリームの録画機能が設定されます。 ライブストリームが取り込まれると、記録プロセスが開始されます。 このプロセスは自動記録と呼ばれます。

場合によっては、ビジネス要件に基づいてライブストリームを録画するかどうかを決定することができます。 必要に応じて、次のいずれかの方法を使用してライブストリームを記録できます。

1. ApsaraVideo Liveは、ライブストリームを録画するかどうかを尋ねるリクエストを送信します。 ApsaraVideo Liveがライブストリームを録画するための応答を受信すると、録画プロセスが開始されます。 このプロセスは、オンデマンド記録と呼ばれます。

2. ビジネスシステムは、ライブストリームを録画するためにApsaraVideo Liveに通知を送信します。 このプロセスは手動記録と呼ばれます。

        addLiveAppRecordConfigRequest.setOnDemand(1);

        //Replace the content in the angle brackets <> with actual values.
        AddLiveRecordNotifyConfigRequest addLiveRecordNotifyConfigRequest=new AddLiveRecordNotifyConfigRequest();
        //Specify a callback URL for on-demand recording.
        addLiveRecordNotifyConfigRequest.setOnDemandUrl("<OnDemandUrl>");
        addLiveRecordNotifyConfigRequest.setNotifyUrl("<NotifyUrl>");
        addLiveRecordNotifyConfigRequest.setDomainName("<DomainName>");
        AddLiveRecordNotifyConfigResponse addLiveRecordNotifyConfigResponse = null;
        try {
            addLiveRecordNotifyConfigResponse = client.getAcsResponse(addLiveRecordNotifyConfigRequest);
        } catch (ClientException e) {
            e.printStackTrace();
        }
        System.out.println(new Gson().toJson(addLiveRecordNotifyConfigResponse));

        addLiveAppRecordConfigRequest.setOnDemand(7);

        //Replace the content in the angle brackets <> with actual values. 
        RealTimeRecordCommandRequest realTimeRecordCommandRequest=new RealTimeRecordCommandRequest();
        realTimeRecordCommandRequest.setCommand("start");
        realTimeRecordCommandRequest.setAppName("<AppName>");
        realTimeRecordCommandRequest.setStreamName("<StreamName>");
        realTimeRecordCommandRequest.setDomainName("<DomainName>");
        RealTimeRecordCommandResponse realTimeRecordCommandResponse = null;
        try {
            realTimeRecordCommandResponse = client.getAcsResponse(realTimeRecordCommandRequest);
        } catch (ClientException e) {
            e.printStackTrace();
        }
        System.out.println(new Gson().toJson(realTimeRecordCommandResponse));

        //Replace the content in the angle brackets <> with actual values. 
        RealTimeRecordCommandRequest realTimeRecordCommandRequest=new RealTimeRecordCommandRequest();
        realTimeRecordCommandRequest.setCommand("stop");
        realTimeRecordCommandRequest.setAppName("<AppName>");
        realTimeRecordCommandRequest.setStreamName("<StreamName>");
        realTimeRecordCommandRequest.setDomainName("<DomainName>");
        RealTimeRecordCommandResponse realTimeRecordCommandResponse = null;
        try {
            realTimeRecordCommandResponse = client.getAcsResponse(realTimeRecordCommandRequest);
        } catch (ClientException e) {
            e.printStackTrace();
        }
        System.out.println(new Gson().toJson(realTimeRecordCommandResponse));

関連する API

録音サイクルの設定

ライブストリーミングの期間が指定した録画サイクルを超えると、新しい録画ファイルが生成されます。 例えば、ライブストリーミングが20分間続き、記録周期が15分に設定されている場合、2つの記録ファイルが生成されます。 記録サイクルは15〜360分の範囲の値に設定できます。

記録サイクルを設定するためのサンプルコード:

        List<AddLiveAppRecordConfigRequest.RecordFormat> formatList=new ArrayList<AddLiveAppRecordConfigRequest.RecordFormat>();
        AddLiveAppRecordConfigRequest.RecordFormat m3u8Format=new AddLiveAppRecordConfigRequest.RecordFormat();
        m3u8Format.setFormat("m3u8");
        m3u8Format.setOssObjectPrefix("<record/{AppName}/{StreamName}/{EscapedStartTime}_{EscapedEndTime}>");
        m3u8Format.setSliceOssObjectPrefix("<record/{AppName}/{StreamName}/{UnixTimestamp}_{Sequence}>");
       //Configure the recording cycle. Unit: seconds.
        m3u8Format.setCycleDuration(<900>);
        AddLiveAppRecordConfigRequest.RecordFormat mp4Format=new AddLiveAppRecordConfigRequest.RecordFormat();
        mp4Format.setFormat("mp4");
        mp4Format.setOssObjectPrefix("<record/{AppName}/{StreamName}/{EscapedStartTime}_{EscapedEndTime}>");
        //Configure the recording cycle. Unit: seconds.
        mp4Format.setCycleDuration(<1500>);
        formatList.add(mp4Format);
        formatList.add(m3u8Format);
        addLiveAppRecordConfigRequest.setRecordFormats(formatList);

ライブストリーミング期間が録画サイクルを超えない場合、録画ファイルはライブストリーミング終了後に生成されます。 ライブストリーミングが終了する前に録画ファイルを表示する場合は、RealTimeRecordCommand操作を呼び出して録画コンテンツを更新し、録画を強制的に再開します。 ライブストリームの録画中に録画を再開すると、すぐに録画ファイルが生成されます。

記録を再開するためのサンプルコード:

        //Replace the content in the angle brackets <> with actual values. 
        RealTimeRecordCommandRequest realTimeRecordCommandRequest=new RealTimeRecordCommandRequest();
        realTimeRecordCommandRequest.setCommand("restart");
        realTimeRecordCommandRequest.setAppName("<AppName>");
        realTimeRecordCommandRequest.setStreamName("<StreamName>");
        realTimeRecordCommandRequest.setDomainName("<DomainName>");
        RealTimeRecordCommandResponse realTimeRecordCommandResponse = null;
        try {
            realTimeRecordCommandResponse = client.getAcsResponse(realTimeRecordCommandRequest);
        } catch (ClientException e) {
            e.printStackTrace();
        }
        System.out.println(new Gson().toJson(realTimeRecordCommandResponse));

録音ファイルのマージと抽出

ApsaraVideo Liveを使用すると、インデックスファイルを作成し、時間範囲ごとに録画ファイルを抽出できます。 時間範囲内に生成された複数の録音ファイルを1つの録音ファイルにマージすることもできます。

CreateLiveStreamRecordIndexFilesを呼び出して、インデックスファイルを作成できます。

        CreateLiveStreamRecordIndexFilesRequest createLiveStreamRecordIndexFilesRequest=new CreateLiveStreamRecordIndexFilesRequest();
        createLiveStreamRecordIndexFilesRequest.setAppName("<AppName>");
        createLiveStreamRecordIndexFilesRequest.setStreamName("<StreamName>");
        createLiveStreamRecordIndexFilesRequest.setDomainName("<DomainName>");
        createLiveStreamRecordIndexFilesRequest.setOssEndpoint("<OssEndpoint>");
        createLiveStreamRecordIndexFilesRequest.setOssBucket("<OssBucket>");
        createLiveStreamRecordIndexFilesRequest.setStartTime("<StartTime>");
        createLiveStreamRecordIndexFilesRequest.setEndTime("<EndTime>");
        createLiveStreamRecordIndexFilesRequest.setOssObject("<IndexFiles/OssObject.m3u8>");
        CreateLiveStreamRecordIndexFilesResponse createLiveStreamRecordIndexFilesResponse = null;
        try {
            createLiveStreamRecordIndexFilesResponse = client.getAcsResponse(createLiveStreamRecordIndexFilesRequest);
        } catch (ClientException e) {
            e.printStackTrace();
        }
        System.out.println(new Gson().toJson(createLiveStreamRecordIndexFilesResponse));

関連する API

記録ファイルの管理

ApsaraVideo Liveは、録画ファイルを管理するために次の方法を提供します。

1. ApsaraVideo Liveコンソールで設定を行います。 詳細については、「録音の管理」をご参照ください。

2. APIを呼び出します。 次のセクションでは、SDK for Javaを使用して録画ファイルを削除する方法について説明します。

次のセクションでは、SDK for Javaを使用して録画ファイルを削除する方法について説明します。