TUICallEngine API 是音视频通话组件的无 UI 接口,如果 TUICallKit 的交互并不满足您的需求,您可以使用这套 API 根据您的业务需求自定义封装。
说明:
为提供更优质的音视频通信能力,原 @trtc/call-engine-lite-wx 包已正式停止维护,建议开发者迁移至 @trtc/call-engine-lite-wx 新包。
新包对接口进行了优化调整,部分旧版接口不再兼容,同步提供更简洁、稳定的新接口方案。
API 概览
创建实例和事件回调
API | 描述 |
创建 TUICallEngine 实例(静态方法) | |
销毁 TUICallEngine 实例(静态方法) | |
增加事件监听 | |
取消事件监听 |
通话操作相关接口函数
设备控制相关接口函数
API | 描述 |
开启摄像头 | |
关闭摄像头 | |
切换前后摄像头 | |
打开麦克风 | |
关闭麦克风 | |
选择音频播放设备(听筒/扬声器) |
其他接口函数
API | 描述 |
设置用户的头像、昵称 | |
设置日志等级 | |
设置美颜级别,支持关闭默认美颜 |
API 详情
import TUICallEngine, { TUICallEvent } from '@trtc/call-engine-lite-wx ';
createInstance
创建 TUICallEngine 的单例。
wx.$TUICallEngine = TUICallEngine.createInstance({tim,sdkAppID,});
说明
参数 | 类型 | 说明 | 是否必传 |
sdkAppID | Number | SDKAppId 是腾讯云用于区分客户的唯一标识 | 是 |
tim | ChatSDK | TIM 实例 | 否 |
destroyInstance
销毁 TUICallEngine 的单例。
TUICallEngine.destroyInstance();
on
通过 on 方法可以监听 TUICallEngine 所有的事件。
let handleNewInvitationReceived = function(event) {// 收到邀请};wx.$TUICallEngine.on(TUICallEvent.ON_CALL_RECEIVED, handleNewInvitationReceived, this);
说明
参数 | 类型 | 说明 | 是否必传 |
eventName | TUICallEvent | 事件名 | 是 |
handler | Function | 事件的回调函数 | 是 |
context | Any | 当前执行上下文(this) | 是 |
off
移除事件监听。
let handleNewInvitationReceived = function(event) {// 收到邀请};wx.$TUICallEngine.off(TUICallEvent.ON_CALL_RECEIVED, handleNewInvitationReceived);
说明
参数 | 类型 | 说明 | 是否必传 |
eventName | TUICallEvent | 事件名 | 是 |
handler | Function | 事件的回调函数 | 是 |
login
登录接口。
const params = {userID: 'john', // 您的用户 IDuserSig: 'xxxx', // 签名};let promise = wx.$TUICallEngine.login(params);promise.then(() => {//success}).catch(error => {console.warn('login error:', error);});
参数如下表所示:
参数 | 类型 | 含义 | 是否必传 |
userID | String | 当前用户的 ID,字符串类型,只允许包含英文字母(a-z 和 A-Z)、数字(0-9)、连词符(-)和下划线(_) | 是 |
userSig | String | 是 |
logout
登出接口。
let promise = wx.$TUICallEngine.logout();promise.then(() => {// logout success}).catch(error => {console.warn('logout error:', error);});
calls
发起单人或多人通话。
注意
离线推送仅适用于终端(Android 或 iOS),Web 和 微信小程序不支持。
import { CallMediaType } from '@trtc/call-engine-lite-wx';let promise = wx.$TUICallEngine.groupCall({userIDList: ['user1', 'user2'],type: CallMediaType.AUDIO,});promise.then(() => {// groupCall success}).catch(error => {console.warn('groupCall error:', error);});
参数如下表所示:
参数 | 类型 | 含义 | 是否必传 |
userIDList | Array<String> | 被呼叫者的 userID 列表 | 是 |
type | 通话的媒体类型 | 是 | |
chatGroupID | String | 与 chat 结合使用时, chat 群组的群ID | 是 |
timeout | Number | 超时时长,单位:秒 | 否 |
roomID | Number | 此次通话的音视频房间 ID,目前仅支持数字房间号,后续版本会支持字符串房间号 | 否 |
userData | String | 扩展字段: 用于在邀请信令中增加扩展信息 | 否 |
inviteUser
邀请用户加入此次群组通话。
使用场景:一个群组通话中的用户主动邀请其他人时使用。
const userIDList = ['jack', 'john'];const params = {userIDList};wx.$TUICallEngine.inviteUser(params).then(() => {// success}).catch(error => {console.error('inviteUser error:', error);});
参数如下表所示:
参数 | 类型 | 含义 | 是否必传 |
params | Object | 邀请参数 | 是 |
params.userIDList | Array<String> | 被叫用户的 userID 列表 | 是 |
join
主动加入此次群组通话。
const params = { callId: xxx };wx.$TUICallEngine.join(params).then(() => {// success}).catch(error => {console.error('join error:', error);});
参数如下表所示:
参数 | 类型 | 含义 | 是否必传 |
params | Object | 主动加入参数 | 是 |
params.callId | String | 是 | 此次通话的唯一 ID。 |
accept
接受当前通话,当您作为被叫方收到
EVENT.ON_CALL_RECEIVED
事件的回调时,可以调用该接口接听来电。wx.$TUICallEngine.on(TUICallEvent.ON_CALL_RECEIVED, () => {wx.$TUICallEngine.accept().promise.then(() => {// accept success}).catch(error => {console.warn('accept error:', error);});});
reject
拒绝当前通话,当您作为被叫收到
EVENT.ON_CALL_RECEIVED
的回调时,可以调用该函数拒绝来电。wx.$TUICallEngine.on(TUICallEvent.ON_CALL_RECEIVED, () => {wx.$TUICallEngine.reject().then(() => {// reject success}).catch(error => {console.warn('reject error:', error);});});
hangup
挂断当前通话,当您处于通话中,可以调用该函数结束通话。
wx.$TUICallEngine.hangup().then(() => {// hangup success}).catch(error => {console.warn('hangup error:', error);});
openCamera
您可以调用该函数开启摄像头。
wx.$TUICallEngine.openCamera().then(() => {// openCamera success}).catch(error => {console.warn('openCamera error:', error);});
closeCamera
您可以调用该函数关闭摄像头,处于通话中的用户会收到回调。
wx.$TUICallEngine.closeCamera().then(() => {// closeCamera success}).catch(error => {console.warn('closeCamera error:', error);});
switchCamera
切换前后摄像头。
wx.$TUICallEngine.switchCamera().then(() => {// switchCamera success}).catch(error => {console.warn('openMicrophone error:', error);});
openMicrophone
您可以调用该函数打开麦克风,处于通话中的用户会收到回调。
wx.$TUICallEngine.openMicrophone().then(() => {// openMicrophone success}).catch(error => {console.warn('openMicrophone error:', error);});
closeMicrophone
您可以调用该函数关闭麦克风,处于通话中的用户会收到回调。
wx.$TUICallEngine.closeMicrophone().then(() => {// closeMicrophone success}).catch(error => {console.warn('closeMicrophone error:', error);});
selectAudioPlaybackDevice
选择音频播放设备,目前支持听筒、扬声器,在通话场景中,可以使用这个接口来开启/关闭免提模式。
wx.$TUICallEngine.selectAudioPlaybackDevice(AUDIO_PLAYBACK_DEVICE.EAR).then(() => {// selectAudioPlaybackDevice success}).catch(error => {console.warn('selectAudioPlaybackDevice error:', error);});
参数如下表所示:
参数 | 类型 | 含义 | 是否必传 |
type | 扬声器:AUDIO_PLAYBACK_DEVICE.SPEAKER
听筒:AUDIO_PLAYBACK_DEVICE.EAR | 是 |
setSelfInfo
设置用户头像、昵称。
wx.$TUICallEngine.setSelfInfo("昵称", "头像 URL").then(() => {// setSelfInfo success}).catch(error => {console.warn('setSelfInfo error:', error);});
参数如下表所示:
参数 | 类型 | 含义 |
nickName | String | 设置昵称 |
avatar | String | 头像地址 |
setLogLevel
设置日志级别,低于 level 的日志将不会输出。
wx.$TUICallEngine.setLogLevel(level)
参数如下表所示:
参数 | 值 | 含义 |
level | 0 | 普通级别,日志量较多,接入时建议使用 |
| 1 | release 级别,SDK 输出关键信息,生产环境时建议使用 |
| 2 | 告警级别,SDK 只输出告警和错误级别的日志 |
| 3 | 错误级别,SDK 只输出错误级别的日志 |
| 4 | 无日志级别,SDK 将不打印任何日志 |
setBeautyLevel
设置美颜级别,支持关闭默认美颜。
wx.$TUICallEngine.setBeautyLevel(beautyLevel: number);
参数如下表所示:
参数 | 类型 | 含义 |
beautyLevel | number | 美颜级别,取值范围 0 - 9; 0 表示关闭,9 表示效果最明显 |