发布和订阅
muteAllRemoteAudioStreams
取消或恢复订阅所有远端用户的音频流。
public abstract muteAllRemoteAudioStreams(muted: boolean): number;
成功调用该方法后,本地用户会取消或恢复订阅所有远端用户的音频流,包括在调用该方法后加入频道的用户的音频流。
SDK 默认在加入频道时订阅所有远端用户的音频流,如果要修改此行为,可以在调用 joinChannelWithOptions 加入频道时设置 autoSubscribeAudio 为 false
,即可在加入频道时取消订阅所有用户的音频流。
调用时机
该方法需要在加入频道后调用。
调用限制
如果在调用该方法之后又调用了 enableAudio 或 disableAudio,则后调用的方法会生效。
参数
- muted
- 是否取消订阅所有远端用户的音频流:
true
: 取消订阅所有远端用户的音频流。false
:(默认)订阅所有远端用户的音频流。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
muteAllRemoteAudioStreamsEx
取消或恢复订阅所有远端用户的音频流。
public abstract muteAllRemoteAudioStreamsEx(muted:boolean,connection:RtcConnection):number;
详情
成功调用该方法后,本地用户会取消或恢复订阅远端用户的音频流,包括在调用该方法后加入频道的用户的音频流。
- 该方法需要在加入频道后调用。
- 如果需要在加入频道前设置默认不订阅远端用户音频流,可以在调用 joinChannelWithOptions 加入频道时设置 autoSubscribeAudio 为
false
。
参数
- muted
- 是否取消订阅所有远端用户的音频流:
true
: 取消订阅所有远端用户的音频流。false
:(默认)订阅所有远端用户的音频流。
- connection
- Connection 信息。详见 RtcConnection。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
muteAllRemoteVideoStreams
取消或恢复订阅所有远端用户的视频流。
public abstract muteAllRemoteVideoStreams(muted: boolean): number;
成功调用该方法后,本地用户会取消或恢复订阅所有远端用户的视频流,包括在调用该方法后加入频道的用户的视频流。
SDK 默认在加入频道时订阅所有远端用户的视频流,如果要修改此行为,可以在调用 joinChannelWithOptions 加入频道时设置 autoSubscribeVideo 为 false
,即可在加入频道时取消订阅所有用户的视频流。
调用时机
该方法需要在加入频道后调用。
调用限制
如果在调用该方法之后又调用了 enableVideo 或 disableVideo,则后调用的方法会生效。
参数
- muted
- 是否取消订阅所有远端用户的视频流。
true
: 取消订阅所有用户的视频流。false
:(默认)订阅所有用户的视频流。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
muteAllRemoteVideoStreamsEx
取消或恢复订阅所有远端用户的视频流。
public abstract muteAllRemoteVideoStreamsEx(muted:boolean,connection:RtcConnection):number;
详情
成功调用该方法后,本地用户会取消或恢复订阅所有远端用户的视频流,包括在调用该方法后加入频道的用户的视频流。
参数
- muted
- 是否取消订阅所有远端用户的视频流。
true
: 取消订阅所有用户的视频流。false
:(默认)订阅所有用户的视频流。
- connection
- Connection 信息。详见 RtcConnection。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
muteLocalAudioStream
取消或恢复发布本地音频流。
public abstract muteLocalAudioStream(muted: boolean): number;
该方法用于控制是否发布本地采集的音频流。如果不发布本地采集的音频流,也不会禁用音频采集设备,所以不影响音频的采集状态。
调用时机
加入频道前后均可调用。
调用限制
无。
相关回调
成功调用该方法后,本地会触发 onAudioPublishStateChanged 回调;远端会触发 onUserMuteAudio 回调和 onRemoteAudioStateChanged 回调。
参数
- muted
- 是否取消发布本地音频流。
true
: 取消发布。false
:(默认)发布。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
muteLocalAudioStreamEx
取消或恢复发布本地音频流。
public abstract muteLocalAudioStreamEx(muted:boolean,connection:RtcConnection):number;
详情
成功调用该方法后,远端会触发 onUserMuteAudio 回调和 onRemoteAudioStateChanged 回调。
参数
- muted
- 是否取消发布本地音频流。
true
: 取消发布。false
:(默认)发布。
- connection
- Connection 信息。详见 RtcConnection。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
muteLocalVideoStream
取消或恢复发布本地视频流。
public abstract muteLocalVideoStream(muted: boolean): number;
该方法用于控制是否发布本地采集的视频流。如果不发布本地采集的视频流,也不会禁用视频采集设备,所以不影响视频的采集状态。
相比于调用 enableLocalVideo(false
) 关闭本地视频流采集、从而取消发布本地视频流的方法,该方法响应速度更快。
调用时机
加入频道前后均可调用。
调用限制
无。
相关回调
成功调用该方法后,本地会触发 onVideoPublishStateChanged 回调;远端会触发 onUserMuteVideo 回调和 onRemoteVideoStateChanged 回调。
参数
- muted
- 是否取消发送本地视频流。
true
: 取消发送本地视频流。false
: (默认)发送本地视频流。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
muteLocalVideoStreamEx
取消或恢复发布本地视频流。
public abstract muteLocalVideoStreamEx(muted:boolean,connection:RtcConnection):number;
详情
成功调用该方法后,远端会触发 onUserMuteVideo 回调。
- 该方法不影响视频采集状态,没有禁用摄像头。
参数
- muted
- 是否取消发送本地视频流。
true
: 取消发送本地视频流。false
: (默认)发送本地视频流。
- connection
- Connection 信息。详见 RtcConnection。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
muteRemoteAudioStream
取消或恢复订阅指定远端用户的音频流。
public abstract muteRemoteAudioStream(uid: number, muted: boolean): number;
调用时机
该方法需要在加入频道后调用。
调用限制
无。
相关回调
成功调用该方法后,本地会触发 onAudioSubscribeStateChanged 回调。
参数
- uid
- 指定用户的用户 ID。
- muted
- 是否取消订阅指定远端用户的音频流。
true
: 取消订阅指定用户的音频流。false
:(默认)订阅指定用户的音频流。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
muteRemoteAudioStreamEx
停止/恢复接收指定的音频流。
public abstract muteRemoteAudioStreamEx(uid:number,muted:boolean,connection:RtcConnection):number;
详情
参数
- uid
- 指定用户的 ID。
- muted
是否停止接收指定音频流:
true
: 停止接收指定音频流。false
:(默认)继续接收指定音频流。
- connection
- Connection 信息。详见 RtcConnection。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。
muteRemoteVideoStream
取消或恢复订阅指定远端用户的视频流。
public abstract muteRemoteVideoStream(uid: number, muted: boolean): number;
调用时机
该方法需要在加入频道后调用。
调用限制
无。
相关回调
成功调用该方法后,本地会触发 onVideoSubscribeStateChanged 回调。
参数
- uid
- 指定用户的用户 ID。
- muted
- 是否取消订阅指定远端用户的视频流。
true
: 取消订阅指定用户的视频流。false
: (默认)订阅指定用户的视频流。
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
muteRemoteVideoStreamEx
停止/恢复接收指定的视频流。
public abstract muteRemoteVideoStreamEx(uid:number,muted:boolean,connection:RtcConnection):number;
详情
该方法停止/恢复接收某一个指定远端用户的视频流。在加入频道前或后都可以调用。该方法的设置在离开频道后失效。
参数
- uid
远端用户的 ID。
- muted
- 是否停止接收某个远端用户的视频:
true
: 停止接收。false
: (默认)恢复接收。
- connection
- Connection 信息。详见 RtcConnection。
返回值
- 0:方法调用成功。
- < 0:方法调用失败。详见错误码了解详情和解决建议。
onAudioPublishStateChanged
音频发布状态改变回调。
onAudioPublishStateChanged?:(channel:string, oldState:Constants.StreamPublishState, newState:Constants.StreamPublishState, elapseSinceLastState:number) => void;
参数
- channel
- 频道名。
- oldState
- 之前的发布状态,详见 StreamPublishState。
- newState
- 当前的发布状态,详见 StreamPublishState。
- elapseSinceLastState
- 两次状态变化时间间隔(毫秒)。
onAudioSubscribeStateChanged
音频订阅状态发生改变回调。
onAudioSubscribeStateChanged?:(channel:string,uid:number,oldState:Constants.StreamSubscribeState,newState:Constants.StreamSubscribeState,elapseSinceLastState:number) =>void;
参数
- channel
- 频道名。
- uid
- 远端用户的 ID。
- oldState
- 之前的订阅状态,详见 StreamSubscribeState。
- newState
- 当前的订阅状态,详见 StreamSubscribeState。
- elapseSinceLastState
- 两次状态变化时间间隔(毫秒)。
onVideoSubscribeStateChanged
视频订阅状态发生改变回调。
onVideoSubscribeStateChanged?:(channel:string,uid:number,oldState:Constants.StreamSubscribeState,newState:Constants.StreamSubscribeState,elapseSinceLastState:number) =>void;
参数
- channel
- 频道名。
- uid
- 远端用户的 ID。
- oldState
- 之前的订阅状态,详见 StreamSubscribeState。
- newState
- 当前的订阅状态,详见 StreamSubscribeState。
- elapseSinceLastState
- 两次状态变化时间间隔(毫秒)。