tencent cloud

Tencent Real-Time Communication

お知らせ・リリースノート
製品アップデート情報
Tencent Cloudオーディオビデオ端末SDKの再生アップグレードおよび承認チェック追加に関するお知らせ
TRTCアプリケーションのサブスクリプションパッケージサービスのリリースに関する説明について
製品の説明
製品概要
基礎概念
製品の機能
製品の強み
ユースケース
性能データ
購入ガイド
Billing Overview
無料時間の説明
Monthly subscription
Pay-as-you-go
TRTC Overdue and Suspension Policy
課金に関するよくあるご質問
Refund Instructions
初心者ガイド
Demo体験
Call
コンポーネントの説明(TUICallKit)
Activate the Service
Run Demo
クイック導入
オフライン通知
Conversational Chat
クラウドレコーディング(TUICallKit)
AI Noise Reduction
インターフェースのカスタマイズ
Calls integration to Chat
Additional Features
No UI Integration
Server APIs
Client APIs
Solution
ErrorCode
公開ログ
よくある質問
ライブ配信
Billing of Video Live Component
Overview
Activating the Service (TUILiveKit)
Demo のクイックスタート
No UI Integration
UI Customization
Live Broadcast Monitoring
Video Live Streaming
Voice Chat Room
Advanced Features
Client APIs
Server APIs
Error Codes
Release Notes
FAQs
RTC Engine
Activate Service
SDKのダウンロード
APIコードサンプル
Usage Guidelines
クライアント側 API
高度な機能
RTC RESTFUL API
History
Introduction
API Category
Room Management APIs
Stream mixing and relay APIs
On-cloud recording APIs
Data Monitoring APIs
Pull stream Relay Related interface
Web Record APIs
AI Service APIs
Cloud Slicing APIs
Cloud Moderation APIs
Making API Requests
Call Quality Monitoring APIs
Usage Statistics APIs
Data Types
Appendix
Error Codes
コンソールガイド
アプリケーション管理
使用統計
監視ダッシュボード
開発支援
Solution
Real-Time Chorus
よくあるご質問
課金関連問題
機能関連
UserSig関連
ファイアウォールの制限の対応関連
インストールパッケージの圧縮に関するご質問
AndriodおよびiOS関連
Web端末関連
Flutter関連
Electron関連
TRTCCalling Web関連
オーディオビデオ品質関連
その他のご質問
旧バージョンのドキュメント
TUIRoom(Web)の統合
TUIRoom (Android)の統合
TUIRoom (iOS)の統合
TUIRoom (Flutter)の統合
TUIRoom (Electron)の統合
TUIRoom APIのクエリー
クラウドレコーディングと再生の実現(旧)
Protocols and Policies
セキュリティコンプライアンス認証
セキュリティホワイトペーパー
情報セキュリティの説明
Service Level Agreement
Apple Privacy Policy: PrivacyInfo.xcprivacy
TRTC ポリシー
プライバシーポリシー
データ処理とセキュリティ契約
用語集

サーバーイベントコールバックの監視

PDF
フォーカスモード
フォントサイズ
最終更新日: 2025-12-02 16:21:21
イベントコールバックサービスは、HTTP/HTTPSリクエストという形でサーバーへのTRTC業務でのイベントの通知をサポートします。イベントコールバックサービスは、ルームイベントグループ(Room Event)とメディアイベントグループ(Media Event)およびレコーディングイベントグループのいくつかのイベントを統合しています(クラウドレコーディング機能のコールバックイベントの説明については、クラウドレコーディングと再生の実現をご参照ください)。お客様は、関連する設定情報をTencent Cloudに提供することで、このサービスをアクティブにすることができます。

設定情報

