1. 背景介绍
在如今移动互联网快速发展的时代,人们越来越注重移动端应用的使用体验,而微信小程序作为一种轻量级应用程序,因其快速、便捷、功能齐全的优点得到了越来越多的用户广泛使用。然而,随着社交、娱乐、在线教育等需要实时音视频通信的业务需求逐渐增多,如何在微信小程序中集成实时音视频通话功能成为了一项重要需求。
2. 实现原理
在微信小程序中集成实时音视频通话功能,可借助腾讯云TRTC SDK 实现。腾讯云TRTC SDK内置音视频采集、编解码、传输、播放等核心技术,提供一整套音视频通话解决方案,可实现极佳的音视频体验。TRTC SDK 的底层采用 WebRTC 技术,通过 WebRTC 的对等连接后,两个用户便可以进行实时音视频通话。
2.1 准备工作
在集成TRTC SDK前,需要在微信公众平台上注册小程序,并提交实名认证;在腾讯云 TRTC 控制台 创建应用并获取 SDKAppID,同时生成 UserSig。UserSig 是安全鉴权票据,用于验证通话双方的身份,确保数据传输的可靠性。获取 UserSig 的方法有多种,您可以通过控制台、服务端或 SDK 实时生成。
2.2 集成 SDK
通过使用官方提供的TRTC SDK,您可以轻松地集成实时音视频通话功能。具体步骤如下:
下载并导入 TRTCDemo 的源码
下载 TRTC 开发套件,将解压包中的 wxtrtc 文件夹复制到您的项目中
在需要使用 TRTC 的页面的 json 添加“usingComponents”
"usingComponents": {
"trtc-room": "/wxtrtc/trtc-room/index",
"trtc-room-members": "/wxtrtc/trtc-room-members/index"
}
在需要使用 TRTC 的 WXML 模板中,引入 trtc-room 组件,并配置 RoomID、UserID 和 UserSig。
<trtc-room
sdkappid="{{sdkAppID}}"
roomid="{{roomID}}"
userid="{{userID}}"
usersig="{{userSig}}"
onerror="onError"
onwarning="onWarning"
onenterroom="onEnterRoom"
onleaveroom="onLeaveRoom"
onuserexit="onUserExit"
onuserenter="onUserEnter"
onuseraudioavailable="onUserAudioAvailable"
onuservideoavailable="onUserVideoAvailable"
onusermuteaudio="onUserMuteAudio"
onusermutevideo="onUserMuteVideo">
</trtc-room>
3. 功能实现
3.1 进入房间
在TRTC SDK中,用户通过输入房间号、用户名、UserSig 来加入同一房间内,进而实现双向音视频通信。当用户进入房间时,将执行onEnterRoom事件。在该事件中,我们可以调用创建本地流、发布本地流、订阅远端流等相关操作。
onEnterRoom (event) {
this.setData({
userList: event.detail.userList
})
TRTC.startLocalPreview({ frontCamera: true }, this.localVideoView).then(()=>{
TRTC.startLocalAudio()
return TRTC.enterRoom({ roomId: this.data.roomID })
}).then(()=>{
this.setData({ isEnterRoom: true })
}).catch((e)=>{
this.handleError(e)
})
}
3.2 离开房间
当用户退出房间时,将执行 onLeaveRoom 事件。在该事件中,我们可以调用停止本地音视频流、取消发布本地流、取消订阅远端流等相关操作。
onLeaveRoom () {
this.setData({ isEnterRoom: false })
TRTC.stopLocalPreview()
TRTC.stopLocalAudio()
TRTC.exitRoom()
this.setData({ userList: [] })
}
3.3 视频鉴权
在TRTC SDK中,支持对房间内指定用户进行视频鉴权,当用户加入房间后,通过对 UserID 进行鉴权,可保障数据传输的安全性。
// 鉴权
const authParamList = [
{ key: 'sdkappid', value: sdkAppID },
{ key: 'userid', value: userID },
{ key: 'usersig', value: userSig }
]
const config = TCWebSdk.instance.getConfig()
config.setAuthInfo(authParamList)
3.4 摄像头控制
TRTC SDK支持摄像头控制。用户可通过切换摄像头控制调用 SDK 同名 API 实现,前置摄像头和后置摄像头之间的切换,可通过传入frontCamera参数实现。
TRTC.switchCamera().catch((e)=>{
console.log('switchCamera failed: ', e)
})
3.5 静音控制
TRTC SDK支持设置/取消静音,用于控制本地麦克风的开/关状态。
const muted = this.data.muted
this.setData({ muted: !muted }, () => {
if (!muted) {
TRTC.muteLocalAudio()
} else {
TRTC.unmuteLocalAudio()
}
})
4. 总结
通过使用 TRTC SDK,开发者可以轻松地实现微信小程序实时音视频通话功能,提供优质的音视频通话体验。在实现的过程中,需要进行一些准备工作,并调用相应的 API,实现音视频的采集、传输和播放等操作。通过本篇文章的介绍,相信读者们对微信小程序实时音视频通话功能的集成有了更深入的了解。