tencent cloud

フィードバック

プッシュ切断イベント通知

最終更新日:2022-05-27 11:54:41

    プッシュ切断コールバックは、CSSプッシュの成功やCSSプッシュの中断といったCSSストリームのステータス情報をプッシュするために使用します。コールバックテンプレートの中でプッシュコールバックやストリーム切断コールバックメッセージの受信サーバーアドレスを設定し、このテンプレートとプッシュドメイン名をバインドしてください。対応するプッシュアドレスを発行し、CSSプッシュを開始するとTencent Cloud CSSのバックエンドがプッシュ結果をお客様が設定した受信サーバーにコールバックします。

    このドキュメントでは、主にプッシュ切断コールバックイベントがトリガーされた後、Tencent Cloud CSSがユーザーに送信するコールバックメッセージ通知のフィールドについてご説明します。

    注意事項

    このドキュメントを読む前に、Tencent Cloud CSSによるコールバック機能の設定方法とコールバックメッセージの受信方法についてご理解下さると幸いです。詳細については、イベント通知の受信方法をご参照ください。

    プッシュ切断イベントのパラメータ説明

    イベントタイプパラメータ

    イベントタイプ フィールド設定値の説明
    CSSプッシュ event_type = 1
    CSSストリーム切断 event_type = 0

    コールバック共通パラメータ

    フィールド名タイプ説明
    t int64 期限切れ時間、イベント通知サイン期限のUNIXタイムスタンプ。
    • Tencent Cloudからのメッセージ通知のデフォルトの期限切れ時間は10分です。メッセージ通知中のt値の示す時間が期限に達した場合、この通知を無効と判断し、ネットワークのリプレイアタックを防止できます。
    • tの形式は10進数UNIXタイムスタンプとなり、即ち1970年1月1日(UTC/GMTの真夜中)から経過した秒数となります。
    sign string イベント通知セキュリティサインsign = MD5(key + t)。
    説明:Tencent Cloudが、暗号化keyとtで文字列を結合した後、MD5でsignの値を算出し、それを通知メッセージに入れます。お客様のバックエンドサーバーは、通知メッセージの受信後、同じアルゴリズムに基づきsignが正しいか確認し、さらにメッセージが確実にTencent Cloudバックエンドから来たものかを確認することができます。
    説明:

    keyは、**イベントセンター>CSSコールバック**の中のコールバックキーとなり、主に認証に使用します。お客様のデータ情報のセキュリティを保護するために、入力することをお勧めします。

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

    フィールド名 タイプ 説明
    appid int ユーザー APPID
    app string プッシュドメイン名
    appname string プッシュパス
    stream_id string CSSストリーム名
    channel_id string CSSストリーム名と同じ
    event_time int64 イベントメッセージ生成のUNIXタイムスタンプ
    sequence string メッセージシリアルナンバー。1回のプッシュのアクションを表します。1回のプッシュのアクションで同じシリアルナンバーのプッシュとストリーム切断メッセージが生成されます
    node string CSSアクセスポイントのIP
    user_ip string ユーザーのプッシュIP
    stream_param string ユーザープッシュURLに付帯するパラメータ
    push_duration string ストリーム切断イベント通知プッシュの時間(長さ)。単位:ミリ秒
    errcode int プッシュ切断エラーコード
    errmsg string プッシュ切断エラーの説明
    set_id int 国内外のプッシュかどうかを判断します。1-6は国内、7-200は海外です
    width int ビデオ幅。最初のプッシュコールバック時にビデオヘッダー情報が欠落している場合は、0になっている可能性があります
    height int ビデオ高さ。最初のプッシュコールバック時にビデオヘッダー情報が欠落している場合は、0になっている可能性があります

    ストリーム切断の原因

    ストリーム切断原因の詳細については、ストリーム切断記録をご参照ください。

    コールバックメッセージの例

    {
    "app":"test.domain.com",
    
    "appid":12345678,
    
    "appname":"live",
    
    "channel_id":"test_stream",
    
    "errcode":0,
    
    "errmsg":"ok",
    
    "event_time":1545115790,
    
    "event_type":1,
    
    "set_id":2,
    
    "node":"100.121.160.92",
    
    "sequence":"6674468118806626493",
    
    "stream_id":"test_stream",
    
    "stream_param":"stream_param=test",
    
    "user_ip":"119.29.94.245",
    
    "width": 0,
    
    "height": 0,
    
    "sign":"ca3e25e5dc17a6f9909a9ae7281e300d",
    
    "t":1545030873
    }
    
    お問い合わせ

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

    テクニカルサポート

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

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