# 发布和订阅 (/zh-CN/api-reference/rtc/macos/publishnsubscribe)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
## enableDualStreamMode: [#enabledualstreammode]
在发送端启用或关闭不同质量层级的视频流模式。
```objc
- (int)enableDualStreamMode:(BOOL)enabled NS_SWIFT_NAME(enableDualStreamMode(_:)) __deprecated_msg("use setDualStreamMode: instead.");
```
:::error[废弃]
自 v4.2.0 版本废弃,请改用 `setDualStreamMode`。
:::
不同质量层级的视频流是一对视频大流和视频小流的组合:
- 视频大流:高码率,高分辨率。
- 视频小流:低码率,低分辨率。
启用该模式后,你可以调用 [setRemoteVideoStream\:type:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setremotevideostreamtype) 方法,在接收端选择接收高质量或低质量的视频流。
:::note
注:
- 该方法适用于发送端的所有类型的视频流,包括但不限于摄像头采集的视频流、屏幕共享流和自定义采集的视频流。
- 如果你需要在多频道场景中启用不同质量层级的视频流,可以调用 [enableDualStreamModeEx\:streamConfig\:connection:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengineex_enabledualstreammodeex) 方法。
- 你可以在加入频道前或加入频道后调用该方法。
:::
### 参数 [#参数]
是否启用不同质量层级的视频流模式:
- YES:启用不同质量层级的视频流模式。
- NO:(默认)关闭不同质量层级的视频流模式。
### 返回值 [#返回值]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## enableDualStreamMode\:streamConfig: [#enabledualstreammodestreamconfig]
设置发送端的不同质量层级的视频流模式及视频小流配置。
```objc
- (int)enableDualStreamMode:(BOOL)enabled
streamConfig:(AgoraSimulcastStreamConfig* _Nonnull)streamConfig NS_SWIFT_NAME(enableDualStreamMode(_:streamConfig:)) __deprecated_msg("use setDualStreamMode: instead.");
```
:::error[废弃]
自 v4.2.0 版本废弃,请改用 `setDualStreamMode`。
:::
你可以调用该方法在发送端启用或关闭不同质量层级的视频流(dual-stream)模式。不同质量层级的视频流包括一对视频大流和视频小流:
- 视频大流:高码率,高分辨率。
- 视频小流:低码率,低分辨率。
启用该模式后,你可以调用 `setRemoteVideoStream` 方法,在接收端选择接收高质量或低质量的视频流。
:::note
注:
- 该方法适用于发送端的所有类型的视频流,包括但不限于摄像头采集的视频流、屏幕共享流和自定义采集的视频流。
- 如果你需要在多频道场景中启用不同质量层级的视频流,可以调用 `enableDualStreamModeEx` 方法。
- 你可以在加入频道前或加入频道后调用该方法。
:::
### 参数 [#参数-1]
是否启用不同质量层级的视频流模式:
- YES:启用不同质量层级的视频流模式。
- NO:(默认)关闭不同质量层级的视频流模式。
视频小流的配置。详见 [AgoraSimulcastStreamConfig](/zh-CN/api-reference/rtc/macos/class-simulcaststreamconfig)。注意:当 `mode` 设置为 `AgoraDisableSimulcastStream` 时,`streamConfig` 的设置不生效。
### 返回值 [#返回值-1]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-1]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## enableDualStreamModeEx\:streamConfig\:connection: [#enabledualstreammodeexstreamconfigconnection]
在发送端启用或关闭不同质量层级的视频流。
```objc
- (int)enableDualStreamModeEx:(BOOL)enabled
streamConfig:(AgoraSimulcastStreamConfig*)streamConfig
connection:(AgoraRtcConnection* _Nonnull)connection NS_SWIFT_NAME(enableDualStreamModeEx(_:streamConfig:connection:)) __deprecated_msg("use setDualStreamModeEx: instead.");
```
:::error[废弃]
自 v4.2.0 版本废弃,请改用 `setDualStreamModeEx`。
:::
你可以调用此方法在发布端启用或关闭不同质量层级的视频流。不同质量层级的视频流由一对视频大流和视频小流组成:
- 视频大流:高码率,高分辨率。
- 视频小流:低码率,低分辨率。
启用不同质量层级的视频流后,你可以调用 `setRemoteVideoStream` 方法,在订阅端选择接收高质量或低质量的视频流。
:::note
注: 该方法适用于发送端的所有类型的视频流,包括但不限于摄像头采集的视频流、屏幕共享流和自定义采集的视频流。
:::
### 适用场景 [#适用场景]
该方法适用于多频道场景。
### 参数 [#参数-2]
是否启用不同质量层级的视频流:
- YES:启用不同质量层级的视频流。
- NO(默认):关闭不同质量层级的视频流。
视频小流的配置,详见 [AgoraSimulcastStreamConfig](/zh-CN/api-reference/rtc/macos/class-simulcaststreamconfig)。
:::note
注: 当 `mode` 设置为 `AgoraDisableSimulcastStream` 时,设置 `streamConfig` 无效。
:::
连接信息,详见 [AgoraRtcConnection](/zh-CN/api-reference/rtc/macos/class-rtcconnection)。
### 返回值 [#返回值-2]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-2]
- [AgoraRtcEngineKit(Ex)](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineex)
## muteAllRemoteAudioStreams: [#muteallremoteaudiostreams]
停止或恢复订阅所有远端用户的音频流。
```objc
- (int)muteAllRemoteAudioStreams:(BOOL)mute NS_SWIFT_NAME(muteAllRemoteAudioStreams(_:));
```
调用该方法后,你将停止或恢复订阅所有远端用户的音频流,包括之后加入频道的用户。
:::note
注: [muteAllRemoteAudioStreams:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_muteallremoteaudiostreams) 方法调用后,如果你调用了 [enableAudio](/zh-CN/api-reference/rtc/macos/audio/audio-basic#api_irtcengine_enableaudio) 或 [disableAudio](/zh-CN/api-reference/rtc/macos/audio/audio-basic#api_irtcengine_disableaudio),以最后一次调用为准。默认情况下,加入频道时 SDK 会自动订阅所有远端用户的音频流。你可以在调用 `joinChannelByToken` 加入频道时将 [AgoraRtcChannelMediaOptions](/zh-CN/api-reference/rtc/macos/class-channelmediaoptions) 中的 `autoSubscribeAudio` 设置为 NO,以取消加入频道时对所有用户音频流的订阅。
:::
### 调用时机 [#调用时机]
该方法需要在加入频道后调用。
### 参数 [#参数-3]
是否停止订阅所有远端用户的音频流:
- YES:停止订阅所有远端用户的音频流。
- NO:(默认)订阅所有远端用户的音频流。
### 返回值 [#返回值-3]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-3]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## muteAllRemoteAudioStreamsEx\:connection: [#muteallremoteaudiostreamsexconnection]
停止或恢复订阅所有远端用户的音频流。
```objc
- (int)muteAllRemoteAudioStreamsEx:(BOOL)mute
connection:(AgoraRtcConnection * _Nonnull)connection NS_SWIFT_NAME(muteAllRemoteAudioStreamsEx(_:connection:));
```
调用该方法后,你将停止或恢复订阅所有远端用户的音频流,包括在调用该方法后加入频道的用户。
:::note
注:
- 请在加入频道后调用该方法。
- 如果你希望在加入频道前不订阅远端用户的音频流,可以在调用 `joinChannelByToken` 时将 [AgoraRtcChannelMediaOptions](/zh-CN/api-reference/rtc/macos/class-channelmediaoptions) 中的 `autoSubscribeAudio` 设置为 NO。
:::
### 适用场景 [#适用场景-1]
该方法适用于多频道场景。
### 参数 [#参数-4]
是否停止订阅所有远端用户的音频流:
- YES:停止订阅所有远端用户的音频流。
- NO:(默认)订阅所有远端用户的音频流。
连接信息。详见 [AgoraRtcConnection](/zh-CN/api-reference/rtc/macos/class-rtcconnection)。
### 返回值 [#返回值-4]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-4]
- [AgoraRtcEngineKit(Ex)](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineex)
## muteAllRemoteVideoStreams: [#muteallremotevideostreams]
停止或恢复订阅所有远端用户的视频流。
```objc
- (int)muteAllRemoteVideoStreams:(BOOL)mute NS_SWIFT_NAME(muteAllRemoteVideoStreams(_:));
```
调用该方法后,你会停止或恢复订阅所有远端用户的视频流,包括后续加入频道的用户。
:::note
注: 如果你调用了该方法后又调用了 [enableVideo](/zh-CN/api-reference/rtc/macos/video/video-basic#api_irtcengine_enablevideo) 或 [disableVideo](/zh-CN/api-reference/rtc/macos/video/video-basic#api_irtcengine_disablevideo),以最后一次调用为准。默认情况下,加入频道时 SDK 会自动订阅所有远端用户的视频流。你可以在调用 `joinChannelByToken` 加入频道时将 [AgoraRtcChannelMediaOptions](/zh-CN/api-reference/rtc/macos/class-channelmediaoptions) 中的 `autoSubscribeVideo` 设置为 NO,以取消加入频道时对所有用户的视频流的订阅。
:::
### 调用时机 [#调用时机-1]
请在加入频道后调用该方法。
### 参数 [#参数-5]
是否停止订阅所有远端用户的视频流。
- YES:停止订阅所有远端用户的视频流。
- NO:(默认)订阅所有远端用户的视频流。
### 返回值 [#返回值-5]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-5]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## muteAllRemoteVideoStreamsEx\:connection: [#muteallremotevideostreamsexconnection]
停止或恢复订阅所有远端用户的视频流。
```objc
- (int)muteAllRemoteVideoStreamsEx:(BOOL)mute
connection:(AgoraRtcConnection * _Nonnull)connection NS_SWIFT_NAME(muteAllRemoteVideoStreamsEx(_:connection:));
```
调用该方法后,会停止或恢复订阅所有远端用户的视频流,包括之后加入频道的所有远端用户。
### 适用场景 [#适用场景-2]
该方法适用于多频道场景。
### 参数 [#参数-6]
是否停止订阅所有远端用户的视频流。
- YES:停止订阅所有远端用户的视频流。
- NO:(默认)订阅所有远端用户的视频流。
连接信息。详见 [AgoraRtcConnection](/zh-CN/api-reference/rtc/macos/class-rtcconnection)。
### 返回值 [#返回值-6]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-6]
- [AgoraRtcEngineKit(Ex)](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineex)
## muteLocalAudioStream: [#mutelocalaudiostream]
停止或恢复发布本地音频流。
```objc
- (int)muteLocalAudioStream:(BOOL)mute NS_SWIFT_NAME(muteLocalAudioStream(_:));
```
该方法用于控制是否发布本地采集的音频流。如果你调用该方法停止发布音频流,音频采集设备仍会正常工作,不受影响。
### 调用时机 [#调用时机-2]
该方法可以在加入频道前或加入频道后调用。
### 相关回调 [#相关回调]
调用该方法成功后,本地会触发回调 [rtcEngine\:didAudioPublishStateChange\:oldState\:newState\:elapseSinceLastState:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#callback_irtcengineeventhandler_onaudiopublishstatechanged);远端会触发回调 [rtcEngine\:didAudioMuted\:byUid:](/zh-CN/api-reference/rtc/macos/audio/audio-basic#callback_irtcengineeventhandler_onusermuteaudio) 和 [rtcEngine\:remoteAudioStateChangedOfUid\:state\:reason\:elapsed:](/zh-CN/api-reference/rtc/macos/audio/audio-basic#callback_irtcengineeventhandler_onremoteaudiostatechanged)。
### 参数 [#参数-7]
是否停止发布本地音频流:
- YES:停止发布本地音频流。
- NO:(默认)恢复发布本地音频流。
### 返回值 [#返回值-7]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-7]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## muteLocalAudioStreamEx\:connection: [#mutelocalaudiostreamexconnection]
停止或恢复发布本地音频流。
```objc
- (int)muteLocalAudioStreamEx:(BOOL)mute connection:(AgoraRtcConnection * _Nonnull)connection NS_SWIFT_NAME(muteLocalAudioStreamEx(_:connection:));
```
成功调用该方法后,远端会触发 [rtcEngine\:didAudioMuted\:byUid:](/zh-CN/api-reference/rtc/macos/audio/audio-basic#callback_irtcengineeventhandler_onusermuteaudio) 和 [rtcEngine\:remoteAudioStateChangedOfUid\:state\:reason\:elapsed:](/zh-CN/api-reference/rtc/macos/audio/audio-basic#callback_irtcengineeventhandler_onremoteaudiostatechanged) 回调。
:::note
注: 该方法不会影响任何正在进行的音频录制,因为它不会禁用音频采集设备。
:::
### 适用场景 [#适用场景-3]
该方法适用于多频道场景。
### 参数 [#参数-8]
是否停止发布本地音频流:
- YES:停止发布本地音频流。
- NO:(默认)恢复发布本地音频流。
连接信息。详见 [AgoraRtcConnection](/zh-CN/api-reference/rtc/macos/class-rtcconnection)。
### 返回值 [#返回值-8]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-8]
- [AgoraRtcEngineKit(Ex)](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineex)
## muteLocalVideoStream: [#mutelocalvideostream]
控制是否发布本地采集的视频流。
```objc
- (int)muteLocalVideoStream:(BOOL)mute NS_SWIFT_NAME(muteLocalVideoStream(_:));
```
该方法用于控制是否发布本地采集的视频流。调用该方法停止发布本地采集的视频流时,视频采集设备仍会继续工作,不受影响。
与调用 [enableLocalVideo:](/zh-CN/api-reference/rtc/macos/video/video-basic#api_irtcengine_enablelocalvideo) 设置为 NO 以关闭本地视频采集从而取消发布视频流的方法相比,该方法响应更快。
### 调用时机 [#调用时机-3]
该方法可以在加入频道前或后调用。
### 参数 [#参数-9]
是否停止发布本地视频流。
- YES:停止发布本地视频流。
- NO:(默认)发布本地视频流。
### 返回值 [#返回值-9]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-9]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## muteLocalVideoStreamEx\:connection: [#mutelocalvideostreamexconnection]
停止或恢复发布本地视频流。
```objc
- (int)muteLocalVideoStreamEx:(BOOL)mute connection:(AgoraRtcConnection * _Nonnull)connection NS_SWIFT_NAME(muteLocalVideoStreamEx(_:connection:));
```
:::note
注: 该方法不会影响任何正在进行的视频录制,因为它不会关闭摄像头。
:::
### 适用场景 [#适用场景-4]
该方法适用于多频道场景。
### 相关回调 [#相关回调-1]
成功调用该方法后,SDK 会触发 [rtcEngine\:didVideoMuted\:byUid:](/zh-CN/api-reference/rtc/macos/video/video-basic#callback_irtcengineeventhandler_onusermutevideo) 回调报告远端用户是否接收到本地视频流。
### 参数 [#参数-10]
是否停止发布本地视频流。
- YES:停止发布本地视频流。
- NO:(默认)发布本地视频流。
连接信息。详见 [AgoraRtcConnection](/zh-CN/api-reference/rtc/macos/class-rtcconnection)。
### 返回值 [#返回值-10]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-10]
- [AgoraRtcEngineKit(Ex)](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineex)
## muteRemoteAudioStream\:mute: [#muteremoteaudiostreammute]
停止或恢复订阅指定用户的音频流。
```objc
- (int)muteRemoteAudioStream:(NSUInteger)uid mute:(BOOL)mute NS_SWIFT_NAME(muteRemoteAudioStream(_:mute:));
```
### 调用时机 [#调用时机-4]
在加入频道后调用该方法。
### 相关回调 [#相关回调-2]
成功调用该方法后,SDK 会触发 [rtcEngine\:didAudioSubscribeStateChange\:uid\:oldState\:newState\:elapseSinceLastState:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#callback_irtcengineeventhandler_onaudiosubscribestatechanged) 回调。
### 参数 [#参数-11]
指定用户的用户 ID。
是否订阅指定远端用户的音频流。
- YES:停止订阅该用户的音频流。
- NO:(默认)订阅该用户的音频流。
### 返回值 [#返回值-11]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-11]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## muteRemoteAudioStreamEx\:mute\:connection: [#muteremoteaudiostreamexmuteconnection]
停止或恢复接收指定用户的音频流。
```objc
- (int)muteRemoteAudioStreamEx:(NSUInteger)uid
mute:(BOOL)mute
connection:(AgoraRtcConnection * _Nonnull)connection NS_SWIFT_NAME(muteRemoteAudioStreamEx(_:mute:connection:));
```
你可以在加入频道前或加入频道后调用该方法。如果用户离开频道,该方法中的设置将失效。
### 适用场景 [#适用场景-5]
该方法适用于多频道场景。
### 参数 [#参数-12]
指定用户的 ID。
是否停止接收指定用户的音频流:
- YES:停止接收指定用户的音频流。
- NO:(默认)恢复接收指定用户的音频流。
连接信息。详见 [AgoraRtcConnection](/zh-CN/api-reference/rtc/macos/class-rtcconnection)。
### 返回值 [#返回值-12]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-12]
- [AgoraRtcEngineKit(Ex)](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineex)
## muteRemoteVideoStream\:mute: [#muteremotevideostreammute]
停止或恢复订阅指定用户的视频流。
```objc
- (int)muteRemoteVideoStream:(NSUInteger)uid
mute:(BOOL)mute NS_SWIFT_NAME(muteRemoteVideoStream(_:mute:));
```
:::note
注: 成功调用该方法后,SDK 会触发 [rtcEngine\:didVideoSubscribeStateChange\:uid\:oldState\:newState\:elapseSinceLastState:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#callback_irtcengineeventhandler_onvideosubscribestatechanged) 回调。
:::
### 调用时机 [#调用时机-5]
请在加入频道后调用该方法。
### 参数 [#参数-13]
指定用户的用户 ID。
是否订阅指定远端用户的视频流:
- YES:停止订阅该用户的视频流。
- NO(默认):订阅该用户的视频流。
### 返回值 [#返回值-13]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-13]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## muteRemoteVideoStreamEx\:mute\:connection: [#muteremotevideostreamexmuteconnection]
停止或恢复接收指定用户的视频流。
```objc
- (int)muteRemoteVideoStreamEx:(NSUInteger)uid
mute:(BOOL)mute
connection:(AgoraRtcConnection * _Nonnull)connection NS_SWIFT_NAME(muteRemoteVideoStreamEx(_:mute:connection:));
```
你可以在加入频道前或加入频道后调用该方法。如果远端用户离开频道,该方法中的设置将失效。
### 适用场景 [#适用场景-6]
该方法适用于多频道场景。
### 参数 [#参数-14]
远端用户的用户 ID。
是否停止接收指定用户的视频流:
- YES:停止接收指定用户的视频流。
- NO:(默认)恢复接收指定用户的视频流。
连接信息。详见 [AgoraRtcConnection](/zh-CN/api-reference/rtc/macos/class-rtcconnection)。
### 返回值 [#返回值-14]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-14]
- [AgoraRtcEngineKit(Ex)](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineex)
## setDualStreamMode: [#setdualstreammode]
设置发送端的不同质量层级的视频流模式。
```objc
- (int)setDualStreamMode:(AgoraSimulcastStreamMode)mode NS_SWIFT_NAME(setDualStreamMode(_:));
```
SDK 默认在发送端开启视频小流自适应模式(`AgoraAutoSimulcastStream`),即发送端不会主动发送视频小流。角色为主播的接收端可以通过调用 [setRemoteVideoStream\:type:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setremotevideostreamtype) 方法发起视频小流请求,发送端在收到请求后会自动开始发送视频小流。
- 如果你希望修改此行为,可以调用本方法并将 `mode` 设置为 `AgoraDisableSimulcastStream`(从不发送视频小流)或 `AgoraEnableSimulcastStream`(始终发送视频小流)。
- 如果你希望在修改后恢复默认行为,可以再次调用本方法并将 `mode` 设置为 `AgoraAutoSimulcastStream`。
:::note
注: 本方法与 [enableDualStreamMode:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_enabledualstreammode) 方法的区别如下:
- 当调用本方法并将 `mode` 设置为 `AgoraDisableSimulcastStream` 时,效果等同于调用 [enableDualStreamMode:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_enabledualstreammode)(NO)。
- 当调用本方法并将 `mode` 设置为 `AgoraEnableSimulcastStream` 时,效果等同于调用 [enableDualStreamMode:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_enabledualstreammode)(YES)。
- 两个方法都可以在加入频道前后调用。如果两个方法都被调用,则以后调用的方法设置优先生效。
:::
### 参数 [#参数-15]
发送视频流的模式,详见 [AgoraSimulcastStreamMode](/zh-CN/api-reference/rtc/macos/enum-simulcaststreammode)。
### 返回值 [#返回值-15]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-15]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## setDualStreamMode\:streamConfig: [#setdualstreammodestreamconfig]
设置发送端的不同质量层级的视频流模式配置。
```objc
- (int)setDualStreamMode:(AgoraSimulcastStreamMode)mode
streamConfig:(AgoraSimulcastStreamConfig* _Nonnull)streamConfig NS_SWIFT_NAME(setDualStreamMode(_:streamConfig:));
```
SDK 默认在发送端开启视频小流的自适应模式(`AgoraAutoSimulcastStream`),即发送端不会主动发送视频小流。角色为主播的接收端可以通过调用 [setRemoteVideoStream\:type:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setremotevideostreamtype) 发起视频小流请求,发送端在收到请求后自动开始发送视频小流。
如果你希望修改此行为,可以调用本方法并将 `mode` 设置为 `AgoraDisableSimulcastStream`(从不发送视频小流)或 `AgoraEnableSimulcastStream`(始终发送视频小流)。
如果你希望在修改后恢复默认行为,可以再次调用本方法并将 `mode` 设置为 `AgoraAutoSimulcastStream`。
与 [setDualStreamMode:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setdualstreammode) 方法的区别在于,本方法还可以配置视频小流,SDK 会根据 `streamConfig` 中的配置发送视频流。
:::note
注: 本方法与 [enableDualStreamMode\:streamConfig:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_enabledualstreammode3) 的区别如下:
- 当调用本方法并将 `mode` 设置为 `AgoraDisableSimulcastStream` 时,效果等同于调用 [enableDualStreamMode\:streamConfig:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_enabledualstreammode3) 并将 `enabled` 设置为 NO。
- 当调用本方法并将 `mode` 设置为 `AgoraEnableSimulcastStream` 时,效果等同于调用 [enableDualStreamMode\:streamConfig:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_enabledualstreammode3) 并将 `enabled` 设置为 YES。
- 两个方法都可以在加入频道前或后调用。如果两个方法都被调用,则以后调用的方法中的设置生效。
:::
### 参数 [#参数-16]
视频流的发送模式,详见 [AgoraSimulcastStreamMode](/zh-CN/api-reference/rtc/macos/enum-simulcaststreammode)。
视频小流的配置,详见 [AgoraSimulcastStreamConfig](/zh-CN/api-reference/rtc/macos/class-simulcaststreamconfig)。
:::note
注: 当 `mode` 设置为 `AgoraDisableSimulcastStream` 时,设置 `streamConfig` 不生效。
:::
### 返回值 [#返回值-16]
0:方法调用成功。
< 0:方法调用失败。
### 所属接口类 [#所属接口类-16]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## setDualStreamModeEx\:streamConfig\:connection: [#setdualstreammodeexstreamconfigconnection]
设置发送端的不同质量层级的视频流模式。
```objc
- (int)setDualStreamModeEx:(AgoraSimulcastStreamMode)mode
streamConfig:(AgoraSimulcastStreamConfig*)streamConfig
connection:(AgoraRtcConnection* _Nonnull)connection NS_SWIFT_NAME(setDualStreamModeEx(_:streamConfig:connection:));
```
SDK 默认在发送端开启视频小流的自适应模式(`AgoraAutoSimulcastStream`),即发送端不会主动发送视频小流。角色为主播的接收端可以通过调用 [setRemoteVideoStreamEx\:type\:connection:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengineex_setremotevideostreamtypeex) 方法发起视频小流请求,发送端在收到请求后会自动开始发送视频小流。
- 如果你希望修改此行为,可以调用本方法并将 `mode` 设置为 `AgoraDisableSimulcastStream`(从不发送视频小流)或 `AgoraEnableSimulcastStream`(始终发送视频小流)。
- 如果你希望在修改后恢复默认行为,可以再次调用本方法并将 `mode` 设置为 `AgoraAutoSimulcastStream`。
:::note
注: 该方法与 [enableDualStreamModeEx\:streamConfig\:connection:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengineex_enabledualstreammodeex) 的区别如下:
- 当调用本方法并将 `mode` 设置为 `AgoraDisableSimulcastStream` 时,效果等同于调用 [enableDualStreamModeEx\:streamConfig\:connection:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengineex_enabledualstreammodeex)(NO)。
- 当调用本方法并将 `mode` 设置为 `AgoraEnableSimulcastStream` 时,效果等同于调用 [enableDualStreamModeEx\:streamConfig\:connection:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengineex_enabledualstreammodeex)(YES)。
- 两个方法都可以在加入频道前后调用。如果两个方法都被调用,则以后调用的方法设置优先生效。
:::
### 适用场景 [#适用场景-7]
该方法适用于多频道场景。
### 参数 [#参数-17]
视频流的发送模式,详见 [AgoraSimulcastStreamMode](/zh-CN/api-reference/rtc/macos/enum-simulcaststreammode)。
视频小流的配置。详见 [AgoraSimulcastStreamConfig](/zh-CN/api-reference/rtc/macos/class-simulcaststreamconfig)。
:::note
注: 当 `mode` 设置为 `AgoraDisableSimulcastStream` 时,设置该参数不生效。
:::
连接信息。详见 [AgoraRtcConnection](/zh-CN/api-reference/rtc/macos/class-rtcconnection)。
### 返回值 [#返回值-17]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-17]
- [AgoraRtcEngineKit(Ex)](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineex)
## setRemoteDefaultVideoStreamType: [#setremotedefaultvideostreamtype]
设置默认订阅的视频流类型。
```objc
- (int)setRemoteDefaultVideoStreamType:(AgoraVideoStreamType)streamType NS_SWIFT_NAME(setRemoteDefaultVideoStreamType(_:));
```
根据发送端的默认行为以及调用 [setDualStreamMode\:streamConfig:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setdualstreammode2) 时的具体设置,你调用此方法的场景如下:
- SDK 默认在发送端启用视频小流自适应模式(`AgoraAutoSimulcastStream`),即仅发送视频大流。此时,只有角色为主播的接收端可以调用此方法发起视频小流请求。一旦发送端收到请求后,会自动开始发送视频小流。此时,频道内所有用户都可以调用此方法切换为订阅视频小流模式。
- 如果发送端调用 [setDualStreamMode\:streamConfig:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setdualstreammode2) 并将 `mode` 设置为 `AgoraDisableSimulcastStream`(从不发送视频小流),则调用此方法无效。
- 如果发送端调用 [setDualStreamMode\:streamConfig:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setdualstreammode2) 并将 `mode` 设置为 `AgoraEnableSimulcastStream`(始终发送视频小流),则主播和观众角色的接收端都可以调用此方法切换为订阅视频小流模式。
SDK 会根据视频窗口的大小动态调整对应视频流的尺寸,以节省带宽和计算资源。视频小流的默认宽高比与视频大流一致。系统会根据当前视频大流的宽高比,自动分配视频小流的分辨率、帧率和码率。
:::note
注: 如果你同时调用此方法和 [setRemoteVideoStream\:type:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setremotevideostreamtype),则以 [setRemoteVideoStream\:type:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setremotevideostreamtype) 的设置为准。
:::
### 调用时机 [#调用时机-6]
该方法需要在加入频道前调用。SDK 不支持在加入频道后更改默认订阅的视频流类型。
### 参数 [#参数-18]
默认订阅的视频流类型,详见 [AgoraVideoStreamType](/zh-CN/api-reference/rtc/macos/enum-videostreamtype)。
### 返回值 [#返回值-18]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-18]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## setRemoteVideoStream\:type: [#setremotevideostreamtype]
设置你要订阅的视频流类型。
```objc
- (int)setRemoteVideoStream:(NSUInteger)uid
type:(AgoraVideoStreamType)streamType NS_SWIFT_NAME(setRemoteVideoStream(_:type:));
```
根据发送端的默认行为以及调用 [setDualStreamMode\:streamConfig:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setdualstreammode2) 时的具体设置,你调用此方法的场景如下:
- SDK 默认在发送端启用视频小流自适应模式(`AgoraAutoSimulcastStream`),即仅发送视频大流。此时,只有角色为主播的接收端可以调用此方法发起视频小流请求。发送端收到请求后会自动开始发送视频小流,频道内所有用户都可以调用此方法切换为订阅视频小流模式。
- 如果发送端调用 [setDualStreamMode\:streamConfig:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setdualstreammode2) 并将 `mode` 设置为 `AgoraDisableSimulcastStream`(从不发送视频小流),则调用此方法无效。
- 如果发送端调用 [setDualStreamMode\:streamConfig:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setdualstreammode2) 并将 `mode` 设置为 `AgoraEnableSimulcastStream`(始终发送视频小流),则主播和观众角色的接收端都可以调用此方法切换为订阅视频小流模式。
SDK 会根据视频窗口的大小动态调整对应视频流的尺寸,以节省带宽和计算资源。视频小流的默认宽高比与视频大流相同。系统会根据当前视频大流的宽高比,自动分配视频小流的分辨率、帧率和码率。
:::note
注:
- 你可以在加入频道前或加入频道后调用此方法。
- 如果你同时调用此方法和 [setRemoteDefaultVideoStreamType:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setremotedefaultvideostreamtype),以 [setRemoteVideoStream\:type:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setremotevideostreamtype) 的设置为准。
:::
### 参数 [#参数-19]
远端用户 ID。
视频流类型,详见 [AgoraVideoStreamType](/zh-CN/api-reference/rtc/macos/enum-videostreamtype)。
### 返回值 [#返回值-19]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-19]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## setRemoteVideoStreamEx\:type\:connection: [#setremotevideostreamextypeconnection]
设置你要订阅的视频流类型。
```objc
- (int)setRemoteVideoStreamEx:(NSUInteger)uid
type:(AgoraVideoStreamType)streamType
connection:(AgoraRtcConnection * _Nonnull)connection NS_SWIFT_NAME(setRemoteVideoStreamEx(_:type:connection:));
```
根据发送端的默认行为以及调用 [setDualStreamMode\:streamConfig:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setdualstreammode2) 时的具体设置,你调用此方法的场景如下:
- SDK 默认在发送端启用视频小流自适应模式(`AgoraAutoSimulcastStream`),即仅发送视频大流。此时,只有角色为主播的接收端可以调用此方法发起视频小流请求。一旦发送端收到请求,会自动开始发送视频小流。此时,频道内所有用户都可以调用此方法切换为视频小流订阅模式。
- 如果发送端调用 [setDualStreamMode\:streamConfig:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setdualstreammode2) 并将 `mode` 设置为 `AgoraDisableSimulcastStream`(从不发送视频小流),则调用此方法无效。
- 如果发送端调用 [setDualStreamMode\:streamConfig:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setdualstreammode2) 并将 `mode` 设置为 `AgoraEnableSimulcastStream`(始终发送视频小流),则无论你是主播还是观众,都可以调用此方法切换为视频小流订阅模式。
SDK 会根据视频窗口的大小动态调整对应视频流的尺寸,以节省带宽和计算资源。视频小流的默认宽高比与视频大流相同。系统会根据当前视频大流的宽高比,自动分配视频小流的分辨率、帧率和码率。
:::note
注: 如果发送端已调用 [setDualStreamModeEx\:streamConfig\:connection:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengineex_setdualstreammodeex) 并将 `mode` 设置为 `AgoraDisableSimulcastStream`(从不发送视频小流),则调用此方法无效。你需要在发送端再次调用 [setDualStreamModeEx\:streamConfig\:connection:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengineex_setdualstreammodeex) 并调整设置。
:::
### 适用场景 [#适用场景-8]
该方法适用于多频道场景。
### 参数 [#参数-20]
远端用户 ID。
视频流类型,详见 [AgoraVideoStreamType](/zh-CN/api-reference/rtc/macos/enum-videostreamtype)。
连接信息。详见 [AgoraRtcConnection](/zh-CN/api-reference/rtc/macos/class-rtcconnection)。
### 返回值 [#返回值-20]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-20]
- [AgoraRtcEngineKit(Ex)](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineex)
## setRemoteVideoSubscriptionOptions\:options: [#setremotevideosubscriptionoptionsoptions]
设置订阅远端视频流的选项。
```objc
- (int)setRemoteVideoSubscriptionOptions:(NSUInteger)uid
options:(AgoraVideoSubscriptionOptions* _Nonnull)options NS_SWIFT_NAME(setRemoteVideoSubscriptionOptions(_:options:));
```
当远端用户开启双流模式时,你可以调用此方法设置订阅该远端用户发送的视频流的选项。SDK 默认的远端视频流订阅行为取决于注册的视频观察者类型:
- 如果注册了 [AgoraVideoFrameDelegate](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_ivideoframeobserver) 观察者,默认订阅原始数据和编码数据;
- 如果注册了 [AgoraEncodedVideoFrameDelegate](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_ivideoencodedframeobserver) 观察者,默认仅订阅编码数据;
- 如果同时注册了两种观察者,默认行为遵循最后注册的观察者。例如,如果最后注册的是 [AgoraVideoFrameDelegate](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_ivideoframeobserver) 观察者,则默认订阅原始数据和编码数据。
如果你希望修改默认行为,或为不同的 `uid` 设置不同的订阅选项,可以调用此方法进行设置。
### 参数 [#参数-21]
远端用户的用户 ID。
视频订阅选项,详见 [AgoraVideoSubscriptionOptions](/zh-CN/api-reference/rtc/macos/class-videosubscriptionoptions)。
### 返回值 [#返回值-21]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-21]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## setRemoteVideoSubscriptionOptionsEx\:options\:connection: [#setremotevideosubscriptionoptionsexoptionsconnection]
设置订阅远端视频流的选项。
```objc
- (int)setRemoteVideoSubscriptionOptionsEx:(NSUInteger)uid
options:(AgoraVideoSubscriptionOptions* _Nonnull)options
connection:(AgoraRtcConnection* _Nonnull)connection NS_SWIFT_NAME(setRemoteVideoSubscriptionOptionsEx(_:options:connection:));
```
当远端用户开启双流模式时,你可以调用该方法选择订阅该远端用户发送的视频流的选项。
### 适用场景 [#适用场景-9]
该方法适用于多频道场景。
### 参数 [#参数-22]
远端用户 ID。
视频订阅选项,详见 [AgoraVideoSubscriptionOptions](/zh-CN/api-reference/rtc/macos/class-videosubscriptionoptions)。
连接信息,详见 [AgoraRtcConnection](/zh-CN/api-reference/rtc/macos/class-rtcconnection)。
### 返回值 [#返回值-22]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-22]
- [AgoraRtcEngineKit(Ex)](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineex)
## setSubscribeAudioAllowlist: [#setsubscribeaudioallowlist]
设置音频流订阅的白名单。
```objc
- (int)setSubscribeAudioAllowlist:(NSArray *_Nonnull)allowlist NS_SWIFT_NAME(setSubscribeAudioAllowlist(_:));
```
你可以调用此方法来指定希望订阅的用户的音频流。
:::note
注:
- 你可以在加入频道之前或之后调用此方法。
- 白名单不受 [muteRemoteAudioStream\:mute:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_muteremoteaudiostream)、[muteAllRemoteAudioStreams:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_muteallremoteaudiostreams) 和 [AgoraRtcChannelMediaOptions](/zh-CN/api-reference/rtc/macos/class-channelmediaoptions) 中的 `autoSubscribeAudio` 设置的影响。
- 一旦设置了订阅白名单,即使你离开当前频道并重新加入频道,该设置仍然有效。
- 如果某个用户同时被添加到白名单和黑名单中,则仅黑名单生效。
:::
### 参数 [#参数-23]
希望订阅的用户的用户 ID 列表。如果希望订阅某个用户的音频流,请将该用户的 ID 添加到该列表中。如果希望将某个用户从白名单中移除,需要调用 [setSubscribeAudioAllowlist:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setsubscribeaudioallowlist) 方法更新用户 ID 列表;也就是说,只需在新的用户 ID 列表中添加希望订阅的用户的 `uid`。
### 返回值 [#返回值-23]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-23]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## setSubscribeAudioAllowlistEx\:connection: [#setsubscribeaudioallowlistexconnection]
设置音频流订阅的白名单。
```objc
- (int)setSubscribeAudioAllowlistEx:(NSArray *_Nonnull)allowlist connection:(AgoraRtcConnection * _Nonnull)connection NS_SWIFT_NAME(setSubscribeAudioAllowlistEx(_:connection:));
```
你可以调用此方法来指定你想要订阅的用户的音频流。
:::note
注:
- 你可以在加入频道前或加入频道后调用此方法。
- 白名单不受 `muteRemoteAudioStream`、`muteAllRemoteAudioStreams` 和 [AgoraRtcChannelMediaOptions](/zh-CN/api-reference/rtc/macos/class-channelmediaoptions) 中的 `autoSubscribeAudio` 设置的影响。
- 一旦设置了订阅白名单,即使你离开当前频道并重新加入频道,该设置仍然有效。
- 如果某个用户同时被添加到白名单和黑名单中,只有黑名单生效。
:::
### 适用场景 [#适用场景-10]
该方法适用于多频道场景。
### 参数 [#参数-24]
你想要订阅的用户的用户 ID 列表。如果你想指定某个用户的音频流进行订阅,请将该用户的 ID 添加到此列表中。如果你想将某个用户从白名单中移除,你需要调用 `setSubscribeAudioAllowlist` 方法来更新用户 ID 列表;这意味着你只需在新的用户 ID 列表中添加你想要订阅的用户的 `uid`。
连接信息。详见 [AgoraRtcConnection](/zh-CN/api-reference/rtc/macos/class-rtcconnection)。
### 返回值 [#返回值-24]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-24]
- [AgoraRtcEngineKit(Ex)](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineex)
## setSubscribeAudioBlocklist: [#setsubscribeaudioblocklist]
设置音频流订阅的黑名单。
```objc
- (int)setSubscribeAudioBlocklist:(NSArray *_Nonnull)blocklist NS_SWIFT_NAME(setSubscribeAudioBlocklist(_:));
```
你可以调用此方法来指定不希望订阅的用户的音频流。
:::note
注:
- 你可以在加入频道前或加入频道后调用此方法。
- 黑名单设置实时生效。将已订阅用户加入黑名单后,该用户的音频流也会停止订阅。
- 黑名单不受 [muteRemoteAudioStream\:mute:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_muteremoteaudiostream)、[muteAllRemoteAudioStreams:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_muteallremoteaudiostreams) 和 [AgoraRtcChannelMediaOptions](/zh-CN/api-reference/rtc/macos/class-channelmediaoptions) 中的 `autoSubscribeAudio` 设置的影响。
- 一旦设置了订阅黑名单,即使你离开当前频道并重新加入,该设置仍然有效。
- 如果某个用户同时被加入白名单和黑名单,则仅黑名单生效。
:::
### 参数 [#参数-25]
不希望订阅其音频流的远端用户 ID 列表。如果你希望指定不订阅某个用户的音频流,请将该用户的 ID 添加到此列表中。如果你希望将某个用户从黑名单中移除,需要调用 [setSubscribeAudioBlocklist:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setsubscribeaudioblocklist) 方法更新用户 ID 列表;这意味着你只需在新的用户 ID 列表中添加不希望订阅的用户的 ID。
### 返回值 [#返回值-25]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-25]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## setSubscribeAudioBlocklistEx\:connection: [#setsubscribeaudioblocklistexconnection]
设置音频流订阅的黑名单。
```objc
- (int)setSubscribeAudioBlocklistEx:(NSArray *_Nonnull)blocklist connection:(AgoraRtcConnection * _Nonnull)connection NS_SWIFT_NAME(setSubscribeAudioBlocklistEx(_:connection:));
```
你可以调用此方法来指定不希望订阅的用户的音频流。
:::note
注:
- 你可以在加入频道前或加入频道后调用此方法。
- 黑名单设置实时生效。将已订阅用户加入黑名单后,该用户的音频流也会停止订阅。
- 黑名单不受 [muteRemoteAudioStream\:mute:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_muteremoteaudiostream)、[muteAllRemoteAudioStreams:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_muteallremoteaudiostreams) 和 [AgoraRtcChannelMediaOptions](/zh-CN/api-reference/rtc/macos/class-channelmediaoptions) 中的 `autoSubscribeAudio` 设置影响。
- 一旦设置了订阅黑名单,即使你离开当前频道并重新加入,该设置仍然有效。
- 如果某个用户同时被加入白名单和黑名单,则仅黑名单生效。
:::
### 适用场景 [#适用场景-11]
该方法适用于多频道场景。
### 参数 [#参数-26]
不希望订阅其音频流的用户 ID 列表。如果你希望指定不订阅某个用户的音频流,请将该用户的 ID 添加到此列表中。如果你希望将某个用户从黑名单中移除,需要调用 [setSubscribeAudioBlocklist:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setsubscribeaudioblocklist) 方法更新用户 ID 列表;这意味着你只需在新的用户 ID 列表中添加不希望订阅的用户的用户 ID。
连接信息。详见 [AgoraRtcConnection](/zh-CN/api-reference/rtc/macos/class-rtcconnection)。
### 返回值 [#返回值-26]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-26]
- [AgoraRtcEngineKit(Ex)](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineex)
## setSubscribeVideoAllowlist: [#setsubscribevideoallowlist]
设置视频流订阅的白名单。
```objc
- (int)setSubscribeVideoAllowlist:(NSArray *_Nonnull)allowlist NS_SWIFT_NAME(setSubscribeVideoAllowlist(_:));
```
你可以调用该方法来指定你想要订阅的用户的视频流。
:::note
注:
- 你可以在加入频道前或加入频道后调用该方法。
- 白名单不受 [muteRemoteVideoStream\:mute:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_muteremotevideostream)、[muteAllRemoteVideoStreams:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_muteallremotevideostreams) 和 [AgoraRtcChannelMediaOptions](/zh-CN/api-reference/rtc/macos/class-channelmediaoptions) 中的 `autoSubscribeAudio` 设置的影响。
- 一旦设置了订阅白名单,即使你离开当前频道并重新加入频道,该设置仍然有效。
- 如果某个用户同时被添加到白名单和黑名单中,则只有黑名单生效。
:::
### 参数 [#参数-27]
你想要订阅的视频流用户的用户 ID 列表。如果你想指定某个用户的视频流进行订阅,请将该用户的用户 ID 添加到此列表中。如果你想将某个用户从白名单中移除,你需要调用 [setSubscribeVideoAllowlist:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setsubscribevideoallowlist) 方法更新用户 ID 列表;这意味着你只需在新的用户 ID 列表中添加你想要订阅的用户的用户 ID。
### 返回值 [#返回值-27]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-27]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## setSubscribeVideoAllowlistEx\:connection: [#setsubscribevideoallowlistexconnection]
设置视频流订阅的白名单。
```objc
- (int)setSubscribeVideoAllowlistEx:(NSArray *_Nonnull)allowlist connection:(AgoraRtcConnection * _Nonnull)connection NS_SWIFT_NAME(setSubscribeVideoAllowlistEx(_:connection:));
```
你可以调用该方法来指定希望订阅的用户的视频流。
:::note
注:
- 你可以在加入频道前或加入频道后调用此方法。
- 白名单不受 [muteRemoteVideoStream\:mute:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_muteremotevideostream)、[muteAllRemoteVideoStreams:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_muteallremotevideostreams) 和 [AgoraRtcChannelMediaOptions](/zh-CN/api-reference/rtc/macos/class-channelmediaoptions) 中的 `autoSubscribeAudio` 设置的影响。
- 一旦设置了订阅白名单,即使你离开并重新加入当前频道,该设置仍然有效。
- 如果某个用户同时被加入白名单和黑名单,则只有黑名单生效。
:::
### 适用场景 [#适用场景-12]
该方法适用于多频道场景。
### 参数 [#参数-28]
你希望订阅其视频流的用户 ID 列表。如果希望订阅某个用户的视频流,请将该用户的 ID 添加到该列表中。如果希望将某个用户从白名单中移除,需要调用 [setSubscribeVideoAllowlistEx\:connection:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengineex_setsubscribevideoallowlistex) 方法更新用户 ID 列表,即只需在新的用户 ID 列表中添加希望订阅的用户的 `uid`。
连接信息。详见 [AgoraRtcConnection](/zh-CN/api-reference/rtc/macos/class-rtcconnection)。
### 返回值 [#返回值-28]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-28]
- [AgoraRtcEngineKit(Ex)](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineex)
## setSubscribeVideoBlocklist: [#setsubscribevideoblocklist]
设置不订阅的视频流用户的 blocklist。
```objc
- (int)setSubscribeVideoBlocklist:(NSArray *_Nonnull)blocklist NS_SWIFT_NAME(setSubscribeVideoBlocklist(_:));
```
你可以调用此方法来指定不希望订阅的用户的视频流。
:::note
注:
- 你可以在加入频道前或加入频道后调用此方法。
- 黑名单设置实时生效。将已订阅用户加入黑名单后,该用户的视频流也会停止订阅。
- 该 blocklist 不受 `muteRemoteVideoStream`、`muteAllRemoteVideoStreams` 和 [AgoraRtcChannelMediaOptions](/zh-CN/api-reference/rtc/macos/class-channelmediaoptions) 中的 `autoSubscribeAudio` 设置的影响。
- 一旦设置了订阅的 blocklist,即使你离开并重新加入频道,该设置仍然有效。
- 如果某个用户同时被添加到 allowlist 和 blocklist 中,只有 blocklist 生效。
:::
### 参数 [#参数-29]
不希望订阅其视频流的用户 ID 列表。如果你希望指定不订阅某个用户的视频流,请将该用户的用户 ID 添加到此列表中。如果你希望将某个用户从 blocklist 中移除,需要调用 [setSubscribeVideoBlocklist:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setsubscribevideoblocklist) 方法更新用户 ID 列表;这意味着你只需在新的用户 ID 列表中添加不希望订阅的用户的用户 ID。
### 返回值 [#返回值-29]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-29]
- [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)
## setSubscribeVideoBlocklistEx\:connection: [#setsubscribevideoblocklistexconnection]
设置视频流订阅的阻止名单。
```objc
- (int)setSubscribeVideoBlocklistEx:(NSArray *_Nonnull)blocklist connection:(AgoraRtcConnection * _Nonnull)connection NS_SWIFT_NAME(setSubscribeVideoBlocklistEx(_:connection:));
```
你可以调用此方法来指定不希望订阅的用户的视频流。
:::note
注:
- 你可以在加入频道前或加入频道后调用此方法。
- 黑名单设置实时生效。将已订阅用户加入黑名单后,该用户的视频流也会停止订阅。
- 阻止名单不受 [muteRemoteVideoStream\:mute:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_muteremotevideostream)、[muteAllRemoteVideoStreams:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_muteallremotevideostreams) 和 [AgoraRtcChannelMediaOptions](/zh-CN/api-reference/rtc/macos/class-channelmediaoptions) 中的 `autoSubscribeAudio` 设置影响。
- 一旦设置了订阅的阻止名单,即使你离开当前频道并重新加入频道,该设置仍然有效。
- 如果某个用户同时被添加到允许名单和阻止名单中,则仅阻止名单生效。
:::
### 适用场景 [#适用场景-13]
该方法适用于多频道场景。
### 参数 [#参数-30]
不希望订阅其视频流的用户 ID 列表。如果你希望指定不订阅某个用户的视频流,请将该用户的用户 ID 添加到此列表中。如果你希望将某个用户从阻止名单中移除,需要调用 [setSubscribeVideoBlocklist:](/zh-CN/api-reference/rtc/macos/publishnsubscribe#api_irtcengine_setsubscribevideoblocklist) 方法更新用户 ID 列表;这意味着你只需在新的用户 ID 列表中添加不希望订阅的用户的用户 ID。
连接信息。详见 [AgoraRtcConnection](/zh-CN/api-reference/rtc/macos/class-rtcconnection)。
### 返回值 [#返回值-30]
- 0:方法调用成功。
- < 0:方法调用失败。详见[错误码](/zh-CN/api-reference/rtc/error-code)了解详情和解决建议。
### 所属接口类 [#所属接口类-30]
- [AgoraRtcEngineKit(Ex)](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineex)
## rtcEngine\:didAudioPublishStateChange\:oldState\:newState\:elapseSinceLastState: [#rtcenginedidaudiopublishstatechangeoldstatenewstateelapsesincelaststate]
音频发布状态发生变化回调。
```objc
- (void)rtcEngine:(AgoraRtcEngineKit *_Nonnull)engine didAudioPublishStateChange:(NSString * _Nonnull)channelId
oldState:(AgoraStreamPublishState)oldState
newState:(AgoraStreamPublishState)newState
elapseSinceLastState:(int)elapseSinceLastState NS_SWIFT_NAME(rtcEngine(_:didAudioPublishStateChange:oldState:newState:elapseSinceLastState:));
```
该回调在音频发布状态发生变化时触发。
### 触发时机 [#触发时机]
该回调在音频发布状态发生变化时触发。
### 参数 [#参数-31]
当前使用的 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 实例。详见 [AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine)。
频道名。
之前的发布状态。详见 [AgoraStreamPublishState](/zh-CN/api-reference/rtc/macos/enum-streampublishstate)。
当前的发布状态。详见 [AgoraStreamPublishState](/zh-CN/api-reference/rtc/macos/enum-streampublishstate)。
从之前状态切换到当前状态所经过的时间(毫秒)。
### 所属接口类 [#所属接口类-31]
- [AgoraRtcEngineDelegate](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineeventhandler)
## rtcEngine\:didAudioSubscribeStateChange\:uid\:oldState\:newState\:elapseSinceLastState: [#rtcenginedidaudiosubscribestatechangeuidoldstatenewstateelapsesincelaststate]
音频订阅状态发生变化回调。
```objc
- (void)rtcEngine:(AgoraRtcEngineKit *_Nonnull)engine didAudioSubscribeStateChange:(NSString * _Nonnull)channelId
uid:(unsigned int)uid
oldState:(AgoraStreamSubscribeState)oldState
newState:(AgoraStreamSubscribeState)newState
elapseSinceLastState:(int)elapseSinceLastState NS_SWIFT_NAME(rtcEngine(_:didAudioSubscribeStateChange:uid:oldState:newState:elapseSinceLastState:));
```
该回调在音频订阅状态发生变化时触发。
### 参数 [#参数-32]
[AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 对象。
频道名。
远端用户 ID。
之前的订阅状态,详见 [AgoraStreamSubscribeState](/zh-CN/api-reference/rtc/macos/enum-streamsubscribestate)。
当前的订阅状态,详见 [AgoraStreamSubscribeState](/zh-CN/api-reference/rtc/macos/enum-streamsubscribestate)。
从上一个状态到当前状态所经历的时间(毫秒)。
### 所属接口类 [#所属接口类-32]
- [AgoraRtcEngineDelegate](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineeventhandler)
## rtcEngine\:didVideoSubscribeStateChange\:uid\:oldState\:newState\:elapseSinceLastState: [#rtcenginedidvideosubscribestatechangeuidoldstatenewstateelapsesincelaststate]
远端视频订阅状态发生变化回调。
```objc
- (void)rtcEngine:(AgoraRtcEngineKit *_Nonnull)engine didVideoSubscribeStateChange:(NSString * _Nonnull)channelId
uid:(unsigned int)uid
oldState:(AgoraStreamSubscribeState)oldState
newState:(AgoraStreamSubscribeState)newState
elapseSinceLastState:(int)elapseSinceLastState NS_SWIFT_NAME(rtcEngine(_:didVideoSubscribeStateChange:uid:oldState:newState:elapseSinceLastState:));
```
该回调在你订阅远端视频流的状态发生变化时触发。
### 参数 [#参数-33]
[AgoraRtcEngineKit](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengine) 对象。
频道名。
远端用户 ID。
之前的订阅状态,详见 [AgoraStreamSubscribeState](/zh-CN/api-reference/rtc/macos/enum-streamsubscribestate)。
当前的订阅状态,详见 [AgoraStreamSubscribeState](/zh-CN/api-reference/rtc/macos/enum-streamsubscribestate)。
从上一个状态到当前状态所经历的时间(毫秒)。
### 所属接口类 [#所属接口类-33]
- [AgoraRtcEngineDelegate](/zh-CN/api-reference/rtc/macos/rtc-interface-class#class_irtcengineeventhandler)