お知らせ・リリースノート

製品アップデート情報

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

プライバシーポリシー

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

用語集

Call Event Callback

PDF

フォーカスモード

フォントサイズ

最終更新日: 2024-04-18 16:26:28

To facilitate refined control of your call services, the TRTC Call (TUICallKit) offers call status callbacks. Your business backend can use these callbacks to peek at users' call results in real-time, such as missed calls, rejections, etc., and based on this, perform real-time data analytics and other operations. For calling configuration methods, see Callback Configuration API List.
Use Conditions
Only applications (SDKAppId) that have activated the Group Call Version of TRTC Call can use the call status callback. You can also activate the trial version for a free trial. For version descriptions and activation instructions, see Activate the Service.
Currently, call status callbacks are available only in specific versions of TUICallKit across various platforms, as detailed in the table below:
Platform/Framework
Version number
Android/iOS/Flutter/uni-app (client)
≥ 1.7.1 
Web
≥  1.4.6
WeChat Mini Program
≥  1.5.1
Note:
Only after all participating platforms/frameworks are upgraded to the versions mentioned above, can the corresponding call information be peeked at in the console.
Notes
﻿To enable the callback, you must configure the callback URL and enable the switch for this command. Please refer to Create Callback Configuration.
The direction of the callback is from the Callkit backend to the app backend via an HTTP POST request.
After receiving the callback request, the app backend must check whether the SDKAppID contained in the request URL is consistent with its own SDKAppID.
Scenarios that may trigger this callback
Actions generated by an app user during a call via the client, such as answering and hanging up.
Timing of the callback
After operations by the user such as answering and hanging up.
Possible callback results
Please refer to Callback Command - Call Event Callback.
API description
Request URL
In the following example, the callback URL configured in the app is https://www.example.com.
Example:
$http://www.example.com?sdkappid=$sdkappid&command=$command&contenttype=json&clientip=$clientip&optplatform=$optplatform
Request parameters
Parameter
Description
http
Request protocol is HTTPS or HTTP, request method is POST
www.example.com
Callback URL
sdkappid
SDKAppID assigned by the Instant Messaging console when an application is created
command
Please refer to: Callback command list﻿
contenttype
Fixed value: json
clientip
Client IP, such as 127.0.0.1
optplatform
Client platforms may include iOS, Android, Web, miniProgram
The specific callback content is included in the HTTP request body. See the callback examples below for details.
Callback Example
Webhook request example:
POST /?sdkappid=8888888&command=caller_start_call&contenttype=json&clientip=127.0.0.1&optplatform=iOS HTTP/1.1
Host: www.example.com
Content-Length: 337
{
    "UserId": "Alice",
	"RoomId": "Alice's Room",
    "TotalNum": 2,
    "MediaType": "audio",
    "CallType": "single",
    "CallId": "aheahfo-eqwnknoihfsd-qweqf",
    "Role": "caller",
    "Event": "start_call",
    "CallResult": "",
	"EventTime": 1704695566,
    "StartCallTs": 1704856873,
    "AcceptTs": 1704856876,
    "EndTs": 1704856885
}
Request packet fields
Field
Type
Description
UserId
String
Operating User ID
RoomId
String
Operating Room ID
TotalNum
Integer
Number of Participants in Call
CallType
String
Call Type:
Single Audio Call
Group Video Call
CallId
String
Call Unique ID
Role
String
role :
Caller User ID
Callee User ID
Event
String
Call Event:
start_call Caller initiates call
call_accepted Caller answers call
call_missed Caller missed call
call_rejected Caller rejects call
call_busy Caller line busy
cancel_call Caller cancels call
call_failed Caller failed to initiate call
call_end Caller call ended normally
call_interrupted Caller call interrupted
receive_call Callee receives call
accept_call Callee answers call
not_answer_call Callee does not answer
reject_call Callee rejects call
ignore_call Called party ignores call
call_canceled Called party cancels call
call_end Normal termination of called party's call
call_interrupted Called party's call abnormally interrupted
invite_user Midway invite user
join_in_group_call Join the call midway
StartCallTs
Integer
Timestamp when call is initiated (second-level) only returned on normal_end
AcceptTs
Integer
Timestamp when call is answered (second-level) only returned on normal_end
EndTs
Integer
Timestamp when call ends (second-level) only returned on normal_end
Note:
CallResult field shows all types only for one-on-one calls, group chat only has normal_end.
﻿
﻿

ヘルプとサポート

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

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

フィードバック

tencent cloud

Tencent Real-Time Communication

Call Event Callback

Use Conditions

Notes

Scenarios that may trigger this callback

Timing of the callback

Possible callback results

API description

Request URL

Request parameters

Callback Example

Request packet fields

ヘルプとサポート

Platform/Framework	Version number
Android/iOS/Flutter/uni-app (client)	≥ 1.7.1
Web	≥ 1.4.6
WeChat Mini Program	≥ 1.5.1

Parameter	Description
http	Request protocol is HTTPS or HTTP, request method is POST
www.example.com	Callback URL
sdkappid	SDKAppID assigned by the Instant Messaging console when an application is created
command	Please refer to: Callback command list
contenttype	Fixed value: json
clientip	Client IP, such as 127.0.0.1
optplatform	Client platforms may include iOS, Android, Web, miniProgram

Field	Type	Description
UserId	String	Operating User ID
RoomId	String	Operating Room ID
TotalNum	Integer	Number of Participants in Call
CallType	String	Call Type: `Single` Audio Call `Group` Video Call
CallId	String	Call Unique ID
Role	String	role : `Caller` User ID `Callee` User ID
Event	String	Call Event: `start_call` Caller initiates call `call_accepted` Caller answers call `call_missed` Caller missed call `call_rejected` Caller rejects call `call_busy` Caller line busy `cancel_call` Caller cancels call `call_failed` Caller failed to initiate call `call_end` Caller call ended normally `call_interrupted` Caller call interrupted `receive_call` Callee receives call `accept_call` Callee answers call `not_answer_call` Callee does not answer `reject_call` Callee rejects call `ignore_call` Called party ignores call `call_canceled` Called party cancels call `call_end` Normal termination of called party's call `call_interrupted` Called party's call abnormally interrupted `invite_user` Midway invite user `join_in_group_call` Join the call midway
StartCallTs	Integer	Timestamp when call is initiated (second-level) only returned on normal_end
AcceptTs	Integer	Timestamp when call is answered (second-level) only returned on normal_end
EndTs	Integer	Timestamp when call ends (second-level) only returned on normal_end