tencent cloud

Cloud Streaming Services

スタートガイド
製品紹介
製品概要
サブ製品の説明
基本概念
製品機能
ユースケース
製品の優位性
使用制限
購入ガイド
価格一覧
基本サービス
付加価値サービス
前払いリソースパッケージ
購入の流れ
課金の変更
返金説明
請求書の照会
支払い更新の説明
支払い遅延によるサービス停止の説明
課金についてのよくある質問
標準ライブストリーミング
概要
ユースケース
クイックスタート
SDKへのアクセスの説明
ライブイベントストリーミング（超低遅延ライブストリーミング）
概要
ライブイベントストリーミングと標準ライブストリーミングの違い
ユースケース
クイックスタート
SDKへのアクセスの説明
コンソールガイド
コンソールの説明
概要
Domain Management
ストリーム管理
リソースパッケージ管理
機能設定
プルリレー
従量課金
CAMアクセス制御
機能の実践
Push and Playback
ライブストリーミング機能
Live Streaming Security
海外のCSSサービス
コールバックによるイベントメッセージ通知
一般的なサードパーティ製ツールガイド
SDKの実践
0. SDK導入ガイド
2. 再生
3. 高度な機能
APIドキュメン
History
Introduction
API Category
Making API Requests
Live Pad APIs
Live Stream Mix APIs
Time Shifting APIs
Monitoring Data Query APIs
Billing Data Query APIs
Live Transcoding APIs
Delayed Playback Management APIs
Domain Name Management APIs
Watermark Management APIs
Certificate Management APIs
Stream Pulling APIs
Recording Management APIs
Live Callback APIs
Screencapturing and Porn Detection APIs
Authentication Management APIs
Live Stream Management APIs
Data Types
Error Codes
メンテナンスガイド
ビデオラグの最適化（V2）
プッシュエラーの原因調査
再生エラーの原因調査
ディレイの軽減方法
プルのビデオ画質が鮮明でない時の原因調査
COS Bucketにスクリーンキャプチャ保存するためのライブストリーミング承認
障害処理
ライブミクスストリーミングのエラー報告：InvalidParameter.OtherError
FAQs
基本的なライブブロードキャスト機能
プッシュ再生関連
ライブストリーミングの課金に関する事項
グローバルCSSサービス
CSSレコーディング関連
クラウドストリームミックス
ドメイン名設定
アップル社ATSとの互換性
SLA
CSS Service Level Agreement
CSS ポリシー
プライバシーポリシー
データ処理とセキュリティ契約
ドキュメントCloud Streaming Services機能の実践コールバックによるイベントメッセージ通知スクリーンキャプチャイベント通知

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

PDF
フォーカスモード
フォントサイズ
最終更新日: 2025-11-14 15:41:21
ライブブロードキャストのスクリーンキャプチャは、一定の時間間隔でリアルタイムのライブブロードキャストストリーミングの画像をキャプチャし、画像を生成して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
}


前の記事へ: レコーディングイベント通知次の記事へ: ポルノ検出イベント通知

ヘルプとサポート

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

フィードバック