ApsaraVideo Live:クラウド録画のコールバック通知

値

説明

TaskCreated

タスクが作成されました。

TaskStarting

タスクが開始中です。

TaskRunning

タスクが実行中です。

TaskRecovering

タスクが例外から回復中です。

TaskStopping

タスクが停止中です。

TaskStopped

タスクが停止しました。

TaskStartFailed

タスクの開始に失敗しました。

TaskUpdated

タスクは正常に更新されました。

TaskUpdateFailed

タスクの更新に失敗しました。

RecordStart

録画が開始されました。

RecordFailed

例外からの回復に失敗し、タイムアウトしました。

RecordFileUploaded

録画ファイルがアップロードされました。

パラメーター

タイプ

説明

eventTs

integer

イベントが発生した時間。これはミリ秒単位の UNIX タイムスタンプです。

例: 1744774345595。

taskStatus

string

タスクステータス。詳細については、「タスクステータス」の表をご参照ください。

errorCode

string

エラーコード。詳細については、「エラー」の表をご参照ください。

errorMessage

string

エラーメッセージ。詳細については、「エラー」の表をご参照ください。

recordFileList

FileList

録画ファイルのリスト。パラメーターの詳細については、「FileList」の表をご参照ください。

recordFile

RecordFile

録画ファイル情報。このパラメーターは、eventType が RecordFileUploaded の場合にのみ返されます。パラメーターの詳細については、「RecordFile」の表をご参照ください。

format

string

録画ファイルのフォーマット。このパラメーターは、eventType が RecordFileUploaded の場合にのみ返されます。このコールバックのファイル形式を示します。有効な値：

• SLICE (サポートされていません)

• HLS

• MP4

• MP3

streamInfo

string

このパラメーターは、eventType が RecordStart の場合にのみ返されます。サブスクライブしたどのストリームの録画が開始されたかを示します。

• 混合ストリーム録画の場合、値は常に Mix です。

• シングルストリーム録画の場合、値は Single::{UserId}::{Suffix} です。UserId はストリームに対応するユーザーの ID です。Suffix は、サブスクリプション時に指定された StreamType と SourceType に依存します：

  • StreamType が 0 の場合：SourceType が 0 の場合は Suffix は AV::C、SourceType が 1 の場合は AV::S です。

  • StreamType が 1 の場合：Suffix は常に A です。

  • StreamType が 2 の場合 (シングルストリーム録画ではサポートされていません)：SourceType が 0 の場合は Suffix は V::C、SourceType が 1 の場合は V::S です。

パラメーター

タイプ

説明

mp3FileList

array<string>

MP3 録画ファイル名の配列。

mp4FileList

array<string>

MP4 録画ファイル名の配列。

hlsFileList

array<string>

HLS 録画ファイル名の配列。

vodMediaList

array<VodFileInfo>

VOD メディアリソースの配列。このパラメーターは、VOD に録画する場合にのみ空になりません。VOD に録画する場合、これはサブスクライブされた各ストリームの録画ファイルのコレクションです。各項目はサブスクライブされたストリームに対応します。VodFileInfo パラメーターの詳細については、「VodFileInfo」の表をご参照ください。

パラメーター

タイプ

説明

stream

string

サブスクライブされたストリーム。

• 混合ストリーム録画の場合、値は常に Mix です。

• シングルストリーム録画の場合、値は Single::{UserId}::{Suffix} です。

  • UserId はストリームに対応するユーザーの ID です。

  • Suffix は、サブスクリプション時に指定された StreamType と SourceType に依存します。

    • StreamType が 0 の場合：SourceType が 0 の場合は Suffix は AV::C、SourceType が 1 の場合は AV::S です。

    • StreamType が 1 の場合：Suffix は常に A です。

    • StreamType が 2 の場合 (シングルストリーム録画ではサポートされていません)：SourceType が 0 の場合は Suffix は V::C、SourceType が 1 の場合は V::S です。

mediaIds

array<string>

録画中に生成されたメディアリソース ID の配列。

mergedIds

array<string>

録画終了後に自動的にマージされるメディアリソース ID の配列。このパラメーターは、VOD に録画し、自動マージを有効にし、複数のメディアリソースを録画した場合にのみ空になりません。

パラメーター

タイプ

説明

sliceFile

string

このフォーマットが NotifyFileUploadedFormat パラメーターで指定されている場合にのみ返されます。

hlsFile

string

このフォーマットが NotifyFileUploadedFormat パラメーターで指定されている場合にのみ返されます。

mp4File

string

このフォーマットが NotifyFileUploadedFormat パラメーターで指定されている場合にのみ返されます。

mp3File

string

このフォーマットが NotifyFileUploadedFormat パラメーターで指定されている場合にのみ返されます。

ステータス

説明

CREATED

タスクが作成されたときに返されます。

STARTING

タスクが開始中のときに返されます。

RUNNING

タスクが実行中のときに返されます。

RECOVERING

タスクが例外から回復中のときに返されます。

STOPPING

タスクが停止中のときに返されます。

STOPPED

タスクが停止した後に返されます。

FAILED

タスクの開始に失敗した後に返されます。

イベントタイプ (eventType)

エラーコード (errorCode)

エラーメッセージ (errorMessage)

説明

タスクの開始に失敗しました (TaskStartFailed)

StartTaskError

Channel already closed

チャネルは閉じられています。

Start task error

その他の理由。

異常状態からの回復 (TaskRecovering)

RunTaskError

The rms task failed

混合ストリームモジュールが異常に実行されています。

The record task failed

録画モジュールが異常に実行されています。

タスクの更新に失敗しました。(TaskUpdateFailed)

UpdateTaskError

Update task error

タスクの更新に失敗しました。

RecordFailed

RunTaskError

Recovering status timeout

例外からの回復がタイムアウトしました。