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 ポリシー
プライバシーポリシー
データ処理とセキュリティ契約
用語集

Type Definition

PDF
フォーカスモード
フォントサイズ
最終更新日: 2025-11-25 14:28:26

Common structures

TUICallDefine

Type
Description
An additional parameter.
Offline push vendor configuration information
Extended information

TUICommonDefine

Type
Description
TUIRoomId
Room ID for audio and video in a call.
Network quality information
Video render parameters
Video encoding parameters

Enum definition

TUICallDefine

Type
Description
Media type in a call
Roles of individuals in a call
The call status
The call scene
iOS offline push type
Call end reason

TUICommonDefine

Type
Description
Audio route
TUICamera
Camera type
Network quality
Video image fill mode
Video image rotation direction
Video aspect ratio mode
Video resolution

TUICallParams

Call params
Value
Type
Description
roomId
TUIRoomId
Room ID for audio and video in a call.
offlinePushInfo
Offline push vendor configuration information.
timeout
int
Call timeout period, default: 30s, unit: seconds.
userData
NSString
An additional parameter. Callback when the callee receives onCallReceived
chatGroupId
NSString
Chat Group ID

TUIOfflinePushInfo

Offline push vendor configuration information,please refer to:Offline call push.
Value
Type
Description
title
NSString
offlinepush notification title
desc
NSString
offlinepush notification description
ignoreIOSBadge
BOOL
Ignore badge count for offline push (only for iOS), if set to true, the message will not increase the unread count of the app icon on the iOS receiver's side.
iOSSound
NSString
Offline push sound setting (only for iOS). When sound = IOS_OFFLINE_PUSH_NO_SOUND, there will be no sound played when the message is received. When sound = IOS_OFFLINE_PUSH_DEFAULT_SOUND, the system sound will be played when the message is received. If you want to customize the iOSSound, you need to link the audio file into the Xcode project first, and then set the audio file name (with extension) to the iOSSound.
androidSound
NSString
Offline push sound setting (only for Android, supported by IMSDK 6.1 and above). Only Huawei and Google phones support setting sound prompts. For Xiaomi phones, please refer to: Xiaomi custom ringtones. In addition, for Google phones, in order to set sound prompts for FCM push on Android 8.0 and above systems, you must call setAndroidFCMChannelID to set the channelID for it to take effect.
androidOPPOChannelID
NSString
Set the channel ID for OPPO phones with Android 8.0 and above systems.
androidVIVOClassification
NSInteger
Classification of VIVO push messages (deprecated interface, VIVO push service will optimize message classification rules on April 3, 2023. It is recommended to use setAndroidVIVOCategory to set the message category). 0: Operational messages, 1: System messages. The default value is 1.
androidXiaoMiChannelID
NSString
Set the channel ID for Xiaomi phones with Android 8.0 and above systems.
androidFCMChannelID
NSString
Set the channel ID for Google phones with Android 8.0 and above systems.
androidHuaWeiCategory
NSString
Classification of Huawei push messages, please refer to: Huawei message classification standard.
isDisablePush
BOOL
Whether to turn off push notifications (default is on).
iOSPushType
iOS offline push type,default is APNs

TUICallObserverExtraInfo

Callback extended information.
Type
Type
Description
roomId
TUIRoomId
room ID
role
Call role
userData
String
Custom extended field when initiating a call
chatGroupId
String
Group ID

TUIRoomId

Room ID for audio and video in a call. Note:
(1) intRoomId and strRoomId are mutually exclusive. If you choose to use strRoomIdintRoomId needs to be filled in as 0. If both are filled in, the SDK will prioritize intRoomId.
(2) Do not mix intRoomId and strRoomId because they are not interchangeable. For example, the number 123 and the string "123" represent two completely different rooms.
Value
Type
Description
intRoomId
UInt32
Numeric room ID. range: 1 - 2147483647(2^31-1)
strRoomId
NSString
String room ID. range:Limited to 64 bytes in length. The supported character set range is as follows (a total of 89 characters):
Lowercase and uppercase English letters. (a-zA-Z)
Number (0-9)
space, !, #, $, %, &, (, ), +, -, :, ;, <, =, ., >, ?, @, [, ], ^, _, {, }, |, ~, ,
Note:
Currently, string room number is only supported on Android,iOS,Flutter and Uni-app platforms. Support for other platforms such as Web and Mini Programs will be available in the future. Please stay tuned !

TUIVideoRenderParams

Video render parameters
Value
Type
Description
fillMode
Video image fill mode
rotation
Video image rotation direction

TUINetworkQualityInfo

User network quality information
Value
Type
Description
userId
NSString
user ID
quality
network quality

TUIVideoEncoderParams

Video encoding parameters
Value
Type
Description
resolution
Video resolution
resolutionMode
Video aspect ratio mode

