基于livekit的webrtc的音视频通话，无需打洞，支持iOSAndroid

更新记录

1.0.4（2025-12-09）

1.0.3（2025-11-20）

1.0.2（2025-11-18）

查看更多

平台兼容性

uni-app(3.6.15)

uni-app x(3.6.15)

其他

基于livekit的webrtc的音视频通话，无需打洞

功能

• 音视频通话
• 切换麦克风
• 切换摄像头

快速跑通demo

• 安装livekit服务https://github.com/livekit/livekit 安装成功后，命名行执行启动服务命令，启动后会有API Key和API Secret, key和secret用于生成token时使用：

// 启动服务：
livekit-server –dev –bind 0.0.0.0

• 安装livekit命令https://github.com/livekit/livekit-cli 使用cli名称生成两个用户的token用以测试，实际项目的token由后端，后端生成token文档参考https://github.com/livekit/livekit里的Server SDKs cli生成user1和user2的token:

// 用户user1
lk token create \\
–api-key devkey –api-secret secret \\
–join –room my-first-room –identity user1 \\
–valid-for 999h

//用户user2
lk token create \\
–api-key devkey –api-secret secret \\
–join –room my-first-room –identity user2 \\
–valid-for 999h

接口

import {
UTSLiveKitRoom
} from "@/uni_modules/wrs-uts-livekit"
let room = new UTSLiveKitRoom()

• 设置回调

room.onCallback((resp) => {
// this.showMsg(JSON.stringify(resp))
let opt = resp.opt
switch (opt) {
// didConnect
case "onConnect": {
// 连接成功，成功加入房间

}
break;
case "onFailConnect": {
// 连接失败
}
break;
case "onReconnecting": {
// 重连中
}
break;
case "onReconnected": {
// 重连成功
}
break;
case "onDisconnect": {
// 断开连接
}
break;
case "onPublishLocalTrack": {

// 本地音视频推流
let kind = resp.participant.kind
switch (kind) {
// 音频Track
case 0: {

}
break;
// 视频Track
case 1: {
console.log("收到本地视频流：" + JSON.stringify(resp))
let newParams = {}
newParams.businessArray = [{
business: "showLocalView", // 设置播放地址
params: { // 业务参数
identity: resp.participant.identity,
scaleType: "fill"
}
}]

let newParamsStr = this.formatNewParams(newParams)
// android、ios
this.params = newParamsStr

}
break;
default:
break;
}
}
break;
case "onParticipantConnected": {
let participant = resp.participant
// 有人加入房间
// this.showMsg("onParticipantConnected")
}
break;
case "onParticipantDisconnected": {
let participant = resp.participant
// 有人退出房间
// this.showMsg("onParticipantDisconnected")
}
break;
case "onUpdateName": {

}
break;
case "onUpdateMetadata": {

}
break;
// 收到其他人发布的音频、视频流
case "onSubscribeRemoteTrack": {

// 其他人音视频推流
let kind = resp.publication.kind
switch (kind) {
// 音频Track
case 0: {

}
break;
// 视频Track
case 1: {
let identity = resp.participant.identity
let source = resp.publication.source
let isShareScreenVideo = false
if (source) {
switch (source) {
case 0: {
// 未知
}
break;
case 1: {
// 相机
console.log("收到相机视频流:" + JSON.stringify(resp))
}
break;
case 2: {
// MIC
}
break;
case 3: {
// 共享屏幕视频
console.log("收到共享屏幕视频流" + JSON.stringify(resp))
isShareScreenVideo = true
}
break;
case 3: {
// 共享屏幕音频
}
break;
default:
break;
}
}
switch (uni.getSystemInfoSync().platform) {
case 'android': {

let newParams = {}
newParams.businessArray = [{
business: "showRemoteView", // 设置播放地址
params: { // 业务参数
identity: identity
}
}]

this.remoteArray.push(JSON.stringify(newParams))
}
break;
case 'ios': {
if (!isShareScreenVideo) {
let newParams = {}
newParams.businessArray = [{
business: "showRemoteView", // 设置播放地址
params: { // 业务参数
identity: identity
}
}]

this.remoteArray.push(JSON.stringify(newParams))
}
}
break;
default:
break;
}

}
break;
default:
break;
}
}
break;
case "onUpdateAttributes": {

}
break;
case "onUpdateSpeakingParticipants": {
let speakers = resp.speakers
for (let index = 0; index < speakers.length; index++) {
let speaker = speakers[index]
let name = speaker.name
let isSpeaking = speaker.isSpeaking
if (isSpeaking) {
console.log(name + "在讲话")
}
}
}
break;
case "onTrackUpdateMuted": {
let participant = resp.participant
let name = participant.name
let isMicrophoneEnabled = participant.isMicrophoneEnabled
if (isMicrophoneEnabled) {
console.log(name + "打开了MIC")
} else {
console.log(name + "关闭了MIC")
}
// let isCameraEnabled = para
}
break;
default:
break;
}

})

• 初始化，调用一次就可以

room.initRoom()

• 进入连接房间

let params = {}
params.url = "ws://192.168.2.73:7880"
params.token = "xxx"
room.connect(params, (resp) => {
console.log("nvue room.connect:" + JSON.stringify(resp))
let flag = resp.flag
if(flag) {
// 先调用连接接口后才能打开摄像头
this.openCameraMic()
} else {
this.showMsg("连接失败:" + JSON.stringify(resp))
}

})

• 打开相机和麦克风，连接房间后再打开

let position = "front"
if(this.isFrontCamera) {
position = "front"
} else {
position = "back"
}
let params = {}
params.camera = {
enable: true,
position: position, // front、back
fps: 30
}
params.mic = {
enable: true
}
room.setCameraMic(params, ()=>{
if(this.isAndroid) {
this.localIdentity = new Date().getTime() + ""
}

console.log("nvue room.setCameraMic callback")
})

• 离开房间

room.disConnect(() => {

})

• 切换摄像头

room.switchCamera((resp) => {
if (resp.flag) {

} else {
this.showMsg("切换失败:" + JSON.stringify(resp))
}
})

• 开启/关闭麦克风

let params = {}
params.enabled = true // true、false
params.captureOptions = { // captureOptions仅对iOS生效
noiseSuppression: false,
highpassFilter: false
}
room.setMicrophone(params, (resp) => {
console.log(JSON.stringify(resp))
if (resp.flag) {

} else {
this.showMsg("切换失败:" + JSON.stringify(resp))
}
})

• 渲染本地视频

<wrs-uts-livekit :style="'width:'+width+'px;height:'+height+'px;'" :params="params">
</wrs-uts-livekit>

• 显示本地视频

let newParams = {}
newParams.businessArray = [{
business: "showLocalView", // 显示本地视频
params: { // 业务参数
identity: resp.participant.identity
}
}]

let newParamsStr = this.formatNewParams(newParams)
// android、ios
this.params = newParamsStr

• 显示其他人的视频画面

let newParams = {}
newParams.businessArray = [{
business: "showRemoteView", // 显示远程视频
params: { // 业务参数
identity: identity
}
}]

this.remoteArray.push(JSON.stringify(newParams))