更新记录

5.6.6（2025-09-10）

• 优化一对一视频通话中的切换语音后的模糊头像背景显示。

5.6.5（2025-09-01）

• 优化IOS 端通话接听 悬浮窗 在刘海屏中的显示 顶部距离太近的问题。

5.6.4（2025-07-18）

• 修复直播视频时 不能播放背景音乐的问题，背景音乐支持 本地音频 和 网络链接音频。

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

腾讯云视频通话插件

1. 首先要到腾讯云，申请视频通话sdkAppId , 腾讯云视频通讯收费情况请注册时查看相关收费标准。

腾讯云收费介绍:https://cloud.tencent.com/product/trtc

腾讯云实时音频通话控制后台:https://console.cloud.tencent.com/trtc

2. 每个有用户名都可以通过加密计算返回用户 usersig ,计算的方法

https://cloud.tencent.com/document/product/647/17275

提示，如果发现有华为andorid 10 打包打开有白屏的情况，看下打包的时候，是不是把x86指令打包进去了，需要移除x86打包才能正常。

3. 实例化插件

const call=uni.requireNativePlugin('Html5App-TencentCall'); 

IOS 需要配置以下权限

    "ios" : {
        "privacyDescription" : {
        "NSCameraUsageDescription" : "访问摄像头才可以正常使用,允许吗?",
        "NSMicrophoneUsageDescription" : "访问麦克风才可以正常使用,允许吗?"
        },
        "UIBackgroundModes" : [ "audio" ] //允许音频在后台播放，才可以让应用进入后台时继续通话
    }

4. 调用的方法 openCall , 默认的多人视频(多人视频，最多显示6个人，在屏幕上)

call.openCall({
        "userid": "Android_trtc_02",
        "roomid": 110235,
        "usersig": "eJxlj0FPg0AYRO-8CsIVIx8LC9TEA6HQSqCo0EsvG2S3dVUWXJamjfG-q9hEEuf6XmYyH5qu60aVldd103SjUESde2boN7oBxtUf7HtOSa2II*k-yE49l4zUe8XkBG2MMQKYO5wyofieX4xQUNl9NyqpGgJoJg70lUxrv00uAIJF4HpzhR8mmMfb6G6Nm-VWDvGwZI9pjJ6b0n8IK3vcLRKwCnzI74NolVvtEK9CHocvbWTR*j1JTLNIZbnJRLH0w835LUM7y3w6tXRkXsrt6tjdziYVb9nlmgeeH7gOntEjkwPvxCQgsLGNHPiJoX1qX9AAXyY_",
        isShowBackIcon:1,
        setBeautyStyle:{"beautyStyle":1,beautyLevel:6,whitenessLevel:4,ruddinessLevel:3},
        videoFps:15,
        videoBitrate:600,
        buttons:{"float":0,"beauty":0,"videoEnable":1,"mic":1,"camera":0}
    }, ret => {

        console.log(JSON.stringify(ret));
    });

多人通话的回调数据

{"msg":"成功进入房间","code":4}

{"msg":"用户主动退出了当前视频通话","code":1}

• 有新的用户加入了当前视频房间

{"msg":"有新的用户加入了当前视频房间",
"info":{
    "userList":["iOS_trtc_03","iOS_trtc_02"],  //目前在房间通话的所有用户
    "count":2, //目前通话人数，不包括您自己
    "userid":"iOS_trtc_03"  //当前刚进入视频房间的用户id
    },
"code":5
}

• 有用户离开了当前视频房间

{"msg":"有用户离开了当前视频房间",
"info":{
 "userList":[],  //目前在房间通话的所有用户
 "count":0, //目前通话人数，不包括您自己
 "userid":"iOS_trtc_03" //当前刚退视频房间的用户id
 },
 "code":6
 }

安卓悬浮窗权限，以上有效,需要手动到应用权限中设置该应用开启悬浮窗权限，应用返回后台才会显示出来。

一对一, 视频语音通话 模式.

5. 调用的方法 openCall , 一对一通话界面