TUICallMediaType

Call media type
Type
Value
Description
TUICallMediaTypeUnknown
0
Unknown
TUICallMediaTypeAudio
1
Audio call
TUICallMediaTypeVideo
2
Video call

TUICallRole

Call role
Type
Value
Description
TUICallRoleNone
0
Unknown
TUICallRoleCall
1
Caller(inviter)
TUICallRoleCalled
2
Callee(invitee)

TUICallStatus

Call status
Type
Value
Description
TUICallStatusNone
0
Unknown
TUICallStatusWaiting
1
The call is currently waiting
TUICallStatusAccept
2
The call has been accepted

TUICallScene

Call scene
Type
Value
Description
TUICallSceneGroup
0
Group call
TUICallSceneMulti
1
Anonymous group calling (not supported at this moment, please stay tuned).
TUICallSceneSingle
2
One to one call

TUICallIOSOfflinePushType

iOS offline push type
Type
Value
Description
TUICallIOSOfflinePushTypeAPNs
0
APNs
TUICallIOSOfflinePushTypeVoIP
1
VoIP

TUICallEndReason

Call end reason
Type
Value
Description
TUICallEndReasonUnknown
0
Unknown
TUICallEndReasonHangup
1
Hang up
TUICallEndReasonReject
2
Deny
TUICallEndReasonNoResponse
3
No response
TUICallEndReasonOffline
4
Offline
TUICallEndReasonLineBusy
5
Busy Line
TUICallEndReasonCanceled
6
Cancel call
TUICallEndReasonOtherDeviceAccepted
7
Other device answers
TUICallEndReasonOtherDeviceReject
8
Other device denies
TUICallEndReasonEndByServer
9
Backend ends

TUIAudioPlaybackDevice

Audio route
Type
Value
Description
TUIAudioPlaybackDeviceSpeakerphone
0
Speakerphone
TUIAudioPlaybackDeviceEarpiece
1
Earpiece

TUICamera

Front/Back camera
Type
Value
Description
TUICameraFront
0
Front camera
TUICameraBack
1
Back camera

TUINetworkQuality

Network quality
Type
Value
Description
TUINetworkQualityUnknown
0
Unknown
TUINetworkQualityExcellent
1
Excellent
TUINetworkQualityGood
2
Good
TUINetworkQualityPoor
3
Poor
TUINetworkQualityBad
4
Bad
TUINetworkQualityVbad
5
VBad
TUINetworkQualityDown
6
Down

TUIVideoRenderParamsFillMode

If the aspect ratio of the video display area is not equal to that of the video image, you need to specify the fill mode:
Type
Value
Description
TUIVideoRenderParamsFillModeFill
0
Fill mode: the video image will be centered and scaled to fill the entire display area, where parts that exceed the area will be cropped. The displayed image may be incomplete in this mode.
TUIVideoRenderParamsFillModeFit
1
Fit mode: the video image will be scaled based on its long side to fit the display area, where the short side will be filled with black bars. The displayed image is complete in this mode, but there may be black bars.

TUIVideoRenderParamsRotation

We provides rotation angle setting APIs for local and remote images. The following rotation angles are all clockwise.
Type
Value
Description
TUIVideoRenderParamsRotation_0
0
No rotation
TUIVideoRenderParamsRotation_90
1
Clockwise rotation by 90 degrees
TUIVideoRenderParamsRotation_180
2
Clockwise rotation by 180 degrees
TUIVideoRenderParamsRotation_270
3
Clockwise rotation by 270 degrees

TUIVideoEncoderParamsResolutionMode

Video aspect ratio mode
Type
Value
Description
TUIVideoEncoderParamsResolutionModeLandscape
0
Landscape resolution, such as:TUIVideoEncoderParamsResolution_640_360 + TUIVideoEncoderParamsResolutionModeLandscape = 640 × 360
TUIVideoEncoderParamsResolutionModePortrait
1
Portrait resolution, such as:TUIVideoEncoderParamsResolution_640_360 + TUIVideoEncoderParamsResolutionModePortrait = 360 × 640

TUIVideoEncoderParamsResolution

Video resolution
Type
Value
Description
TUIVideoEncoderParamsResolution_640_360
1
Aspect ratio: 16:9;resolution: 640x360;recommended bitrate: 500kbps
TUIVideoEncoderParamsResolution_960_540
2
Aspect ratio: 16:9;resolution: 960x540;recommended bitrate: 850kbps
TUIVideoEncoderParamsResolution_1280_720
3
Aspect ratio: 16:9;resolution: 1280x720;recommended bitrate: 1200kbps
TUIVideoEncoderParamsResolution_1920_1080
4
Aspect ratio: 16:9;resolution: 1920x1080;recommended bitrate: 2000kbps

ヘルプとサポート

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

フィードバック