Skip to content

订阅远端用户的视频流,并绑定视频渲染控件

注意

该方法回调为异步事件,请参考方法事件

调用该接口可以让 SDK 拉取指定 userId 的视频流,并渲染到参数 view 指定的渲染控件上。您可以通过 setRemoteRenderParams 设置画面的显示模式。

如果您已经知道房间中有视频流的用户的 userId,可以直接调用 startRemoteView 订阅该用户的画面。

如果您不知道房间中有哪些用户在发布视频,您可以在 enterRoom 之后等待来自 onUserVideoAvailable 的通知。

调用本接口只是启动视频流的拉取,此时画面还需要加载和缓冲,当缓冲完毕后您会收到来自 onFirstVideoFrame 的通知。

注意

注意几点规则需要您关注:

  1. SDK 支持同时观看某 userId 的大画面和辅路画面,或者同时观看某 userId 的小画面和辅路画面,但不支持同时观看大画面和小画面。
  2. 只有当指定的 userId 通过 enableEncSmallVideoStream 开启双路编码后,才能观看该用户的小画面。
  3. 当指定的 userId 的小画面不存在时,SDK 默认切换到该用户的大画面。

方法名

startRemoteView

用法

js
//订阅远端用户的视频流,并绑定视频渲染控件
this.$refs.refLevenUtsLive.startRemoteView({
  userId: userId,
  streamType: "TRTC_VIDEO_STREAM_TYPE_BIG"
})
js
//订阅远端用户的视频流,并绑定视频渲染控件
let startRemoteViewParams = JSONObject.parse(JSON.stringify({
  userId: uid,
  streamType: "TRTC_VIDEO_STREAM_TYPE_BIG"
})) as JSONObject
refLevenUtsLive.value?.startRemoteView(startRemoteViewParams)

参数说明

参数名参数类型是否必填默认值参数描述
userIdString指定远端用户的 ID
streamTypeString指定要观看 userId 的视频流类型。
高清大画面:TRTC_VIDEO_STREAM_TYPE_BIG
低清小画面:TRTC_VIDEO_STREAM_TYPE_SMALL(需要远端用户通过 enableEncSmallVideoStream 开启双路编码后才有效果)。
辅流画面(常用于屏幕分享):TRTC_VIDEO_STREAM_TYPE_SUB
isOpenAnchorBoolean是否打开主播视频流