跳到主要内容

远端用户资源

用户进入音视频房间后,如果想让其他人看见自己的画面、听见自己的声音,需要发布(Publish)本地资源。如果想要看到别人的画面、听见别人的声音,需要订阅(Subscribe)其他人已发布的资源。

订阅

用户的订阅需要在收到远端用户发布资源的通知,即 setOnRemotePublishedListener 收到回调后订阅。可调用 RCRTCEngine 中的 subscribe 来订阅某个远端用户的音视频资源,如果远端用户发布的视频资源开启了大小流功能,可以通过 subscribetiny 参数,来选择订阅大流或小流。

方法

JavaScript
rtcEngine.subscribe(userId, type, tiny);

参数说明

参数类型必填说明
userIdString远端用户 ID
typeRCRTCMediaType资源类型
tinyBoolean是否订阅小流,默认 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);

参数说明

参数类型必填说明
userIdString远端用户 ID
typeRCRTCMediaType资源类型

示例代码

JavaScript
// 取消订阅音视频资源
rtcEngine.unsubscribe(userId, RCRTCMediaType.AudioVideo);
console.log('取消订阅音视频资源');

// 取消订阅音频资源
rtcEngine.unsubscribe(userId, RCRTCMediaType.Audio);
console.log('取消订阅音频资源');

// 取消订阅视频资源
rtcEngine.unsubscribe(userId, RCRTCMediaType.Video);
console.log('取消订阅视频资源');