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

フォーカスモード

フォントサイズ

最終更新日: 2025-11-14 15:41:20

プッシュ切断コールバックは、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
}
﻿

ヘルプとサポート

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

営業担当者にお問い合わせいただくかチケットを提出してサポートを求めることができます。

フィードバック

tencent cloud

Cloud Streaming Services

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

注意事項

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

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

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

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

ストリーム切断の原因

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

ヘルプとサポート

イベントタイプ	フィールド設定値の説明
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バックエンドから来たものかを確認することができます。