TUICallEngine API 简介
TUICallEngine API 是音视频通话组件的无 UI 接口,如果 TUICallKit 的交互并不满足您的需求,您可以使用这套接口自己封装交互。 由于小程序开发的限制,需要先给live-pusher绑定事件,具体可以参照TUICallkit。
TUICallEngine API 概览
创建实例和事件回调
API | 描述 |
---|---|
createInstance | 创建 TUICallEngine 实例(静态方法) |
destroyInstance | 销毁 TUICallEngine 实例(静态方法) |
on | 增加事件监听 |
off | 取消事件监听 |
通话操作相关接口函数
API | 描述 |
---|---|
call | 发起 1v1 通话 |
accept | 接听通话 |
reject | 拒绝通话 |
hangup | 结束通话 |
switchCallMediaType | 切换通话媒体类型,比如视频通话切音频通话 |
设备控制相关接口函数
API | 描述 |
---|---|
openCamera | 开启摄像头 |
closeCamera | 关闭摄像头 |
switchCamera | 切换前后摄像头 |
openMicrophone | 打开麦克风 |
closeMicrophone | 关闭麦克风 |
selectAudioPlaybackDevice | 选择音频播放设备(听筒/扬声器) |
其他接口函数
API | 描述 |
---|---|
setSelfInfo | 设置用户的头像、昵称 |
API 详情
createInstance
创建 TUICallEngine 的单例(class上的static方法)
TUICallEngine.createInstance({
sdkAppID:'xxxxxxx',
tim,
})
说明
参数 | 是否必传 | 说明 |
---|---|---|
sdkAppID | 必传 | SDKAppId是腾讯云用于区分客户的唯一标识 |
tim | 非必传 | TIM 是 IM Web SDK 的命名空间,提供了创建 SDK 实例的静态方法 |
destroyInstance
销毁 TUICallEngine 的单例(class上的static方法)
TUICallEngine.destroyInstance()
on
添加回调接口,您可以通过这个接听,监听TRTC
相关的事件回调
on(EventCode, handler, context);
说明
参数 | 类型 | 说明 |
---|---|---|
Eventlist | String | 事件表 |
handler | Function | 监听函数 |
context | Object | 当前执行上下文 |
off
移除回调接口
off(EventCode, handler);
说明
参数 | 类型 | 说明 |
---|---|---|
EventCode | String | 事件表 |
handler | Function | 监听函数 |
context | Object | 当前执行上下文 |
call
C2C邀请通话,被邀请方会收到的回调,如果当前处于通话中,可以调用该函数以邀请第三方进入通话
call({
userID:"xxxxxxx",
type:MEDIA_TYPE.AUDIO
})
参数如下表所示:
参数 | 类型 | 含义 |
---|---|---|
userID | String | 目标用户的userId |
type | MEDIA_TYPE | 通话的媒体类型,AUDIO-语音通话,VIDEO-视频通话 |
accept
当您作为被邀请方收到的回调时,可以调用该函数接听来电
accept();
reject
当您作为被邀请方收到的回调时,可以调用该函数拒绝来电
reject();
hangup
当您处于通话中,可以调用该函数挂断通话 当您发起通话时,可用去了取消通话
hangup();
switchCallMediaType
切换通话媒体类型,比如视频通话切音频通话
switchCallMediaType(MEDIA_TYPE.VIDEO);
参数 | 类型 | 含义 |
---|---|---|
type | MEDIA_TYPE | 通话的媒体类型,AUDIO-语音通话,VIDEO-视频通话 |
openCamera
您可以调用该函数开启摄像头
openCamera();
closeCamera
您可以调用该函数关闭摄像头,处于通话中的用户会收到回调
closeCamera();
switchCamera
切换前后摄像头
switchCamera();
openMicrophone
您可以调用该函数打开麦克风 处于通话中的用户会收到回调
openMicrophone();
closeMicrophone
您可以调用该函数关闭麦克风 处于通话中的用户会收到回调
closeMicrophone();
selectAudioPlaybackDevice
选择音频播放设备,目前支持听筒、扬声器,在通话场景中,可以使用这个接口来开启/关闭免提模式。
selectAudioPlaybackDevice(AUDIO_PLAYBACK_DEVICE.EAR);
参数如下表所示:
参数 | 类型 | 含义 |
---|---|---|
type | AUDIO_PLAYBACK_DEVICE | speaker:扬声器 ear:听筒 |
setSelfInfo
设置用户头像、昵称的接口
setSelfInfo('xxxxxxx','头像.png') ;
参数如下表所示:
参数 | 类型 | 含义 |
---|---|---|
nickName | String | 设置昵称 |
avatar | String | 头像地址 |
事件表
事件名 | 说明 |
---|---|
INVITED | 被邀请通话 |
USER_ACCEPT | 用户接听 |
USER_ENTER | 用户进入通话 |
USER_LEAVE | 用户离开通话 |
USER_UPDATE | 用户更新 |
REJECT | 用户拒绝通话 |
NO_RESP | 用户无响应 |
LINE_BUSY | 用户忙线 |
CALLING_CANCEL | 通话被取消 |
CALLING_TIMEOUT | 通话超时未应答 |
CALL_END | 通话结束 |
SDK_READY | SDK Ready 回调 |
KICKED_OUT | 被踢下线 |
CALL_MODE | 切换通话模式 |
INVITED
被邀请通话
let handleNewInvitationReceived=function(event){
console.log('被邀请通话')
}
tuiCallEngine.on(EVENT.INVITED, this.handleNewInvitationReceived, this);
USER_ACCEPT
用户接听
let handleUserAccept=function(event) {
console.log('用户接听')
}
tuiCallEngine.on(EVENT.USER_ACCEPT, this.handleUserAccept, this);
USER_ENTER
用户进入通话
let handleUserEnter=function(event) {
console.log('用户进入通话')
}
tuiCallEngine.on(EVENT.USER_ENTER, this.handleUserEnter, this);
USER_LEAVE
用户离开通话
let handleUserLeave=function(event) {
console.log('用户离开通话')
}
tuiCallEngine.on(EVENT.USER_LEAVE, this.handleUserLeave, this);
USER_UPDATE
用户更新
let handleUserUpdate=function(event) {
console.log('用户更新')
}
tuiCallEngine.on(EVENT.USER_UPDATE, this.handleUserUpdate, this)
REJECT
用户拒绝通话
let handleInviteeReject=function(event) {
console.log('用户拒绝通话')
}
tuiCallEngine.on(EVENT.REJECT, this.handleInviteeReject, this);
NO_RESP
用户无响应
let handleNoResponse=function(event) {
console.log('用户无响应')
}
tuiCallEngine.on(EVENT.NO_RESP, this.handleNoResponse, this);
LINE_BUSY
用户忙线
let handleLineBusy=function(event) {
console.log('用户忙线')
}
tuiCallEngine.on(EVENT.LINE_BUSY, this.handleLineBusy, this);
CALLING_CANCEL
通话被取消
let handleCallingCancel=function(event) {
console.log('通话被取消')
}
tuiCallEngine.on(EVENT.CALLING_CANCEL, this.handleCallingCancel, this);
CALLING_TIMEOUT
通话超时未应答
let handleCallingTimeout=function(event) {
console.log('通话超时未应答')
}
tuiCallEngine.on(EVENT.CALLING_TIMEOUT, this.handleCallingTimeout, this);
CALL_END
通话结束
let handleCallingEnd=function(event) {
console.log('通话结束')
}
tuiCallEngine.on(EVENT.CALL_END, this.handleCallingEnd, this);
SDK_READY
SDK Ready 回调
let handleSDKReady=function(event) {
console.log('SDK Ready 回调')
}
tuiCallEngine.on(EVENT.SDK_READY, this.handleSDKReady, this);
KICKED_OUT
被踢下线
let handleKickedOut=function(event) {
console.log('被踢下线')
}
tuiCallEngine.on(EVENT.KICKED_OUT, this.handleKickedOut, this);
CALL_MODE
切换通话模式
let handleCallMode=function(event) {
console.log('切换通话模式')
}
tuiCallEngine.on(EVENT.CALL_MODE, this.handleCallMode, this);
通话的类型
MEDIA_TYPE | 说明 |
---|---|
AUDIO | 音频 |
VIDEO | 视频 |
声音的播放设备
AUDIO_PLAYBACK_DEVICE | 说明 |
---|---|
EAR | 听筒 |
SPEAKER | 扬声器 |
通话中的事件处理
事件名 | 说明 |
---|---|
_pusherNetStatus | pusher 的网络状况 |
_playNetStatus | player 的网络状况 |
_pusherStateChangeHandler | live-pusher 改变状态事件处理 |
_pusherAudioVolumeNotify | live-pusher 麦克风采集的音量大小事件处理 |
_playerStateChange | live-player 状态事件处理 |
_playerAudioVolumeNotify | live-player 麦克风采集的音量大小事件处理 |
_pusherAudioHandler | 订阅 / 取消订阅 Audio |
_pusherVideoHandler | 订阅 / 取消订阅 Video |