call.openCall({
    "userid":"",  //用户ID
    "roomid":"", //通话房间ID
    "usersig":"", //用户ID 密钥
    "type":2,   //1 是旧的模式，2 是新的带悬浮栏接听
    "callType": "video",  //voice 是语音通话，video 是视频通话
    "username": "英雄",
    "useravatar": "http://www.html5-app.com/uploads/avatar/f5950e65261f2aa3e846e2262b0c7690.png",
    "wait":"正在等待对方接受邀请...", 
    "prompt":"通话中...",
    "setBeautyStyle":{"beautyStyle":1,beautyLevel:6,whitenessLevel:4,ruddinessLevel:3},  //美颜等级，0~9.
    "videoFps":15, //帧率
    "videoBitrate":850, //码率
    "videoResolution":"960x540", //分辨率，1920x1080,1280x720x,960x540,640x360,640x480,480x270
    //endTime:20
    }, ret => {

});

呼起后台应用, 该方法在android 处于后台运行时有效，当应用处于后台运行时，调用该方法可以打开APP回到前台。

• 使用该方法时,需要允许,应用在台后打开, 第一次使用时,会在通知栏有提示.

• 可以用于,推送消息时,应用在后台运行时,可以被动的方式呼起应用,然后打开接听页面.

  call.openApp();

6. 关掉通话界面,

• 调用此方法可以关闭自已的通话界面，例如： 当对方拒绝接听时，可以推送一条指令给自己，再调用此方法，就可以关掉自己的通话界面。

call.close();

• 安卓端，检查是否开启了悬浮窗权限

let is=call.isFloatPermission();

• 安卓端，跳转到悬浮窗权限设置

call.openFloatSetting();

7. 参数说明

主定义美颜效果参数说明 setBeautyStyle

setBeautyStyle:{"beautyStyle":1,beautyLevel:6,whitenessLevel:4,ruddinessLevel:3}

多人视频界面底部5个按钮的显示或隐藏.buttons

buttons:{"float":0,"beauty":0,"videoEnable":0,"mic":0,"camera":0}

视频通话清晰度设置

• videoFps

  15fps或20fps，5fps以下，卡顿感明显。10fps以下，会有轻微卡顿感。20fps以上，则过于浪费（电影的帧率为24fps）。

• videoBitrate

  用来获得更好的清晰度观感, 默认是600kbps , kbps（千比特每秒），又称千比特率，指的是数字信号的传输速率, 越大清晰度越高，可能会出现网络跟不上卡顿的问题，不必设置太大.

一对一视频通话，按钮下方提示文字设置

• 表格中的# 符号是 "|"

{
cancelButtonText:"取消",
hangUpText:"挂断",
leftButtonText:"拒绝|切换到语音|静音",
rightButtonText:"接听|切换摄像头|免提"
}

// 英文语言提示，例如：
{
leftButtonText:"Reject|Switch to Voice|Mute",
rightButtonText:"Answer|Switch Camera|Speaker",
cancelButtonText:"Cancel",
hangUpText:"Hang Up"
}

一对一语音通话，按钮下方提示文字设置

{
cancelButtonText:"取消",
hangUpText:"挂断",
leftButtonText:"拒绝|静音",
rightButtonText:"接听|免提"
}

// 英文语言提示，例如：
{
leftButtonText:"Reject|Mute",
rightButtonText:"Answer|Speaker",
cancelButtonText:"Cancel",
hangUpText:"Hang Up"
}

8. 回调 ret

{"code":1,"您主动退出了当前视频通话"}

{"code":2,"sdkAppId 不能为空,如没有请到腾讯云申请"}

{"code":3,"参数不能为空"}

{"code":4,"成功进入房间"}

{"code":5,"对方已连接上当前视频通话",time:"00:00"}

{"code":6,"对方已挂断当前视频通话",time:"00:00"}

腾讯云多人聊天室说明

1. 创建房间或加入房间

        plug.joinRoom({
        "userid":"Android_trtc_02",
        "roomid":110235,
        "usersig":"eJxlj01Pg0AURff8CjJbjTw*pqBJF4Bt2oYO0VZiupkQZsDRFugwSIvxv6vYRBLf9pzce9*Hpus62kabmzTLqrZUVJ1rjvQ7HQG6-oN1LRhNFbUl*wf5qRaS0zRXXA7QxBhbAGNHMF4qkYuL4ZdMVt*JSqqMgjUSG-ZGh7bfJAfAmriu544VUQxwPXsIl0HotPmRRbPbpyohoQ1xN9k6ULwuCjWvcdT3L8TuyGFlJL7wN9FpTfAiXzHjuXls5oHc3**DHemS*OrYBgXjuziu*qXhFdPpqFKJA7*85oJju545HvTOZSOqchAsMLFp2fBzSPvUvgB1pGCH"
        },ret=>{

        }
        )

