tencent cloud

フィードバック

スクリーンキャプチャイベント通知

最終更新日:2022-05-05 15:20:46

    ライブブロードキャストのスクリーンキャプチャは、一定の時間間隔でリアルタイムのライブブロードキャストストリーミングの画像をキャプチャし、画像を生成してCOSに保存することです。スクリーンキャプチャのコールバックは、スクリーンキャプチャをプッシュして、主に、画像生成時間、画像サイズ、パス、ダウンロード可能なアドレスなどを含む画像ファイル情報を保存することに使用します。コールバックテンプレートでスクリーンキャプチャコールバックメッセージの受信サーバーアドレスを設定し、そのテンプレートとプッシュドメイン名をバインドする必要があります。ライブブロードキャストストリーミングがスクリーンキャプチャイベントをトリガーすると、Tencent Cloud Live Video Broadcasting (LVB)がバックエンドで、お客様が設定した受信サーバーにスクリーンキャプチャ情報をコールバックします。

    このドキュメントでは、主にスクリーンキャプチャコールバックイベントをトリガーすると、LVBがユーザーに送信するコールバックメッセージ通知のフィールドについて説明します。

    注意事項

    • このドキュメントを読む前に、LVBによるコールバック機能の構成方法とコールバックメッセージの受信方法について理解してください。詳細については、イベント通知の受信方法をご参照ください。
    • スクリーンキャプチャコールバックイベントがトリガーされた後に取得したスクリーンキャプチャ情報は、ポルノ検出のライブブロードキャスト、ルームサムネイルのライブブロードキャストなどのさまざまなシナリオに適用できます。

    スクリーンキャプチャイベントのパラメータ説明

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

    イベントタイプ フィールド設定値の説明
    スクリーンキャプチャのライブブロードキャスト event_type = 200

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

    フィールド名タイプ説明
    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コールバックの中のコールバックキーとなり、主に認証に使用します。お客様のデータ情報のセキュリティを保護するために、入力することをお勧めします。

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

    フィールド名 タイプ 説明
    app string プッシュドメイン名
    appname string プッシュパス
    stream_param string ユーザープッシュURLに付加するパラメータ
    stream_id string ライブブロードキャストストリーミング名
    channel_id string ライブブロードキャストストリーミング名と同じ
    create_time int64 スクリーンキャプチャがUNIXタイムスタンプを生成する
    file_size int スクリーンキャプチャのファイルサイズ。単位:byte
    width int スクリーンキャプチャの幅。単位:ピクセル
    height int スクリーンキャプチャの高さ。単位:ピクセル
    pic_url string スクリーンキャプチャのファイルパス /path/name.jpg
    pic_full_url string スクリーンキャプチャのダウンロードURL

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

    {
    "app":"test.app",

    "appname":"live",

    "channel_id":"your_channelid",

    "create_time":1622599925,

    "event_type":200,

    "file_size":30670,

    "height":720,

    "pic_full_url":"http://your.cos.region.myqcloud.com/channelid/channelid-screenshot-10-12-05-1280x720.jpg",

    "pic_url":"/channelid/channelid-screenshot-10-12-05-1280x720.jpg",

    "sign":"ca3e25e5dc17a6f9909a9ae7281e300d",

    "stream_id":"your_streamid",

    "stream_param":"txSecret=ca3e25e5dc17a6f9909a9ae7281e300d&txTime=60B83800",

    "t":1622600525,

    「width":1280
    }
    お問い合わせ

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

    テクニカルサポート

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

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