tencent cloud

Game Multimedia Engine

ドキュメントGame Multimedia Engine拡張機能開発ガイドサーバー側のレコーディングレコーディングコールバックの説明

レコーディングコールバックの説明

PDF
フォーカスモード
フォントサイズ
最終更新日: 2025-08-26 15:58:58

サーバー側レコーディングコールバックの説明

説明

ネットワークの影響を受け、サーバーで通知を受信した順番は、イベントの発生順番と異なる可能性があります。こちらから提供するサービスにはリトライメカニズムはありますが、すべてのメッセージが届く保証はできません。そのため、お客様の重要な業務ロジックがメッセージ通知サービスに依存しないようにすることをお勧めします。

ネットワークプロトコル

コンソールでコールバックアドレス、すなわち、HTTP(S)プロトコルインターフェースのURLを設定した場合、POSTメソッドをサポートし、データ転送にUTF-8エンコードを使用する必要があります。

HTTPヘッダーのパラメータ

名前
タイプ
必須か
説明
Signature
string
はい
署名。詳細については、以下の署名生成の説明をご参照ください

署名生成

Signature = HMAC-SH1 ( strContent, SecretKey )
strContent：署名そのものの文字列であり、bodyのJSON内容（長さはContent-Lengthと同様）です。
body：業務にコールバックするJSON内容。以下のコールバックの例 におけるすべての内容はbodyです。
SecretKey：キー。アプリケーションの権限キーで、コンソール > アプリケーションの詳細で参照できます。
HMAC-SH1：署名アルゴリズム。

コールバックのパラメータ

名前
タイプ
説明
BizID
Integer
アプリケーションのAppID。コンソール > アプリケーションの詳細で参照できます。
RoomID
String
ルームID
UserID
String
ユーザーID
RecordMode
Integer
レコーディングモード
0: シングルストリーミング
1: ミックスストリーミング
Timestamp
Integer
コールバックを送信した時のタイムスタンプ（s）
TaskID
Integer
クラウドレコーディングサービスに割り当てたタスクID。タスクIDは1回のレコーディングライフサイクルの一意の識別子であり、レコーディング終了後に意味がなくなります。カスタムレコーディングモードを使用した場合、タスクIDは、レコーディング開始時にレスポンスパラメータにより取得でき、次回このレコーディングタスクを操作する時のリクエストパラメータとして、業務を保存する必要があります。
EventType
Integer
イベントタイプ
Detail
イベント詳細。EventTypeでフォーマットが決まります

EventDetailイベントの詳細な説明

EventType
説明
Detail
1
オーディオファイルレコーディング開始
SeqNo: Number。マルチパートの番号
FileName: String。ファイル名
2
オーディオファイルレコーディング完了
SeqNo: Number。マルチパートの番号
FileName: String。ファイル名
3
オーディオファイルアップロード完了
SeqNo: Number。マルチパートの番号
FileName: String。ファイル名

コールバックの例

{
    "BizID":1400000000,
    "RoomID":"100",
    "UserID":"999",
    "TaskID":446946705284000000,
    "RecordMode":1,
    "Timestamp":1675930605,
    "EventType":1,
    "Detail":{
        "SeqNo":0,
        "FileName":"1400000000_100_999/2023-02-09-16-16-45_446946705284000000_audio.mp3"
    }
}

前の記事へ: カスタムレコーディング次の記事へ: レンジボイス

ヘルプとサポート

この記事はお役に立ちましたか？

フィードバック