更新记录

1.0.0（2026-04-07）

安卓腾讯实时音视频UTS原生插件集成了语音通话，视频通话，视频互动直播，语音互动直播，录屏直播等功能，使用简单，方便您快速对接腾讯实时音视频，插件支持uniapp和uniapp x，支持vue2和vue3的选项式和组合式

平台兼容性

uni-app(4.0)

uni-app x(4.0)

其他

插件介绍

安卓腾讯实时音视频UTS原生插件集成了语音通话，视频通话，视频互动直播，语音互动直播，录屏直播等功能，使用简单，方便您快速对接腾讯实时音视频，插件支持uniapp和uniapp x，支持vue2和vue3的选项式和组合式

插件申请权限

1. android.permission.CAMERA
2. android.permission.WRITE_EXTERNAL_STORAGE
3. android.permission.READ_EXTERNAL_STORAGE

插件使用注意事项

• 如果您在使用插件的过程中有任何问题，可以联系作者，作者将全力协助您使用插件
• 插件文档同时提供了uniapp的用法示例和uniappx的用法示例，插件市场导入的示例项目仅为uniapp的用法示例，如果您需要uniappx的示例项目可以通过下方的链接下载示例

  uniappx用法示例

• 组件只能在nvue/uvue页面中使用，不支持vue页面

使用文档

• 您也可以参考以下链接的使用文档
• 使用说明文档

API使用方法

在需要使用插件的页面加载以下代码

import * as module from "@/uni_modules/leven-uts-trtc"

API插件方法

• 申请插件所需权限
• 检查“所有文件”访问权限
• 跳转到所有文件访问权限页面
• 初始化
• 添加监听
• 移除监听
• 进入房间
• 退出房间
• 切换角色
• 切换房间
• 请求跨房通话
• 退出跨房通话
• 设置订阅模式
• 更改跨房主播在本房间的上行能力
• 开始发布媒体流
• 更新发布媒体流
• 停止发布媒体流
• 暂停/恢复发布本地的视频流
• 设置本地画面被暂停期间的替代图片
• 暂停/恢复订阅远端用户的视频流
• 暂停/恢复订阅所有远端用户的视频流
• 设置视频编码器的编码参数
• 设置网络质量控制的相关参数
• 设置本地画面的渲染参数
• 设置远端画面的渲染模式
• 开启大小画面双路编码模式
• 切换指定远端用户的大小画面
• 视频画面截图
• 视频画面透视校正坐标设置
• 设置重力感应的适配模式
• 开启本地音频的采集和发布
• 停止本地音频的采集和发布
• 暂停/恢复发布本地的音频流
• 暂停/恢复播放远端的音频流
• 暂停/恢复播放所有远端用户的音频流
• 设置音频路由
• 设定某一个远端用户的声音播放音量
• 设定本地音频的采集音量
• 获取本地音频的采集音量
• 设定远端音频的播放音量
• 获取远端音频的播放音量
• 启用音量大小提示
• 开始录音
• 停止录音
• 开启本地媒体录制
• 停止本地媒体录制
• 设置远端音频流智能并发播放策略
• 启用 3D 音效
• 设置 3D 音效中自身坐标及朝向信息
• 设置 3D 音效中远端用户坐标信息
• 设置指定用户所发出声音的可被接收范围
• 判断当前是否为前置摄像头
• 切换摄像头
• 获取摄像头的最大缩放倍数
• 设置摄像头的缩放倍数
• 查询是否支持自动识别人脸位置
• 开启自动对焦功能
• 设置摄像头的对焦位置
• 开启/关闭闪光灯，也就是手电筒模式
• 设置摄像头的曝光参数
• 设置摄像头采集偏好
• 设置美颜（磨皮）算法
• 设置美颜级别
• 设置美白级别
• 开启清晰度增强
• 设置红润级别
• 设置色彩滤镜效果
• 设置色彩滤镜的强度
• 设置绿幕背景视频
• 设置大眼级别
• 设置瘦脸级别
• 设置 V 脸级别
• 设置下巴拉伸或收缩
• 设置短脸级别
• 设置窄脸级别
• 设置瘦鼻级别
• 设置亮眼级别
• 设置牙齿美白级别
• 设置祛皱级别
• 设置祛眼袋级别
• 设置法令纹去除级别
• 设置发际线调整级别
• 设置眼距
• 设置眼角调整级别
• 设置嘴型调整级别
• 设置鼻翼调整级别
• 设置鼻子位置
• 设置嘴唇厚度
• 设置脸型
• 选择 AI 动效挂件
• 是否在动效素材播放时静音
• 添加水印
• 开启耳返
• 设置耳返音量
• 设置人声的混响效果
• 设置人声的变声特效
• 设置语音音量
• 设置语音音调
• 设置背景音乐的事件回调接口
• 移除背景音乐的事件回调接口
• 开始播放背景音乐
• 停止播放背景音乐
• 暂停播放背景音乐
• 恢复播放背景音乐
• 设置所有背景音乐的本地音量和远端音量的大小
• 设置某一首背景音乐的远端音量的大小
• 设置某一首背景音乐的本地音量的大小
• 调整背景音乐的音调高低
• 调整背景音乐的变速效果
• 获取背景音乐的播放进度
• 获取背景音乐的总时长
• 设置背景音乐的播放进度
• 调整搓碟的变速效果
• 设置预加载事件回调
• 移除预加载事件回调
• 预加载背景音乐
• 获取背景音乐的音轨数量
• 指定背景音乐的播放音轨
• 开启系统声音采集
• 停止系统声音采集
• 启动屏幕分享
• 停止屏幕分享
• 暂停屏幕分享
• 恢复屏幕分享
• 设置屏幕分享（即辅路）的视频编码参数
• 启用/关闭视频自定义采集模式
• 启用/关闭自定义音轨
• 使用 UDP 通道发送自定义消息给房间内所有用户
• 使用 SEI 通道发送自定义消息给房间内所有用户
• 开始进行网速测试
• 停止网络测速
• 获取 SDK 版本信息
• 调用实验性接口
• 开启或关闭媒体流私有加密
• 释放资源

具体方法返回的结果可参考

• 使用说明文档

摄像头组件

在需要使用插件的页面加载以下代码

<leven-uts-live ref="refLevenUtsLive" style="flex: 1; height: 500px;" @onEventMethod="onEventMethod"></leven-uts-live>

组件用法请参考

• 使用说明文档

组件内置方法

• 开启本地摄像头的预览画面
• 更新本地摄像头的预览画面
• 停止摄像头预览
• 订阅远端用户的视频流，并绑定视频渲染控件
• 更新远端用户的视频渲染控件
• 停止订阅远端用户的视频流，并释放渲染控件
• 停止订阅所有远端用户的视频流，并释放全部渲染资源

购买说明

• 购买插件前请先试用，试用通过再购买。在试用中如果遇到任何问题，可与作者联系，将全力协助你使用本插件。