音视频通话

组件

组件说明

组件由多个模块组成, 主要模块包括:音频拉流组件,音视频推流组件, 媒体拉流组件,用户自定义组件。 通过集成SDK的相关控件, 让使用者进行更加快速, 高效的开发工作。开发者使用组件存在原生组件限制,请参考小程序原生组件说明

使用流程:

  1. 假如您的项目是如下结构
─ meetingDemo                 // 云会议Demo-meeting演示
   ├─ pages                      // 项目页面
   │   ├─ chat                     // 聊天页面
   │   ├─ login                    // 首页,登录页面
   │   ├─ meeting                  // 视频会议页面
   │   ├─ option                   // 选项页面
   │   └─ setting                  // 设置页面
   │
   └─ utils
      └─ RTCSDK                     // 导入SDK目录到项目中
          ├─ component
          │     ├─  RTCAudioPlayer       // 音频拉流组件(房间内所有声音由该组件输出)
          │     ├─  RTCVideoPlayer       // 媒体拉流组件(播放远端视频,屏幕共享,影音共享)
          │     ├─  RTCVideoPusher       // 视频推流组件(用于将本端的音视频推向服务端)
          │     └─  RTCScreenMarkV4      // 屏幕共享标注组件(观看屏幕共享标注功能)
          │
          └─ RTC_Miniapp_SDK.min.js  // SDK文件
  1. 在(/pages/meeting/meeting.json)中引入相关组件
// 可根据业务需求选择需要的组件
{
  "usingComponents": {
    "RTCVideoPlayer": "/utils/RTCSDK/components/RTCVideoPlayer/RTCVideoPlayer",
    "RTCVideoPusher": "/utils/RTCSDK/components/RTCVideoPusher/RTCVideoPusher",
    "RTCAudioPlayer": "/utils/RTCSDK/components/RTCAudioPlayer/RTCAudioPlayer",		
    "RTCScreenMarkV4": "/utils/RTCSDK/components/RTCScreenMarkV4/RTCScreenMarkV4",
  }
}
  1. 在wxml需要的地方添加以下代码
<!-- 音频播放组件 -->
<RTCAudioPlayer config='{{RTCAudioPlayer}}' debug='{{false}}'></RTCAudioPlayer>

<!-- 音视频推流组件 -->
<RTCVideoPusher config='{{RTCVideoPusherConfig}}' debug='{{false}}' extend='{{RTCVideoPusherExtend}}'>
    <!-- 这里是组件插槽,可显示昵称等个性化内容 -->
    <view class='nickname'>自己的昵称</view>
</RTCVideoPusher>

<!-- 视频播放组件 -->
<RTCVideoPlayer config='{{RTCVideoPlayerConfig}}' debug='{{false}}' extend='{{RTCVideoPlayerExtend}}'>
    <!-- 这里是组件插槽,可显示昵称等个性化内容 -->
    <view class='nickname'>别人的昵称</view>
</RTCVideoPlayer>
  1. 在JS中控制属性值
//以下操作需要进入房间成功后操作

//---------------------音频操作---------------------
const RTCAudioPlayerConfig = {
    soundMode: 'speaker', // 声音输出方式,有效值为 speaker(扬声器)、ear(听筒)
    autoPauseIfNavigate: false, // 当跳转到其它小程序页面时,是否自动暂停本页面的实时音视频播放
    autoPauseIfOpenNative: false, // 当跳转到其它微信原生页面时,是否自动暂停本页面的实时音视频播放
}
this.setData({ RTCAudioPlayerConfig });