TRTCコンソールでは、自身でのコールバック情報の設定をサポートしており、設定が完了した後、イベントコールバック通知を受信できます。詳細な操作ガイドについては、コールバック設定をご参照ください。
注意:
事前に次の情報を準備する必要があります。
必須項目:コールバック通知を受信するためのHTTP/HTTPSサーバーアドレス。
オプション項目:署名を計算するためのkeyで、大文字・小文字アルファベットと数字で構成される最大32文字のkeyをカスタマイズできます。

タイムアウト・リトライ

イベントコールバックサーバーがメッセージ通知を送信してから5秒以内にお客様のサーバーから応答を受信しない場合、通知は失敗とみなされます。最初の通知が失敗すると、直ちにリトライが行われます。その後の失敗は、メッセージがリトライせずに1分以上続くまで、** 10秒**の間隔でリトライし続けます。

イベントコールバックメッセージ形式

イベントコールバックメッセージは、HTTP/HTTPS POSTリクエストとしてサーバーに送信されます。以下がその詳細となります。
文字エンコード形式:UTF-8。
リクエスト:bodyの形式はJSONです。
応答:HTTP STATUS CODE = 200、サーバーは応答パケットの具体的な内容を無視します。プロトコルとの親和性のため、クライアントの応答内容に、JSON:{"code":0}を付けることをお勧めします。
パケット例:以下の内容は「ルームイベントグループ-入室」イベントのパケット例です。
{
「EventGroupId」: 1、 #ルームイベントグループ
「EventType」:103、 #入室イベント
「CallbackTs」: 1615554923704、 #コールバック時間。単位はミリ秒
"EventInfo": {
「RoomId」: 12345、 #数字のルーム番号
「EventTs」: 1615554922、 #イベント発生時間。単位は秒
「UserId」: 「test」、 #ユーザーID
「UniqueId」: 1615554922656、 #固有識別子
「Role」: 20、 #ユーザーロール。キャスター
「TerminalType」: 3、 #端末のタイプ。IOS端末
「UserType」: 3、 #ユーザーのタイプ。Native SDK
「Reason」: 1 #入室の原因。正常な入室
}
}


パラメータの説明

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

イベントコールバックメッセージのheaderには、次のフィールドが含まれています。
フィールド名
Content-Type
application/json
Sign
署名値
SdkAppId
sdk application id
イベントコールバックメッセージのbodyには、次のフィールドが含まれています。
フィールド名
タイプ
意味
EventGroupId
Number
EventType
Number
CallbackTs
Number
イベントコールバックサーバーからお客様のサーバーに送信されるコールバックリクエストのUnixタイムスタンプ。単位はミリ秒
EventInfo
JSON Object

イベントグループID

フィールド名
意味
EVENT_GROUP_ROOM
1
ルームイベントグループ
EVENT_GROUP_MEDIA
2
メディアイベントグループ
説明:
レコーディングイベントグループに関する説明については、クラウドレコーディングと再生の実現をご参照ください。

イベントタイプ

フィールド名
意味
EVENT_TYPE_CREATE_ROOM
101
ルームの作成
EVENT_TYPE_DISMISS_ROOM
102
ルームの解散
EVENT_TYPE_ENTER_ROOM
103
ルームに参加
EVENT_TYPE_EXIT_ROOM
104
ルームを退出
EVENT_TYPE_CHANGE_ROLE
105
ロールの切り替え
EVENT_TYPE_START_VIDEO
201
ビデオデータのプッシュを開始
EVENT_TYPE_STOP_VIDEO
202
ビデオデータのプッシュを停止
EVENT_TYPE_START_AUDIO
203
オーディオデータのプッシュを開始
EVENT_TYPE_STOP_AUDIO
204
オーディオデータのプッシュを停止
EVENT_TYPE_START_ASSIT
205
サブストリームデータのプッシュを開始
EVENT_TYPE_STOP_ASSIT
206
サブストリームデータのプッシュを停止
ご注意:
退室時は104イベントのみコールバックし、202と204イベントはコールバックしません。104イベントには202および204イベントが含まれることになります。ビデオ/オーディオを手動でオフにした場合のみ、202/204イベントがコールバックされます。