参数说明

• userid => 用户ID
• roomid => 房间ID, 数字，随便定义
• usersig => 用户加密串

用户创建房间 和 其他用户 进入房间都是同样方法，只要房间ID 相同即可， 房主以第一个进入房间的为主。

回调参数

{"code":0,"msg":"进入房间成功"} ,{"code":1,"msg":"进入房间失败"}

当有新用户加入时

{"code":101,
"msg":"有用户加入房间",
"newsUserid":"iOS_trtc_04", //当前加入的用户
"list":["Android_trtc_02","iOS_trtc_04"]   //目前在线用户数组
}

当有用户离开时

{"code":102,
"msg":"有用户离开房间", 
"outUserid":"iOS_trtc_04",  //当前离开的用户
"list":["Android_trtc_02"]   //目前在线用户数组
}

主动离开房间

{"code":1,"msg":"离开房间成功"}

被踢出房间

{"code":3,"msg":"被踢出房间"}

2. 退出房间

plug.exitRoom();

用户关闭页面时，必须调用退出房间，不如不会真正的离开房间,还占用资源。

3. 设置切换音频通道

//0=>代表扬声器,1=> 听筒

plug.setAudioRoute({route:0},ret=>
{

}); 

4. 设置聊天禁言

all=>代表禁止所有人发言,其他代表禁止单个用户ID , mute : 0=>代表禁言,1=> 开启发言

plug.muteRemoteAudio({"userid":"all",mute:0},ret=>{

_this.tip=JSON.stringify(ret); 
});

5. 设置踢出用户

踢出某个用户, userid:all 时代表踢出所有人 ,其他代表单个用户ID

    const _this=this;
    plug.removeUser({"userid":"iOS_trtc_04"},ret=>{

        _this.tip=JSON.stringify(ret); 
    });

6. 设置本地音频是否开启，

mute : 0=>代表静音,1=> 开启声音 ，

    const _this=this;
    plug.muteLocalAudio({mute:1},ret=>{

        _this.tip=JSON.stringify(ret); 
    });

8. 用户名，用户头像，房主，允许房间人数 部分，一些建议。

可以新建一个表，记录创建房间的表， 例如：

• userid => 房主用户ID

• roomid => 房间号，

• num => 允许聊天的人数，

• live => 在线人数记录

• text => 房间介绍

• time => 创建房间时间 等等

• 一些需要的信息， 在用户创建房间时，先把房间数据提交到服务器，再返回打开聊天室页面。

• 用户头像这些，可以根据在线的用户id ,到用户表中拉取图片.

• 人数限制方面， 可以在用户加入前，先访问服务器获取房间信息的在线人数，是否达标，如果没有则让他进入房间。

目前提供的自定义方法

• 自定义模式 只能在 nvue 页面中使用。liveroom 标签作为主屏，用来显示视频的view.

• radius 属性设置，是否圆角显示

  <liveroom radius="false" ref="livePusher" ></liveroom> 

• liveroom-sub 标签用来作副屏，显示小视频的view，例如视频通话中，另一方的小视频窗口.

• radius 属性设置，是否圆角显示

  <liveroom-sub radius="false"  ref="liveroomsub" ></liveroom-sub>

• 通过 ref 方式来获取标签对象。

  this.view=this.$refs.livePusher;

方法介绍

回调事件

-示例

  <liveroom  ref="livePusher" 
  @onError="onError"
  >
  </liveroom> 

可以在腾讯云后台生成一些测试帐号

腾讯云实时音频通话控制后台:https://console.cloud.tencent.com/trtc

• 示例和方法,参考示例工程中的

9 只要进入roomid 相同的房间，即可进入视频对话。

10. 服务器端用户名加密计算 usersig

https://cloud.tencent.com/document/product/647/17275