Skip to content

设置远端画面的渲染模式

说明

可设置的参数包括有:画面的旋转角度、填充模式以及左右镜像等

方法名

setRemoteRenderParams

用法

  • 用法如下:
js
module.setRemoteRenderParams({
  params:{
  },
  //成功执行的函数
  success: (res) => {
    let data = res.data;
    console.log(data)
  },
  //失败执行的函数
  fail: (res) => {
    console.log(res)
  },
  //接口调用完成返回函数,不管成功还是失败都会返回
  complete: (res) => {
    // console.log(res)
  }
})
js
module.setRemoteRenderParams({
  params:{
  },
  //成功执行的函数
  success: (res) => {
    const data = res.data;
    console.log(data)
  },
  //失败执行的函数
  fail: (res) => {
    console.log(res)
  },
  //接口调用完成返回函数,不管成功还是失败都会返回
  // complete: (res) => {
  //   console.log(res)
  // }
} as LevenOptions)
  • 参数说明
    参数名参数类型是否必填默认值参数描述
    paramsObject参数配置
    params.userIdString指定远端用户的 ID
    params.streamTypeString可以设置为主路画面(TRTC_VIDEO_STREAM_TYPE_BIG)或辅路画面(TRTC_VIDEO_STREAM_TYPE_SUB)可选值请参考【视频流类型
    params.fillModeString画面填充模式,可选值请参考【画面填充模式类型
    params.mirrorTypeString画面镜像模式,可选值请参考【画面镜像模式类型
    params.rotationString图像的顺时针旋转角度,支持 90、180 以及 270 旋转角度,默认值:TRTC_VIDEO_ROTATION_0,可选值请参考【图像的顺时针旋转角度类型
    successFunction执行成功的函数
    failFunction执行失败的函数
    completeFunction执行完成的函数,不管成功还是失败都会执行

画面填充模式类型

名称参数描述
TRTC_VIDEO_RENDER_MODE_FILL填充模式:即将画面内容居中等比缩放以充满整个显示区域,超出显示区域的部分将会被裁剪掉,此模式下画面可能不完整
TRTC_VIDEO_RENDER_MODE_FIT适应模式:即按画面长边进行缩放以适应显示区域,短边部分会被填充为黑色,此模式下图像完整但可能留有黑边
TRTC_VIDEO_RENDER_MODE_SCALE_FILL缩放填充模式:即无论画面的宽高比,都会被拉伸或压缩以完全填充显示区域,此模式下画面宽高比可能会被改变,导致渲染画面变形

画面镜像模式类型

名称参数描述
TRTC_VIDEO_MIRROR_TYPE_AUTO自动模式:如果正使用前置摄像头则开启镜像,如果是后置摄像头则不开启镜像
TRTC_VIDEO_MIRROR_TYPE_ENABLE强制开启镜像,不论当前使用的是前置摄像头还是后置摄像头
TRTC_VIDEO_MIRROR_TYPE_DISABLE强制关闭镜像,不论当前使用的是前置摄像头还是后置摄像头

图像的顺时针旋转角度类型

名称参数描述
TRTC_VIDEO_ROTATION_0不旋转
TRTC_VIDEO_ROTATION_90顺时针旋转90度
TRTC_VIDEO_ROTATION_180顺时针旋转180度
TRTC_VIDEO_ROTATION_270顺时针旋转270度

视频流类型

名称参数描述
TRTC_VIDEO_STREAM_TYPE_BIG高清大画面,一般用来传输摄像头的视频数据
TRTC_VIDEO_STREAM_TYPE_SMALL低清小画面:小画面和大画面的内容相互,但是分辨率和码率都比大画面低,因此清晰度也更低。
TRTC_VIDEO_STREAM_TYPE_SUB辅流画面,一般用于屏幕分享,同一时间在同一个房间中只允许一个用户发布辅流视频,其他用户必须要等该用户关闭之后才能发布自己的辅流。

回调

  • 示例
json
{
"data": { },
"message": "",
"code": 0
}
  • 回调说明:
    参数名参数类型参数描述
    messageString消息提示
    dataObject数据对象
    codeInteger返回类型,0.成功,其他:失败