スタートガイド

製品紹介

製品概要

サブ製品の説明

基本概念

製品機能

ユースケース

製品の優位性

使用制限

購入ガイド

価格一覧

基本サービス

付加価値サービス

前払いリソースパッケージ

購入の流れ

課金の変更

返金説明

請求書の照会

支払い更新の説明

支払い遅延によるサービス停止の説明

課金についてのよくある質問

標準ライブストリーミング

概要

ユースケース

クイックスタート

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 ポリシー

プライバシーポリシー

データ処理とセキュリティ契約

レコーディングイベント通知

PDF

フォーカスモード

フォントサイズ

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

CSSレコーディングでは、プッシュドメイン名にバインドしたレコーディングテンプレートに基づきライブストリーミング画面をリアルタイムでレコーディングし、生成した対応するレコーディングファイルをVODの中に保存します。またレコーディングのコールバックを、レコーディングファイル情報をプッシュ送信するために利用し、これには主にレコーディングの開始時間、終了時間、生成したレコーディングファイルのID、レコーディングファイルサイズ、ファイルダウンロードアドレスが含まれます。お客様はコールバックテンプレートの中でレコーディングのコールバックメッセージを受信するサーバーアドレスを設定し、このテンプレートとプッシュドメイン名をバインドする必要があります。これにより、ライブストリーミングがレコーディングイベントをトリガーすると、Tencent Cloud CSSのバックエンドがレコーディングファイル情報をお客様の設定した受信サーバーにコールバックします。
ここでは、主にレコーディングコールバックイベントがトリガーされた後、Tencent Cloudバックエンドがユーザーに送信するコールバックメッセージ通知のフィールドについてご説明します。
注意事項
このドキュメントを読む前に、Tencent Cloud CSSによるコールバック機能の設定方法とコールバックメッセージの受信方法についてご理解いただければ幸いです。詳細については、イベント通知の受信方法をご参照ください。
レコーディングしたビデオファイルはデフォルトで VOD コンソールに保存されますので、オンデマンド業務が支払い延滞によりサービス停止にならないよう注意してください。
APIを介して レコーディングタスク作成 を実行する時は、レコーディングのコールバックはユーザーのプッシュURLに含まれる stream_param パラメータをリターンしません。その他のレコーディング方式ではリターンされます。
HLS連続レコーディング機能を設定すると、中間でプッシュが中断されてもコールバックしません。デフォルトではストリーミングを継続し、最終的なファイル生成のみコールバックします。
レコーディングイベントパラメータの説明
イベントタイプパラメータ
イベントタイプ
フィールド設定値の説明
CSSレコーディング
event_type = 100
コールバック共通パラメータ
フィールド名
タイプ
説明
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ストリーム名と同じ
file_id
string
VOD file ID、 VODプラットフォームで1つのVODビデオファイルを一意的に特定することができます
record_file_id
string
VODファイルID
file_format
string
FLV，HLS，MP4，AAC
task_id
string
レコーディングタスクID。APIで作成したレコーディングタスクに対してのみ有効であり、すなわちCreateRecordTaskによって返されるタスクID
start_time
int64
レコーディングタスクによるファイル書き込み開始時間。この値をレコーディングコンテンツの開始時間にすることはできません。レコーディングコンテンツの開始時間 = end_time – duration
end_time
int64
レコーディングタスクによるファイル書き込み終了時刻
start_time_usec
int
レコーディングタスクでファイルへの書き込みを開始する時間（マイクロ秒部分）
end_time_usec
int
レコーディングタスクでファイルへの書き込みを終了する時間（マイクロ秒部分）
duration
int64
レコーディングファイルの長さ。単位：秒
file_size
uint64
レコーディングファイルサイズ。単位：byte
stream_param
string
ユーザープッシュURLに付帯するパラメータ（カスタマイズ）
video_url
string
レコーディングファイルのダウンロードURL
media_start_time
int
レコーディングでプルを開始するときに受信した最初のフレームpts（必ずしもファイルの最初のフレームptsではありません）
record_bps
int
レコーディングでトランスコードのプルから対応するビットレート（Kbps）
callback_ext
string、jsonオブジェクト文字列
jsonオブジェクトに複数のフィールドが含まれます。うちvideo_codecはプッシュビデオcodec名ですresolutionはプッシュビデオの解像度です以上はいずれもレコーディング コールバック拡張フィールドであり、ビジネスの参考となります。ビジネスロジックがこれらのフィールドに強く依存することはお勧めしません。
コールバックメッセージの例
{
    "event_type": 100,
﻿
    "appid":12345678,
﻿
    "app": "yourapp",
﻿
    "callback_ext": "{\\"video_codec\\":\\"h264\\",\\"resolution\\":\\"640x480\\"}",
﻿
    "appname": "yourappname",
﻿
    "stream_id":"stream_test",
﻿
    "channel_id":"stream_test",
﻿
    "file_id":"1234567890",
﻿
    "record_file_id": "1234567890",
﻿
    "file_format":"hls",
﻿
    "task_id":"UpTbk5RSVhRQ********************0xTSlNTQltlRVRLU1JAWW9EUb",
﻿
    "start_time":1642089445,
﻿
    "end_time":1642089598,
﻿
    "start_time_usec": 316441,
﻿
    "end_time_usec": 618577,
﻿
    "duration":154,
﻿
    "file_size":277941079,
﻿
    "stream_param":"stream_param=test",
﻿
    "video_url":"http://12345678.vod2.myqcloud.com/xxxx/yyyy/zzzz.m3u8",
﻿
    "media_start_time": 135802,
﻿
    "record_bps": 0,
﻿
    "sign":"ca3e25e**********09a9ae7281e300d",
﻿
    "t":1545030873
}
﻿
﻿

ヘルプとサポート

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

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

フィードバック

tencent cloud

Cloud Streaming Services

レコーディングイベント通知

注意事項

レコーディングイベントパラメータの説明

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

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

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

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

ヘルプとサポート

イベントタイプ	フィールド設定値の説明
CSSレコーディング	event_type = 100

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