Appearance
订阅远端用户的视频流,并绑定视频渲染控件
注意
该方法回调为异步事件,请参考方法事件
调用该接口可以让 SDK 拉取指定 userId 的视频流,并渲染到参数 view 指定的渲染控件上。您可以通过 setRemoteRenderParams 设置画面的显示模式。
如果您已经知道房间中有视频流的用户的 userId,可以直接调用 startRemoteView 订阅该用户的画面。
如果您不知道房间中有哪些用户在发布视频,您可以在 enterRoom 之后等待来自 onUserVideoAvailable 的通知。
调用本接口只是启动视频流的拉取,此时画面还需要加载和缓冲,当缓冲完毕后您会收到来自 onFirstVideoFrame 的通知。
注意
注意几点规则需要您关注:
- SDK 支持同时观看某 userId 的大画面和辅路画面,或者同时观看某 userId 的小画面和辅路画面,但不支持同时观看大画面和小画面。
- 只有当指定的 userId 通过 enableEncSmallVideoStream 开启双路编码后,才能观看该用户的小画面。
- 当指定的 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)参数说明
| 参数名 | 参数类型 | 是否必填 | 默认值 | 参数描述 |
|---|---|---|---|---|
| userId | String | 否 | 无 | 指定远端用户的 ID |
| streamType | String | 否 | 无 | 指定要观看 userId 的视频流类型。 高清大画面: TRTC_VIDEO_STREAM_TYPE_BIG低清小画面: TRTC_VIDEO_STREAM_TYPE_SMALL(需要远端用户通过 enableEncSmallVideoStream 开启双路编码后才有效果)。辅流画面(常用于屏幕分享): TRTC_VIDEO_STREAM_TYPE_SUB。 |
| isOpenAnchor | Boolean | 否 | 无 | 是否打开主播视频流 |