//---------------------音视频推流组件---------------------
const RTCVideoPusherConfig = {
    orientation: 'vertical', // vertical,horizontal,
    aspect: '3:4', // 宽高比,可选值有 3:4, 9:16
    beauty: 5, // 美颜,取值范围 0-9 ,0 表示关闭
    whiteness: 5, // 美白,取值范围 0-9 ,0 表示关闭
    devicePosition: 'front', // 前置或后置,值为front, back,此属性不支持动态修改,如需切换摄像头请调用api
    muted: false,  // 默认静音
    enableCamera: true,  // 默认打开摄像头
    localMirror: 'auto', // 控制本地预览画面是否镜像,"auto"(默认值,前置摄像头镜像,后置摄像头不镜像)、"enable"(前后置摄像头均镜像)、"disable"(前后置摄像头均不镜像)
    remoteMirror: false, // 设置推流的画面是否镜像
    minBitrate: 100, //	最小码率
    maxBitrate: 800, // 最大码率
    waitingImage: 'http://sdk.cloudroom.com/pages/imgs/cr_meeting/be_closed.jpg', // 进入后台时推流的等待画面
}

this.setData({ RTCVideoPusherConfig }); //渲染字段

//---------------------媒体拉流组件---------------------
const RTCVideoPlayerConfig = {
    userId: "remote_userID", //假设已知对端的userID
    camId: -1, //观看的摄像头ID,-1是观看默认摄像头
    type: 'video', // 媒体类型,可取值 video,screen,media
    orientation: 'vertical', // 画面方向,可选值有 vertical,horizontal	
    objectFit: 'fillCrop', // 填充模式,可选值有 contain,fillCrop	
    autoPauseIfNavigate: true, // 当跳转到其它小程序页面时,是否自动暂停本页面的实时音视频播放
    autoPauseIfOpenNative: true, // 当跳转到其它微信原生页面时,是否自动暂停本页面的实时音视频播放
}

this.setData({ RTCVideoPlayerConfig }); //渲染字段
  1. 以上已经配置了一个简单并且可正常渲染出本端视频,房间音频以及远端视频的配置,更详细可参考下方文档说明。

音频拉流组件

<RTCAudioPlayer>

音频拉流组件集成了房间内的声音,他人视频,屏幕共享,媒体共享的声音都需要引入该组件输出

wxml属性:

属性 必填 类型 说明
config 是 object 音频配置对象,参考下方
debug 否 boolean 开启调式需要父盒子有足够大小高宽用于渲染组件
bindstatechange 否 function 监听live-player组件的statechange事件,在参数event.detail中包含播放状态
bindnetstatus 否 function 监听live-player组件的netstatus事件,在参数event.detail中包含网络状态

音频配置对象:

参数 动态改变 类型 说明
soundMode 支持 string speaker(默认),ear,扬声器输出或者听筒输出
autoPauseIfNavigate 支持 boolean 默认值false,当跳转到其它小程序页面时,是否自动暂停本页面的实时音视频播放
autoPauseIfOpenNative 支持 boolean 默认值true,当跳转到其它微信原生页面时,是否自动暂停本页面的实时音视频播放

实现动态改变推荐使用:

this.setData('RTCAudioPlayerConfig.soundMode': 'ear'); //更改声音为听筒输出

音视频推流组件

<RTCVideoPusher>

音视频推流组件是将自己的视频画面、麦克风声音上送给服务器的组件。开发者需要注意的是如果客户端关闭了麦克风、摄像头权限会通过API形式回调给业务,由业务处理

wxml属性:

属性 必填 类型 说明
config 是 object 推流配置对象,参考下方
debug 否 boolean 开启调式
bindaudiovolumenotify 否 function 监听live-pusher组件的bindaudiovolumenotify事件,返回麦克风采集的音量大小
bindstatechange 否 function 监听live-pusher组件的statechange事件,在参数event.detail中包含状态变化
bindnetstatus 否 function 监听live-pusher组件的netstatus事件,在参数event.detail中包含网络状态
binderror 否 function 监听live-pusher组件的error事件,在参数event.detail中包含渲染错误信息

推流配置对象:

