更新记录
1.0.2(2023-08-02)
优化视频通话质量
1.0.1(2022-02-25)
修复切换摄像头的问题
1.0.0(2021-06-29)
腾讯实时音视频视频聊,语音聊
查看更多
平台兼容性
Android |
Android CPU类型 |
iOS |
适用版本区间:4.4 - 12.0 |
armeabi-v7a:支持,arm64-v8a:支持,x86:支持 |
适用版本区间:9 - 16 |
原生插件通用使用流程:
- 购买插件,选择该插件绑定的项目。
- 在HBuilderX里找到项目,在manifest的app原生插件配置中勾选模块,如需要填写参数则参考插件作者的文档添加。
- 根据插件作者的提供的文档开发代码,在代码中引用插件,调用插件功能。
- 打包自定义基座,选择插件,得到自定义基座,然后运行时选择自定义基座,进行log输出测试。
- 开发完毕后正式云打包
付费原生插件目前不支持离线打包。
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原生插件配置”->”云端插件“列表中删除该插件重新选择
TX-LiteAVSDKTRTC
简介
TX-LiteAVSDKTRTC插件致力于让开发者一键实现腾讯的推流功能,需要uni-app的开发者门阅读腾讯文档,然后根据我的文档就可以找到对应的方法,轻松实现推流逻辑
快速接入
1.请前往https://cloud.tencent.com/product/trtc申请账号
2.下载示例项目
3.使用自己的appId和appKey替换app.js中的appId和appKey
4.点击试用
5.在App原生插件配置选择试用的插件,打包自定义基座,然后体验demo(如果不会制作安卓证书参考http://www.appuploader.net/appuploader/onlinetools.php)
api说明
推流组件:TX-LiteAVSDKTRTC
函数名称 |
说明 |
enterRoom |
加入房间,具体参数见下 |
参数名 |
说明 |
appid |
腾讯平台申请的appid(整数) |
appkey |
腾讯平台申请的appsecret(字符串) |
userSig |
可以不传appkey的签名,而是直接使用服务器签名好的userSig,这个和appkey二选其一(字符串) |
roomId |
房间号(整数) |
userId |
用户id(字符串) |
role |
用户角色:20 主播 21观众(整数) |
scene |
场景说明: 0视频聊天 1直播(整数) |
callback |
加入房间后的状态回调 |
函数名称 |
参数 |
说明 |
exitRoom |
无 |
离开房间 |
函数名称 |
参数 |
说明 |
muteLocalVideo |
参数 Bool值true or false |
是否屏蔽自己的视频画面 |
函数名称 |
参数 |
说明 |
stopAllRemoteView |
参数无 |
停止显示所有远端视频画面 |
函数名称 |
参数 |
说明 |
muteRemoteVideoStream |
参数1 userId, 参数2 Bool值 true or false |
暂停接收指定的远端视频流 |
函数名称 |
参数 |
说明 |
muteAllRemoteVideoStreams |
Bool值 true or false |
停止接收所有远端视频流 |
函数名称 |
参数 |
说明 |
startLocalAudio |
无 |
开启本地音频的采集和上行 |
函数名称 |
参数 |
说明 |
stopLocalAudio |
无 |
关闭本地音频的采集和上行 |
函数名称 |
参数 |
说明 |
muteLocalAudio |
Bool值 true or false |
静音本地的音频 |
函数名称 |
参数 |
说明 |
muteRemoteAudio |
参数1 userId, 参数2 Bool值 true or false |
静音掉某一个用户的声音 |
函数名称 |
参数 |
说明 |
muteAllRemoteAudio |
Bool值 true or false |
静音掉所有用户的声音 |
函数名称 |
参数 |
说明 |
switchCamera |
无 |
切换摄像头 |
函数名称 |
参数 |
说明 |
setAudioRoute |
整型 0 扬声器 1听筒 |
设置音频路由 |
函数名称 |
参数 |
说明 |
destroySharedInstance |
无 |
销毁 TRTCCloud 单例 |
函数名称 |
参数 |
说明 |
switchRole |
20主播 21观众 |
转换角色 |
函数名称 |
参数 |
说明 |
enableAudioVolumeEvaluation |
整形,回调间隔时间 |
开启音量回调 |
函数名称 |
参数 |
说明 |
sendCustomCmdMsg |
参数一:cmd (1-10) 参数二:字符串 参数三:bool 参数四:bool 具体参考腾讯文档 |
发送消息 |
函数名称 |
参数 |
说明 |
sendSEIMsg |
参数一:字符串 参数二:发送次数 |
发送sei |
函数名称 |
参数 |
说明 |
setLocalViewRotation |
整数 |
TRTCVideoRotation_0 = 0, ///< 不旋转 TRTCVideoRotation_90 = 1, ///< 顺时针旋转90度TRTCVideoRotation_180 = 2, ///< 顺时针旋转180度TRTCVideoRotation_270 = 3, ///< 顺时针旋转270度 |
函数名称 |
参数 |
说明 |
setRemoteViewRotation |
参数一:userId字符串,参数二:整数 |
TRTCVideoRotation_0 = 0, ///< 不旋转 TRTCVideoRotation_90 = 1, ///< 顺时针旋转90度TRTCVideoRotation_180 = 2, ///< 顺时针旋转180度TRTCVideoRotation_270 = 3, ///< 顺时针旋转270度 |
函数名称 |
参数 |
说明 |
playBGM |
本地存储路径 |
播放本地存储的音乐 |
函数名称 |
参数 |
说明 |
stopBGM |
停止播放 |
停止播放本地存储的音乐 |
函数名称 |
参数 |
说明 |
pauseBGM |
无 |
暂停播放本地存储的音乐 |
函数名称 |
参数 |
说明 |
resumeBGM |
继续播放 |
继续播放本地存储的音乐 |
函数名称 |
参数 |
说明 |
playAudioEffect |
{effectId:音效id path:音效路径 loopCount:循环次数 publish:是否同步到云端} |
播放音效 |
函数名称 |
参数 |
说明 |
setAudioEffectVolume |
effectId:音效id,volumu:音效大小 |
设置音效声音大小 |
函数名称 |
参数 |
说明 |
stopAudioEffect |
effectId:音效id |
停止音效 |
函数名称 |
参数 |
说明 |
stopAllAudioEffects |
无 |
停止所有音效 |
函数名称 |
参数 |
说明 |
setAllAudioEffectsVolume |
无 |
设置所有音效的大小 |
函数名称 |
参数 |
说明 |
pauseAudioEffect |
effectId:音效id |
暂停音效 |
函数名称 |
参数 |
说明 |
resumeAudioEffect |
effectId:音效id |
继续播放音效 |
函数名称 |
参数 |
说明 |
startPlayMusic |
{path:播放网络地址(字符串), loopCount:循环次数(整数), ID:音乐id(字符串)} |
开始播放背景音乐 |
函数名称 |
参数 |
说明 |
stopPlayMusic |
{ID:音乐id(字符串)} |
停止播放背景音乐 |
函数名称 |
参数 |
说明 |
pausePlayMusic |
{ID:音乐id(字符串)} |
暂停播放背景音乐 |
函数名称 |
参数 |
说明 |
resumePlayMusic |
{ID:音乐id(字符串)} |
恢复播放背景音乐 |
函数名称 |
参数 |
说明 |
setMusicPublishVolume |
{ID:音乐id(字符串)} |
设置背景音乐的远端音量大小 |
函数名称 |
参数 |
说明 |
setMusicPlayoutVolume |
{ID:音乐id(字符串),volume:声音大小(整数)} |
设置背景音乐的本地音量大小 |
函数名称 |
参数 |
说明 |
startAudioRecording |
参数一{path:完整路径(可以不填写},参数二:回调函数} |
开始录音 |
函数名称 |
参数 |
说明 |
stopAudioRecording |
无 |
停止录音 |
函数名称 |
参数 |
说明 |
checkPermission |
int |
1:音频和视频权限 0:音频权限 |
函数名称 |
参数 |
说明 |
setLocalViewFillMode |
int |
0, ///< 图像铺满屏幕 1, ///< 图像长边填满屏幕,短边区域会被填充黑色 |
函数名称 |
参数 |
说明 |
connectOtherRoom |
字符串 |
userId和房间id,参考demo跨房pk |
函数名称 |
参数 |
说明 |
disconnectOtherRoom |
无 |
停止跨房pk |
函数名称 |
参数 |
说明 |
setDefaultStreamRecvMode |
参数1: bool类型 参数2: bool类型 |
参数1 (是否自动接收音频数据,默认值:YES)参数2(是否自动接收视频数据,默认值:YES) |
函数名称 |
参数 |
说明 |
startPublishing |
参数1:String类型 参数2: 整数 |
参数1 (streamId 自定义流 ID)参数2(0, ///< 主画面视频流 1, ///< 小画面视频流 2, ///< 辅流(屏幕分享)) |
函数名称 |
参数 |
说明 |
stopPublishing |
无 |
停止向腾讯云的直播 CDN 推流 |
函数名称 |
参数 |
说明 |
setLocalViewMirror |
整数 |
0, ///< 前置摄像头镜像,后置摄像头不镜像 1, ///< 前后置摄像头画面均镜像 2, ///< 前后置摄像头画面均不镜像 |
函数名称 |
参数 |
说明 |
setAudioCaptureVolume |
整数 |
SDK 采集音量 音量大小,100为原始音量,范围是:[0 ~ 150],默认值为100 |
函数名称 |
参数 |
说明 |
getAudioCaptureVolume |
无 |
获取 SDK 采集音量 |
函数名称 |
参数 |
说明 |
setAudioPlayoutVolume |
整数 |
SDK 播放音量 音量大小,100为原始音量,范围是:[0 ~ 150],默认值为100 |
函数名称 |
参数 |
说明 |
getAudioPlayoutVolume |
无 |
获取 SDK 播放音量 |
函数名称 |
参数 |
说明 |
setRemoteAudioVolume |
参数一:String类型 (用户id), 参数二:整型 (音量大小[0 ~ 150]) |
获取 SDK 播放音量 |
函数名称 |
参数 |
说明 |
snapshotVideo |
{type:Int 类型 userId:String类型(用户id,不传截取自己)} |
trtcCloud.snapshotVideo({type:0},result=>{}) |
函数名称 |
参数 |
说明 |
setLocalRenderParams |
{rotation:Int类型(旋转角度),fillMode:Int类型(画面填充模式),mirrorType:Int类型(镜像模式)} |
本地图像的渲染设置 |
函数名称 |
参数 |
说明 |
setRemoteRenderParams |
{fillModel:Int类型(画面填充模式) ,userId:String类型(用户id), rotation:Int类型(旋转角度),mirrorType:Int类型(镜像模式)} |
远端图像的渲染设置 |
函数名称 |
参数 |
说明 |
setVideoEncoderParam |
{videoResolution:Int类型(视频分辨率) ,videoBitrate:Int类型(目标视频码率), videoFps:Int类型(视频采集帧率),resMode:Int类型(分辨率模式)} |
设置视频编码器相关参数 |
函数名称 |
参数 |
说明 |
setVideoEncoderMirror |
bool类型,true or false |
设置编码器输出的画面镜像模式 |
函数名称 |
参数 |
说明 |
setGSensorMode |
Int整型 |
设置重力感应的适应模式,聊天模式下可以关闭重力感应,设置为0 |
例子说明:
见示例工程中的index.nvue文件