远端用户资源
用户进入音视频房间后,如果想让其他人看见自己的画面、听见自己的声音,需要发布(Publish)本地资源。如果想要看到别人的画面、听见别人的声音,需要订阅(Subscribe)其他人已发布的资源。
订阅
用户的订阅需要在收到远端用户发布资源的通知,即 setOnRemotePublishedListener
收到回调后订阅。可调用 RCRTCEngine
中的 subscribe
来订阅某个远端用户的音视频资源,如果远端用户发布的视频资源开启了大小流功能,可以通过 subscribe
的 tiny
参数,来选择订阅大流或小流。
方法
JavaScript
rtcEngine.subscribe(userId, type, tiny);
参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
userId | String | 是 | 远端用户 ID |
type | RCRTCMediaType | 是 | 资源类型 |
tiny | Boolean | 否 | 是否订阅小流,默认 false |
示例代码
JavaScript
// 订阅音视频资源
rtcEngine.subscribe(userId, RCRTCMediaType.AudioVideo);
console.log('订阅音视频资源');
// 订阅音频资源
rtcEngine.subscribe(userId, RCRTCMediaType.Audio);
console.log('订阅音频资源');
// 订阅视频小流
rtcEngine.subscribe(userId, RCRTCMediaType.Video, true);
console.log('订阅视频小流');
// 订阅视频大流
rtcEngine.subscribe(userId, RCRTCMediaType.Video, false);
console.log('订阅视频大流');
取消订阅
当需要取消订阅时,可调用 RCRTCEngine
中的 unsubscribe
来取消订阅某个远端用户的音视频资源。取消订阅接口通常跟订阅接口配对使用,但如果是用户想要退出房间,则不需要调用取消订阅方法,在调用退出房间接口时,SDK 内部会自动进行取消处理。
方法
JavaScript
rtcEngine.unsubscribe(userId, type);
参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
userId | String | 是 | 远端用户 ID |
type | RCRTCMediaType | 是 | 资源类型 |
示例代码
JavaScript
// 取消订阅音视频资源
rtcEngine.unsubscribe(userId, RCRTCMediaType.AudioVideo);
console.log('取消订阅音视频资源');
// 取消订阅音频资源
rtcEngine.unsubscribe(userId, RCRTCMediaType.Audio);
console.log('取消订阅音频资源');
// 取消订阅视频资源
rtcEngine.unsubscribe(userId, RCRTCMediaType.Video);
console.log('取消订阅视频资源');