参数 动态改变 类型 说明
orientation 支持 string 画面方向,可选值: "vertical"(默认)、"horizontal"
aspect 支持 string 宽高比,可选值有"3:4"(默认),"9:16"
beauty 支持 number 美颜,取值范围 0-9 ,0 表示关闭 ,默认值5
whiteness 支持 number 美白,取值范围 0-9 ,0 表示关闭 ,默认值5
devicePosition 不支持 string 初始化使用前置或后置摄像头,值为"front"(默认), "back",如需切换摄像头请调用API
minBitrate 支持 number 最小码率,100的倍数,默认值100
maxBitrate 支持 number 最大码率,100的倍数,默认值800
audioVolumeType 支持 string "media"(默认)媒体音量、"voicecall"(通话音量),此修改将影响全局的音量设置
waitingImage 支持 string 进入后台时推流的等待画面,填入完整URL或者绝对地址
localMirror 支持 string 控制本地预览画面是否镜像,可选值:"auto"(默认值,前置摄像头镜像,后置摄像头不镜像)、"enable"(前后置摄像头均镜像)、"disable"(前后置摄像头均不镜像)
remoteMirror 支持 boolean 设置推流画面是否镜像,默认值false
zIndex 支持 number 层级属性,2.9.3以上小程序基础库支持
enableCamera 不支持 boolean 打开摄像头,如需开关摄像头请调用API,默认值true
muted 不支持 boolean 是否静音,如需开关麦克风请调用API,默认值false

实现动态改变推荐使用:

this.setData('RTCVideoPusherConfig.beauty': 0); //只改变对象某一属性,关闭美颜效果
this.setData('RTCVideoPusherConfig.whiteness': 0); //只改变对象某一属性,关闭美白效果

组件方法:

snapshot(quality,returnBase64)

  • 功能: 拍照
  • 参数:
    • quality ---- 图片的质量,默认原图,基础库 2.10.0 开始支持。有效值为 raw、compressed
    • returnBase64 ---- 是否在结果中返回base64数据(boolean)
  • 返回值: Promise对象

媒体拉流组件

<RTCVideoPlayer>

媒体拉流组件是将他人视频、屏幕共享、影音共享UI显示组件,开发者需要注意原生组件限制。

wxml属性:

属性 必填 类型 说明
config 是 object 媒体拉流配置对象,参考下方
debug 否 boolean 开启调式
bindstatechange 否 function 监听live-player组件的statechange事件,在参数event.detail中包含userId、type及播放状态
bindnetstatus 否 function 监听live-player组件的netstatus事件,在参数event.detail中包含userId、type及网络状态
userInfo 否 object 已废弃,可在config中传入userId

媒体拉流配置对象:

参数 动态改变 类型 说明
type 支持 string 媒体类型,可取值 "video"(默认),"screen","media"
userId 支持 string 观看用户的userId
camId 支持 number 观看用户的某个摄像头。默认值-1,观看用户的默认摄像头。媒体类型为 "video" 时有效。
orientation 支持 string 画面方向,可选值: "vertical"(默认)、"horizontal"
objectFit 支持 string 填充模式,可选值有 "fillCrop"(默认)、"contain"
autoPauseIfNavigate 支持 boolean 当跳转到其它小程序页面时,是否自动暂停本页面的实时音视频播放,默认值false
autoPauseIfOpenNative 支持 boolean 当跳转到其它微信原生页面时,是否自动暂停本页面的实时音视频播放,默认值true
zIndex 支持 number 层级属性,2.9.3以上小程序基础库支持

组件方法:

snapshot(quality,returnBase64)

  • 功能: 拍照
  • 参数:
    • quality ---- 图片的质量,默认原图,基础库 2.10.0 开始支持。有效值为 raw、compressed
    • returnBase64 ---- 是否在结果中返回base64数据(boolean)
  • 返回值: Promise对象

屏幕共享标注组件

<RTCScreenMarkV4>

屏幕共享标注组件需要房间内已开启了屏幕共享并且源端开启了屏幕共享标注才会正常工作的组件,用于观看其他端的画笔标注
开发者需要注意以下事项:

  1. 当前组件仅支持观看其他端绘制画笔。
  2. 由于覆盖在原生组件之上,请您务必阅读小程序原生组件说明
  3. 部分机型首次渲染画笔慢是小程序提供的截图能力缓慢,并不是SDK造成的。

wxml属性:

属性 必填 类型 说明
config 是 object 与RTCVideoPlayer组件的config属性保持一致