イベント情報

フィールド名
タイプ
意味
RoomId
String/Number
ルーム名(タイプはクライアントのルーム番号タイプと同様)
EventTs
Number
イベントで発生するUnixタイムスタンプ。単位は秒(互換性保留)
EventMsTs
Number
イベントで発生するUnixタイムスタンプ。単位はミリ秒
UserId
String
ユーザーID
UniqueId
Number
固有識別子(option:ルームイベントグループに付帯)
クライアントでネットワークの切り替え、異常退出および再入室プロセスなどの特殊な行為が発生すると、お客様のコールバックサーバーが同じユーザーの複数回の入室および退室コールバックを受信する可能性があり、UniqueIdを使用してユーザーの同一回の入退室を識別することができます
Role
Number
ロールタイプ(option:入退室時に付帯)
TerminalType
Number
端末のタイプ(option:入室時に付帯)
UserType
Number
ユーザーのタイプ(option:入室時に付帯)
Reason
Number
具体的な原因 (option:入退室時に付帯)
ご注意:
「クライアントの特殊な行為による重複コールバックのフィルタリング」ポリシーをリリース済みです。2021年7月30日より後にコールバックサービスにアクセスした場合、デフォルトで新しいポリシーが適用され、ルームイベントグループには UniqueId(固有識別子)が付加されません。

ロールタイプ

フィールド名
意味
MEMBER_TRTC_ANCHOR
20
キャスター
MEMBER_TRTC_VIEWER
21
視聴者

端末のタイプ

フィールド名
意味
TERMINAL_TYPE_WINDOWS
1
Windows端末
TERMINAL_TYPE_ANDROID
2
Android端末
TERMINAL_TYPE_IOS
3
iOS端末
TERMINAL_TYPE_LINUX
4
Linux端末
TERMINAL_TYPE_OTHER
100
その他

ユーザーのタイプ

フィールド名
意味
USER_TYPE_WEBRTC
1
webrtc
USER_TYPE_APPLET
2
ミニプログラム
USER_TYPE_NATIVE_SDK
3
Native SDK

具体的な原因

フィールド名
意味
入室
1:正常な入室
2:Networkingの切り替え
3:タイムアウト・リトライ
4:ルーム間マイク接続による入室
退室
1:正常な退室
2:タイムアウトによる退室
3:ルームのユーザーが削除される
4:マイク接続のキャンセルによる退室
5:強制終了
注意:Androidシステムではプロセスの強制終了を捕捉できず、バックエンドのタイムアウトによる退室を待つしかありません。この場合のコールバックreasonは2となります

署名計算

署名はHMAC SHA256暗号化アルゴリズムによって算出されます。イベントコールバック受信サーバーがコールバックメッセージを受信した後、同じ方法で署名が算出されます。同様に、Tencent CloudのTRTCのイベントコールバックであり、偽造されていないことを意味します。署名の計算は次のとおりです。
//署名Signの計算式のkeyは、署名Signの計算に用いられる暗号化鍵です。
Sign = base64(hmacsha256(key, body))
ご注意:
bodyはお客様が受信したコールバックリクエストのオリジナルパケットです。いかなる変更も行わないでください。例:
body="{\\n\\t\\"EventGroupId\\":\\t1,\\n\\t\\"EventType\\":\\t103,\\n\\t\\"CallbackTs\\":\\t1615554923704,\\n\\t\\"EventInfo\\":\\t{\\n\\t\\t\\"RoomId\\":\\t12345,\\n\\t\\t\\"EventTs\\":\\t1608441737,\\n\\t\\t\\"UserId\\":\\t\\"test\\",\\n\\t\\t\\"UniqueId\\":\\t1615554922656,\\n\\t\\t\\"Role\\":\\t20,\\n\\t\\t\\"Reason\\":\\t1\\n\\t}\\n}"

ヘルプとサポート

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

フィードバック