API | 描述 |
初始化 TUICallKit 组件实例 | |
发起 1v1 通话,支持自定义房间号、通话邀请超时时间,离线推送内容等 | |
发起群组通话,支持自定义房间号、通话邀请超时时间,离线推送内容等 | |
主动加入当前的群组通话中,v3.1.2+ 支持 | |
设置自定义来电铃音,v3.0.0+ 支持 | |
设置用户昵称和头像,v2.2.0+ 支持 | |
开启/关闭来电铃声,v3.1.2+ 支持 | |
开启/关闭悬浮窗功能,v3.1.0+ 支持 | |
开启/关闭模糊背景的功能按钮,v3.2.4+ 支持 | |
设置 TUICallKit 组件通话语言 | |
隐藏按钮,v3.2.9+ 支持 | |
设置本地用户通话界面背景图,v3.2.9+ 支持 | |
设置远端用户通话界面背景图,v3.2.9+ 支持 | |
设置通话界面布局模式,v3.3.0+ 支持 | |
设置摄像头是否默认打开,v3.3.0+ 支持 | |
销毁 TUICallKit 组件实例 |
<TUICallKit/>
属性介绍属性 | 描述 | 类型 | 是否必填 | 默认值 | 支持 vue | 支持 react |
allowedMinimized | 是否允许悬浮窗 | boolean | 否 | false |
√
| √ |
allowedFullScreen | 是否允许通话界面全屏 | boolean | 否 | true | √ | √ |
通话界面显示模式 | VideoDisplayMode | 否 | VideoDisplayMode.COVER | √ | √ | |
通话分辨率 | VideoResolution | 否 | VideoResolution.RESOLUTION_480P | √ | √ | |
beforeCalling | 拨打电话前与收到通话邀请前会执行此函数 | function(type, error) | 否 | - | √ | √ |
afterCalling | 结束通话后会执行此函数 | function() | 否 | - | √ | √ |
onMinimized | function(oldStatus, newStatus) | 否 | - | √ | × | |
kickedOut | 组件抛出的事件,当前登录用户被踢出登录时会触发该事件,通话也会自动结束 | function() | 否 | - | √ | × |
statusChanged | function({oldStatus, newStatus}) | 否 | - | √ | × |
import { TUICallKit, VideoDisplayMode, VideoResolution } from "@tencentcloud/call-uikit-react";<TUICallKitvideoDisplayMode={VideoDisplayMode.CONTAIN}videoResolution={VideoResolution.RESOLUTION_1080P}beforeCalling={handleBeforeCalling}afterCalling={handleAfterCalling}/>function handleBeforeCalling(type: string, error: any) {console.log("[TUICallkit Demo] handleBeforeCalling:", type, error);}function handleAfterCalling() {console.log("[TUICallkit Demo] handleAfterCalling");}
<template><TUICallKit:allowedMinimized="true":allowedFullScreen="true":videoDisplayMode="VideoDisplayMode.CONTAIN":videoResolution="VideoResolution.RESOLUTION_1080P":beforeCalling="beforeCalling":afterCalling="afterCalling":onMinimized="onMinimized":kickedOut="handleKickedOut":statusChanged="handleStatusChanged"/></template><script lang="ts" setup>import { TUICallKit, TUICallKitServer, VideoDisplayMode, VideoResolution, STATUS } from "@tencentcloud/call-uikit-vue";function beforeCalling(type: string, error: any) {console.log("[TUICallkit Demo] beforeCalling:", type, error);}function afterCalling() {console.log("[TUICallkit Demo] afterCalling");}function onMinimized(oldStatus: string, newStatus: string) {console.log("[TUICallkit Demo] onMinimized: " + oldStatus + " -> " + newStatus);}function kickedOut() {console.log("[TUICallkit Demo] kickedOut");}function statusChanged(args: { oldStatus: string; newStatus: string; }) {const { oldStatus, newStatus } = args;if (newStatus === STATUS.CALLING_C2C_VIDEO) {console.log(`[TUICallkit Demo] statusChanged: ${oldStatus} -> ${newStatus}`);}}</script>
import { TUICallKitServer } from "@tencentcloud/call-uikit-react";// Replace it with the call-uikit npm package you are currently using
try {await TUICallKitServer.init({ SDKAppID, userID, userSig });// If you already have a tim instance in your project, you need to pass it in here// await TUICallKitServer.init({ tim, SDKAppID, userID, userSig});console.log("[TUICallKit] Initialization succeeds.");} catch (error: any) {console.error(`[TUICallKit] Initialization failed. Reason: ${error}`);}
参数 | 类型 | 是否必填 | 含义 |
SDKAppID | Number | 是 | |
userID | String | 是 | 即用户名,只允许包含英文字母(a-z 和 A-Z)、数字(0-9)、连词符(-)和下划线(_)。 |
userSig | String | 是 | 使用 SDKSecretKey 对 SDKAppID、UserID 等信息进行加密,就可以得到 userSig。
它是一个鉴权用的票据,用于腾讯云识别当前用户是否能够使用 TRTC 的服务,获取方式请参考 如何计算 UserSig |
tim | TencentCloudChat | 否 |
import { TUICallKitServer, TUICallType } from '@tencentcloud/call-uikit-react';try {await TUICallKitServer.call({userID: 'mike', // username being calledtype: TUICallType.VIDEO_CALL,});} catch (error: any) {console.error(`[TUICallKit] Call failed. Reason: ${error}`);}
参数 | 类型 | 是否必填 | 含义 |
userID | String | 是 | 被呼叫用户的用户名 |
type | 是 | ||
roomID | Number | 否 | 数字房间号,范围 [1, 2147483647] |
strRoomID | String | 否 | 字符串房间号。v3.3.1+ 支持 范围: 长度限制为64个字节。支持的字符集范围如下(共89个字符): 小写和大写英文字母。(a-zA-Z); 数字(0-9); 空格 、! 、# 、$ 、% 、& 、( 、) 、+ 、- 、: 、; 、< 、= 、. 、> 、? 、@ 、[ 、] 、^ 、_ 、{ 、} 、| 、~ 、, 。1. roomID 与 strRoomID 是互斥的,若您选用 strRoomID,则 roomID 需要填写为 0。若两者都填,SDK 将优先选用 roomID。 2. 不要混用 roomID 和 strRoomID,因为它们之间是不互通的,比如数字 123 和字符串 "123" 是两个完全不同的房间。 |
timeout | Number | 否 | 通话超时时间,默认:30s,单位:秒。timeout = 0,设置为不超时 |
userData | String | 否 | |
Object | 否 | 自定义离线消息推送参数 |
import { TUICallKitServer, TUICallType } from '@tencentcloud/call-uikit-react';try {await TUICallKitServer.groupCall({userIDList: ['jack', 'tom'],groupID: 'xxx',type: TUICallType.VIDEO_CALL});} catch (error: any) {console.error(`[TUICallKit] Failed to call the groupCall API. Reason:${error}`);}
参数 | 类型 | 是否必填 | 含义 |
userIDList | Array<String> | 是 | 被呼叫的用户列表 |
type | 是 | ||
groupID | String | 是 | |
roomID | Number | 否 | 数字房间号,范围 [1, 2147483647] |
strRoomID | String | 否 | 字符串房间号。v3.3.1+ 支持 范围: 长度限制为64个字节。支持的字符集范围如下(共89个字符): 小写和大写英文字母。(a-zA-Z); 数字(0-9); 空格 、! 、# 、$ 、% 、& 、( 、) 、+ 、- 、: 、; 、< 、= 、. 、> 、? 、@ 、[ 、] 、^ 、_ 、{ 、} 、| 、~ 、, 。1. roomID 与 strRoomID 是互斥的,若您选用 strRoomID,则 roomID 需要填写为 0。若两者都填,SDK 将优先选用 roomID。 2. 不要混用 roomID 和 strRoomID,因为它们之间是不互通的,比如数字 123 和字符串 "123" 是两个完全不同的房间。 |
timeout | Number | 否 | 通话超时时间,默认:30s,单位:秒。timeout = 0,设置为不超时 |
userData | String | 否 | |
Object | 否 | 自定义离线消息推送参数 |
TUICallKitServer.setLanguage("zh-cn"); // "en" | "zh-cn" | "ja_JP"
参数 | 类型 | 是否必填 | 含义 |
lang | String | 是 | 语言类型 en 、zh-cn 和 ja_JP 。 |
try {await TUICallKitServer.setSelfInfo({ nickName: "xxx", avatar: "http://xxx" });} catch (error: any) {console.error(`[TUICallKit] Failed to call the setSelfInfo API. Reason: ${error}`;}
参数 | 类型 | 是否必填 | 含义 |
nickName | String | 是 | 自己的昵称 |
avatar | String | 是 | 自己头像地址 |
filePath
传空即可。import filePath from '../assets/phone_ringing.mp3';try {await TUICallKitServer.setCallingBell(filePath)} catch (error: any) {console.error(`[TUICallKit] Failed to call the setCallingBell API. Reason: ${error}`);}
参数 | 类型 | 是否必填 | 含义 |
filePath | String | 是 | 铃声文件地址 |
try {const enable = true;await TUICallKitServer.enableFloatWindow(enable);} catch (error: any) {console.error(`[TUICallKit] Failed to call the enableFloatWindow API. Reason: ${error}`);}
参数 | 类型 | 是否必填 | 含义 |
enable | Boolean | 是 | 开启/关闭悬浮窗功能 |
try {const enable = true;await TUICallKitServer.enableMuteMode(enable);} catch (error: any) {console.error(`[TUICallKit] Failed to call the enableMuteMode API. Reason: ${error}`);}
参数 | 类型 | 是否必填 | 含义 |
enable | Boolean | 是 | 开启/关闭来电铃声。默认 false。 |
import { TUICallKitServer, TUICallType } from '@tencentcloud/call-uikit-react';try {const params = {type: TUICallType.VIDEO_CALL,groupID: "xxx",roomID: 234,};await TUICallKitServer.joinInGroupCall(params);} catch (error: any) {console.error(`[TUICallKit] Failed to call the enableMuteMode API. Reason: ${error}`);}
参数 | 类型 | 是否必填 | 含义 |
type | 是 | 通话的媒体类型,例如视频通话、语音通话 | |
groupID | string | 是 | 此次群组通话的群 ID |
roomID | number | 是 | 此次通话的音视频房间 ID |
import { TUICallKitServer } from "@tencentcloud/call-uikit-react";const enable = true;TUICallKitServer.enableVirtualBackground(enable);
参数 | 类型 | 是否必填 | 含义 |
enable | boolean | 是 | enable = true 显示模糊背景按钮 enable = false 不显示模糊背景按钮 |
TUICallKitServer.hideFeatureButton(buttonName: FeatureButton);
参数 | 类型 | 是否必填 | 含义 |
buttonName | 是 | 按钮名称 |
TUICallKitServer.setLocalViewBackgroundImage(url: string);
参数 | 类型 | 是否必填 | 含义 |
url | string | 是 | 图片地址(支持本地路径和网络地址) |
TUICallKitServer.setRemoteViewBackgroundImage(userId: string, url: string);
参数 | 类型 | 是否必填 | 含义 |
userId | string | 是 | 远端用户 userId,设置为 '*' 表示对所有远端用户生效 |
url | string | 是 | 图片地址(支持本地路径和网络地址) |
import { TUICallKitServer, LayoutMode } from "@tencentcloud/call-uikit-vue";TUICallKitServer.setLayoutMode(LayoutMode.LocalInLargeView);
import { TUICallKitServer, LayoutMode } from "@tencentcloud/call-uikit-react";TUICallKitServer.setLayoutMode(LayoutMode.LocalInLargeView);
参数 | 类型 | 是否必填 | 含义 |
layoutMode | 是 | 用户流的布局模式 |
TUICallKitServer.setCameraDefaultState(true);
参数 | 类型 | 是否必填 | 含义 |
isOpen | boolean | 是 | 是否开启摄像头 |
tim
,需要手动退出tim.logout();
。try {await TUICallKitServer.destroyed();} catch (error: any) {console.error(`[TUICallKit] Failed to call the destroyed API. Reason: ${error}`);}
videoDisplayMode
属性有三个值:VideoDisplayMode.CONTAIN
VideoDisplayMode.COVER
VideoDisplayMode.FILL
,默认值是VideoDisplayMode.COVER
。属性 | 值 | 描述 |
videoDisplayMode | VideoDisplayMode.CONTAIN | 优先保证视频内容全部显示。 视频尺寸等比缩放,直至视频窗口的一边与视窗边框对齐。 如果视频尺寸与显示视窗尺寸不一致,在保持长宽比的前提下,将视频进行缩放后填满视窗,缩放后的视频四周会有一圈黑边。 |
| VideoDisplayMode.COVER | 优先保证视窗被填满。 视频尺寸等比缩放,直至整个视窗被视频填满。 如果视频长宽与显示窗口不同,则视频流会按照显示视窗的比例进行周边裁剪或图像拉伸后填满视窗。 |
| VideoDisplayMode.FILL | 保证视窗被填满的同时保证视频内容全部显示,但是不保证视频尺寸比例不变。 视频的宽高会被拉伸至和视窗尺寸一致。 |
videoResolution
有三个值:VideoResolution.RESOLUTION_480P
VideoResolution.RESOLUTION_720P
VideoResolution.RESOLUTION_1080P
,默认值是VideoResolution.RESOLUTION_480P
。视频 Profile | 分辨率(宽 × 高) | 帧率(fps) | 码率(kbps) |
480p | 640 × 480 | 15 | 900 |
720p | 1280 × 720 | 15 | 1500 |
1080p | 1920 × 1080 | 15 | 2000 |
STATUS 属性值 | 描述 |
STATUS.IDLE | 闲置状态 |
STATUS.BE_INVITED | 收到通话邀请 |
STATUS.DIALING_C2C | 正在 1v1 呼叫 |
STATUS.DIALING_GROUP | 正在群组呼叫 |
STATUS.CALLING_C2C_AUDIO | 正在 1v1 语音通话 |
STATUS.CALLING_C2C_VIDEO | 正在 1v1 视频通话 |
STATUS.CALLING_GROUP_AUDIO | 正在群组语音通话 |
STATUS.CALLING_GROUP_VIDEO | 正在群组视频通话 |
TUICallType 类型 | 描述 |
TUICallType.AUDIO_CALL | 语音通话 |
TUICallType.VIDEO_CALL | 视频通话 |
参数 | 类型 | 是否必填 | 含义 |
offlinePushInfo.title | String | 否 | 离线推送标题(选填) |
offlinePushInfo.description | String | 否 | 离线推送内容(选填) |
offlinePushInfo.androidOPPOChannelID | String | 否 | 离线推送设置 OPPO 手机 8.0 系统及以上的渠道 ID(选填) |
offlinePushInfo.extension | String | 否 | |
offlinePushInfo.ignoreIOSBadge | Boolean | 否 | 离线推送忽略 badge 计数(仅对 iOS 生效), 如果设置为 true,在 iOS 接收端,这条消息不会使 APP 的应用图标未读计数增加 v3.3.0+ 支持 |
offlinePushInfo.iOSSound | String | 否 | 离线推送声音设置(仅对 iOS 生效)。v3.3.0+ 支持 |
offlinePushInfo.androidSound | String | 否 | 离线推送声音设置(仅对 Android 生效)。v3.3.0+ 支持 |
offlinePushInfo.androidVIVOClassification | Number | 否 | VIVO 推送消息分类(已弃用的接口,VIVO 推送服务将在 2023 年 4 月 3 日优化消息分类规则。建议使用 setAndroidVIVOCategory 设置消息类别)。0:运营消息,1:系统消息。默认值为 1。v3.3.0+ 支持 |
offlinePushInfo.androidXiaoMiChannelID | String | 否 | 小米手机 8.0 系统及以上的渠道 ID。v3.3.0+ 支持 |
offlinePushInfo.androidFCMChannelID | String | 否 | FCM 通道手机 8.0 系统及以上的渠道 ID。v3.3.0+ 支持 |
offlinePushInfo.androidHuaWeiCategory | String | 否 | 华为推送消息分类。v3.3.0+ 支持 |
offlinePushInfo.isDisablePush | Boolean | 否 | 是否关闭推送(默认开启推送)。v3.3.0+ 支持 |
offlinePushInfo.iOSPushType | Number | 否 | iOS 离线推送类型。0-普通推送;1-VoIP推送。默认:0。v3.3.0+ 支持 |
const extension = {timPushFeatures: {fcmPushType: 0, // 0, VoIP; 1, notification}};offlinePushInfo.extension = JSON.stringify(extension);
const extension = {timPushFeatures: {fcmPushType: 0, // 0, data; 1, notificationfcmNotificationType: 1, // 0, TIMPush implementation; 1, business implementation after transparent transmission}};offlinePushInfo.extension = JSON.stringify(extension);
FeatureButton 类型 | 描述 |
FeatureButton.Camera | 摄像头按钮 |
FeatureButton.Microphone | 麦克风按钮 |
FeatureButton.SwitchCamera | 切换前后置摄像头按钮 |
LayoutMode 类型 | 描述 |
LayoutMode.LocalInLargeView | 本地用户在大窗显示 |
LayoutMode.RemoteInLargeView | 远端用户在大窗显示 |
本页内容是否解决了您的问题?