tencent cloud

フィードバック

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

最終更新日:2024-01-18 15:47:47

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

    説明

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

    ネットワークプロトコル

    コンソールでコールバックアドレス、すなわち、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"
    }
    }
    
    お問い合わせ

    カスタマーサービスをご提供できるため、ぜひお気軽にお問い合わせくださいませ。

    テクニカルサポート

    さらにサポートが必要な場合は、サポートチケットを送信して弊社サポートチームにお問い合わせください。24時間365日のサポートをご提供します。

    電話サポート(24 時間365日対応)