NERtcEngine 的常用接口。更多...

#import <INERtcEngine.h>

类 <INERtcEngine> 继承关系图:

构造函数
(NERtcConnectionStateType)	- connectionState
	获取当前房间连接状态。更多...

(int)	- setupEngineWithContext:
	创建 NERtcEngine 并初始化 NERTC SDK 服务。更多...

(int)	- joinChannelWithToken:channelName:myUid:completion:
	加入音视频房间。加入音视频房间时，如果指定房间尚未创建，云信服务器内部会自动创建一个同名房间。更多...

(int)	- leaveChannel
	离开房间，即挂断或退出通话。结束通话时，必须调用leaveChannel结束通话，否则无法开始下一次通话。成功调用该方法离开房间后，本地会触发 onNERtcEngineDidLeaveChannelWithResult 回调，远端会触发 onNERtcEngineUserDidLeaveWithUserID 回调。更多...

(int)	- switchChannelWithToken:channelName:completion:
	快速切换音视频房间。房间场景为直播场景时，房间中角色为观众的成员可以调用该方法从当前房间快速切换至另一个房间。成功调用该方切换房间后，本端会收到离开房间的回调 onNERtcEngineDidLeaveChannelWithResult；远端用户会收到 onNERtcEngineUserDidLeaveWithUserID 和 onNERtcEngineUserDidJoinWithUserID 的回调。更多...

(int)	- enableLocalAudio:
	开启/关闭本地音频采集和发送。当 App 加入房间时，语音功能默认为开启状态。该方法不影响接收或播放远端音频流，enableLocalAudio(NO) 适用于只下行不上行音频流的场景。成功调用该方法后，房间内其他用户触发 onNERtcEngineUserAudioDidStart 或 onNERtcEngineUserAudioDidStop 回调。更多...

(int)	- enableLocalVideo:
	是否开启本地视频采集。更多...

(int)	- enableLocalVideo:streamType:
	开启或关闭本地视频的采集与发送。通过主流或辅流视频通道进行本地视频流的采集与发送。更多...

(int)	- enableMediaPub:withMediaType:
	开启或关闭本地媒体流（主流）的发送。该方法用于开始或停止向网络发送本地音频或视频数据。该方法不影响接收或播放远端媒体流，也不会影响本地音频或视频的采集状态。更多...

(int)	- setChannelProfile:
	设置房间场景。房间场景可设置为通话或直播场景，不同的场景中 QoS 策略不同。更多...

(int)	- setLocalVideoConfig:
	设置视频编码属性。更多...

(int)	- setLocalVideoConfig:streamType:
	设置视频编码属性。通过此接口可以设置视频主流或辅流的编码分辨率、裁剪模式、码率、帧率、带宽受限时的视频编码降级偏好、编码的镜像模式、编码的方向模式参数。更多...

(int)	- setAudioProfile:scenario:
	设置音频编码属性。更多...

(int)	- setupLocalVideoCanvas:
	设置本地视图。该方法设置本地视频显示信息。只影响本地用户看到的视频画面，不影响远端。 App 通过调用此接口绑定本地视频流的显示视窗（view）。在 App 开发中，通常在初始化后调用该方法进行本地视频设置，然后再加入房间。更多...

(int)	- setupRemoteVideoCanvas:forUserID:
	设置远端用户视图。该方法绑定远端用户和显示视图，并设置远端用户视图在本地显示时的渲染模式和镜像模式，只影响本地用户看到的视频画面。更多...

(int)	- switchCamera
	切换前置/后置摄像头。该方法需要在相机启动后调用，例如调用 startPreview 或 joinChannel 后。更多...

(int)	- setClientRole:
	在直播场景中设置用户角色。用户角色支持设置为主播或观众，主播和观众的权限不同。更多...

(int)	- setParameters:
	设置音视频通话的相关参数。更多...

详细描述

NERtcEngine 的常用接口。

函数文档

◆ connectionState

- (NERtcConnectionStateType) connectionState

获取当前房间连接状态。

返回: 当前房间连接状态。

◆ enableLocalAudio:

- (int) enableLocalAudio: (BOOL) enabled

开启/关闭本地音频采集和发送。
当 App 加入房间时，语音功能默认为开启状态。
该方法不影响接收或播放远端音频流，enableLocalAudio(NO) 适用于只下行不上行音频流的场景。
成功调用该方法后，房间内其他用户触发 onNERtcEngineUserAudioDidStart 或 onNERtcEngineUserAudioDidStop 回调。

注解

该方法与 muteLocalAudio 的区别在于，enableLocalAudio 用于开启本地语音采集及处理；muteLocalAudio 用于停止或继续发送本地音频流。
该方法设置内部引擎为启用状态，在 leaveChannel 后仍然有效。
从 V4.4.0 版本开始，开启或关闭本地音频采集的操作不再影响音乐文件播放，即 enableLocalAudio(NO) 后仍旧可以通过 startAudioMixingWithOption: 播放音乐文件。

参数

enabled 是否开启本地音频采集。

返回

0: 方法调用成功；
其他: 方法调用失败。

◆ enableLocalVideo:

- (int) enableLocalVideo: (BOOL) enabled

是否开启本地视频采集。

注解

该方法在加入房间前和加入房间后均可调用。
该方法仅适用于视频主流，若您希望开启辅流通道的视频采集，请调用 INERtcEngine#enableLocalVideo:streamType: 方法。
成功启用或禁用本地视频采集后，远端会触发 onNERtcEngineUserVideoDidStartWithUserID 或 onNERtcEngineUserVideoDidStop 回调。

参数

enabled 是否开启本地视频采集。

返回: 操作返回值，成功则返回 0

◆ enableLocalVideo:streamType:

- (int) enableLocalVideo:	(BOOL)	enabled
streamType:	(NERtcStreamChannelType)	streamType

开启或关闭本地视频的采集与发送。
通过主流或辅流视频通道进行本地视频流的采集与发送。

自从: V4.6.20

调用时机: 请在初始化后调用该方法，且该方法在加入房间前后均可调用。

注解: 该方法设置内部引擎为开启或关闭状态, 在 INERtcEngine#leaveChannel 后仍然有效。

参数说明

参数名称	类型	描述
streamType	NERtcStreamChannelType	视频通道类型： kNERtcStreamChannelTypeMainStream：主流。 kNERtcStreamChannelTypeSubStream：辅流。
enabled	BOOL	是否开启本地视频采集与发送： YES：开启本地视频采集。 NO：关闭本地视频采集。关闭后，远端用户无法接收到本地用户的视频流；但本地用户仍然可以接收到远端用户的视频流。

示例代码: //打开视频主流

[[NERtcEngine sharedEngine] enableLocalVideo:YES streamType:kNERtcStreamChannelTypeMainStream];

//关闭视频主流

[[NERtcEngine sharedEngine] enableLocalVideo:NO streamType:kNERtcStreamChannelTypeMainStream];

//打开视频辅流

[[NERtcEngine sharedEngine] enableLocalVideo:YES streamType:kNERtcStreamChannelTypeSubStream];

//关闭视频辅流

[[NERtcEngine sharedEngine] enableLocalVideo:NO streamType:kNERtcStreamChannelTypeSubStream];

kNERtcStreamChannelTypeMainStream
@ kNERtcStreamChannelTypeMainStream
主流通道。
Definition: NERtcEngineEnum.h:1007

kNERtcStreamChannelTypeSubStream
@ kNERtcStreamChannelTypeSubStream
辅流通道。
Definition: NERtcEngineEnum.h:1016

相关回调

streamType 为 kNERtcStreamChannelTypeMainStream（主流）时：
- 开启本地视频采集后，远端会收到 NERtcEngineDelegate#onNERtcEngineUserAudioDidStart: 回调。
- 关闭本地视频采集后，远端会收到 NERtcEngineDelegate#onNERtcEngineUserAudioDidStop: 回调。
streamType 为 kNERtcStreamChannelTypeSubStream（辅流）时：
- 开启本地视频采集后，远端会收到 NERtcEngineDelegate#onNERtcEngineUserSubStreamAudioDidStart: 回调。
- 关闭本地视频采集后，远端会收到 NERtcEngineDelegate#onNERtcEngineUserSubStreamAudioDidStop: 回调。

返回

0（kNERtcNoError）：方法调用成功。
其他：方法调用失败。
- 30001（kNERtcErrFatal）：通用错误，一般表示引擎错误，尝试再次调用此接口即可。
- 30005（kNERtcErrInvalidState）：当前状态不支持的操作，比如已开启外部视频采集。
- 30027（kNERtcErrDeviceOccupied）: 所选设备已被占用。比如已通过主流通道开启了摄像头，无法再通过辅流通道开启摄像头。
- 30300（kNERtcErrOSAuthorize）：应用未获取到操作系统的摄像头权限。
- 30403（kNERtcErrMediaOpenBannedByServer）：已被服务器禁用视频。

◆ enableMediaPub:withMediaType:

- (int) enableMediaPub:	(BOOL)	enabled
withMediaType:	(NERtcMediaPubType)	mediaType

开启或关闭本地媒体流（主流）的发送。
该方法用于开始或停止向网络发送本地音频或视频数据。
该方法不影响接收或播放远端媒体流，也不会影响本地音频或视频的采集状态。

自从: V4.6.10

注解

该方法暂时仅支持控制音频流的发送。
该方法在加入房间前后均可调用。
停止发送媒体流的状态会在通话结束后被重置为允许发送。
成功调用该方法切换本地用户的发流状态后，房间内其他用户会收到 NERtcEngineDelegate#onNERtcEngineUserAudioDidStart:（开启发送音频）或 NERtcEngineDelegate#onNERtcEngineUserAudioDidStop: （停止发送音频）的回调。

相关接口

INERtcEngineEx#muteLocalAudio:：
- 在需要开启本地音频采集（监测本地用户音量）但不发送音频流的情况下，您也可以调用 muteLocalAudio(YES) 方法。
- 两者的差异在于， muteLocalAudio(YES) 仍然保持与服务器的音频通道连接，而 enableMediaPub(NO) 表示断开此通道，因此若您的实际业务场景为多人并发的大房间，建议您调用 enableMediaPub 方法。

参数

enabled	是否发布本地媒体流。 YES（默认）：发布本地媒体流。 NO：不发布本地媒体流。
mediaType	媒体发布类型，暂时仅支持音频。

返回

0：方法调用成功。
其他：方法调用失败。

◆ joinChannelWithToken:channelName:myUid:completion:

- (int) joinChannelWithToken:	(NSString *)	token
channelName:	(NSString *)	channelName
myUid:	(uint64_t)	uId
completion:	(NERtcJoinChannelCompletion)	completion

加入音视频房间。
加入音视频房间时，如果指定房间尚未创建，云信服务器内部会自动创建一个同名房间。

SDK 加入房间后，同一个房间内的用户可以互相通话，多个用户加入同一个房间，可以群聊。使用不同 App Key 的 App 之间不能互通。
成功调用该方加入房间后，远端会触发 onNERtcEngineUserDidJoinWithUserID 回调。
用户成功加入房间后，默认订阅房间内所有其他用户的音频流，可能会因此产生用量并影响计费。如果想取消订阅，可以通过调用相应的 mute 方法实现。

直播场景下的观众角色可以通过 switchChannelWithToken 快速切换房间。

参数

token	安全认证签名（NERTC Token）。可设置为： null。调试模式下可设置为 null。安全性不高，建议在产品正式上线前在云信控制台中将鉴权方式恢复为默认的安全模式。已获取的NERTC Token。安全模式下必须设置为获取到的 Token 。若未传入正确的 Token 将无法进入房间。推荐使用安全模式。
channelName	房间名称，设置相同房间名称的用户会进入同一个通话房间。字符串格式，长度为1~ 64 字节。支持以下89个字符：a-z, A-Z, 0-9, space, !#$%&()+-:;≤.,>? @[]^_{\|}~”
uId	用户的唯一标识 id，房间内每个用户的 uId 必须是唯一的。 uId 可选，默认为 0。如果不指定（即设为 0），SDK 会自动分配一个随机 uId，并在 NERtcJoinChannelCompletion 中返回，App 层必须记住该返回值并维护，SDK 不对该返回值进行维护。
completion	操作完成的 block 回调。

返回: 操作返回值，被执行了则返回 0。

◆ leaveChannel

- (int) leaveChannel

离开房间，即挂断或退出通话。
结束通话时，必须调用leaveChannel结束通话，否则无法开始下一次通话。
成功调用该方法离开房间后，本地会触发 onNERtcEngineDidLeaveChannelWithResult 回调，远端会触发 onNERtcEngineUserDidLeaveWithUserID 回调。

返回: 操作返回值，成功则返回 0

◆ setAudioProfile:scenario:

- (int) setAudioProfile:	(NERtcAudioProfileType)	profile
scenario:	(NERtcAudioScenarioType)	scenario

设置音频编码属性。

注解

该方法支持在房间内动态调用。
音乐场景下，建议将 profile 设置为 kNERtcAudioProfileHighQuality。
若您通过 INERtcEngine#setChannelProfile: 接口设置房间场景为直播模式，即 kNERtcChannelProfileLiveBroadcasting，但未调用此方法设置音频编码属性，或仅设置 profile 为 kNERtcAudioProfileDefault，则 SDK 会自动设置 profile 为 kNERtcAudioProfileHighQuality，且设置 scenario 为 kNERtcAudioScenarioMusic。

参数

profile	设置采样率、码率、编码模式和声道数。详细信息请参考 NERtcAudioProfileType。
scenario	设置音频应用场景。详细信息请参考 NERtcAudioScenarioType。

返回

0: 方法调用成功；
其他: 方法调用失败。

◆ setChannelProfile:

- (int) setChannelProfile: (NERtcChannelProfileType) channelProfile

设置房间场景。
房间场景可设置为通话或直播场景，不同的场景中 QoS 策略不同。

注解: 该方法必须在加入房间前调用，进入房间后无法再设置房间场景。

参数

channelProfile 设置房间场景。详细信息请参考 NERtcEngineEnum.NERtcChannelProfileType。

返回: 操作返回值，成功则返回 0

◆ setClientRole:

- (int) setClientRole: (NERtcClientRole) role

在直播场景中设置用户角色。
用户角色支持设置为主播或观众，主播和观众的权限不同。

主播：可以开关摄像头等设备、可以发布流、可以操作互动直播推流相关接口、上下线对其他房间内用户可见。
观众：不可以开关摄像头等设备、不可以发布流、不可以操作互动直播推流相关接口、上下线对其他房间内用户不可见。

如果你在加入频道后调用该方法切换角色，调用成功后会收到以下回调：

主播切观众，本端触发 onNERtcEngineDidClientRoleChanged 回调，远端触发 onNERtcEngineUserDidLeaveWithUserID 回调。
观众切主播，本端触发 onNERtcEngineDidClientRoleChanged 回调，远端触发 onNERtcEngineUserDidJoinWithUserID 回调。

注解

默认情况下用户以主播角色加入房间。在加入房间前，用户可以调用本接口切换本端模式为观众。在加入房间后，用户也可以通过本接口切换用户模式。
用户切换为观众角色时，SDK 会自动关闭音视频设备。

自从: V4.5.0

参数

role	用户角色。详细信息请参考 NERtcClientRole。

返回

0(kNERtcNoError): 方法调用成功。
< 0: 方法调用失败。
- 30001(kNERtcErrFatal): Engine 未创建。
- 30101(kNERtcErrChannelNotJoined): 尚未加入房间。

◆ setLocalVideoConfig:

- (int) setLocalVideoConfig: (NERtcVideoEncodeConfiguration *) config

设置视频编码属性。

可以在加入房间前或加入房间后调用此接口。
您可以通过 width 和 height 进行自定义设置摄像头采集视频的编码分辨率。详细信息请参考设置视频属性。
注解
纯音频 SDK 禁用该接口，如需使用请前往云信官网下载并替换成视频 SDK。
该方法仅适用于视频主流，若您希望为视频辅流通道设置编码属性，请调用 INERtcEngine#setLocalVideoConfig:streamType:
V4.5.0 开始，setLocalVideoConfig 方法实时生效；此前的版本中，setLocalVideoConfig 方法设置成功后，下次开启本端视频时生效。
每个属性对应一套视频参数，例如分辨率、帧率、码率等。所有设置的参数均为理想情况下的最大值。当视频引擎因网络环境等原因无法达到设置的分辨率、帧率或码率的最大值时，会取最接近最大值的那个值。
setLocalVideoConfig 为全量参数配置接口，重复调用此接口时，SDK 会刷新此前的所有参数配置，以最新的传参为准。所以每次修改配置时都需要设置所有参数，未设置的参数将取默认值。
参数

config 视频编码属性配置，详细信息请参考 NERtcVideoEncodeConfiguration。

返回
操作返回值，成功则返回 0

◆ setLocalVideoConfig:streamType:

- (int) setLocalVideoConfig:	(NERtcVideoEncodeConfiguration *)	config
streamType:	(NERtcStreamChannelType)	streamType

设置视频编码属性。
通过此接口可以设置视频主流或辅流的编码分辨率、裁剪模式、码率、帧率、带宽受限时的视频编码降级偏好、编码的镜像模式、编码的方向模式参数。

自从: V4.6.20

调用时机: 请在初始化后调用该方法，且该方法在加入房间前后均可调用。

注解

纯音频 SDK 禁用该接口，如需使用请前往云信官网下载并替换成视频 SDK。
每个属性对应一套视频参数，例如分辨率、帧率、码率等。所有设置的参数均为理想情况下的最大值。当视频引擎因网络环境等原因无法达到设置的分辨率、帧率或码率的最大值时，会取最接近最大值的那个值。
此接口为全量参数配置接口，重复调用此接口时，SDK 会刷新此前的所有参数配置，以最新的传参为准。所以每次修改配置时都需要设置所有参数，未设置的参数将取默认值。

参数说明

参数名称	类型	描述
config	NERtcVideoEncodeConfiguration	视频编码属性配置。
streamType	NERtcStreamChannelType	视频通道类型： kNERtcStreamChannelTypeMainStream：主流。 kNERtcStreamChannelTypeSubStream：辅流。

示例代码: //设置本地视频主流编码参数

NERtcEngine *coreEngine = [NERtcEngine sharedEngine];

NERtcVideoEncodeConfiguration *config = [[NERtcVideoEncodeConfiguration alloc] init];

config.width = 640;// 设置分辨率宽

config.height = 360;// 设置分辨率高

config.cropMode = kNERtcVideoCropMode16_9; // 设置裁剪格式为16:9

config.frameRate = kNERtcVideoFrameRateFps30; //视频帧率

config.minFrameRate = mMinFrameRate; //视频最小帧率

config.bitrate = mBitrate; //视频编码码率

config.minBitrate = mMinBitrate; //视频编码最小码率

config.degradationPreference = kNERtcDegradationDefault; ;//带宽受限时的视频编码降级偏好

[coreEngine setLocalVideoConfig:config streamType:kNERtcStreamChannelTypeMainStream];

//设置本地视频辅流编码参数

NERtcVideoEncodeConfiguration *subConfig = [[NERtcVideoEncodeConfiguration alloc] init];

subConfig.width = 640;

subConfig.height = 360;

subConfig.cropMode = kNERtcVideoCropMode16_9;

subConfig.frameRate = kNERtcVideoFrameRateFps30;

subConfig.minFrameRate = mMinFrameRate;

subConfig.bitrate = mBitrate;

subConfig.minBitrate = mMinBitrate;

subConfig.degradationPreference = kNERtcDegradationDefault;

[coreEngine setLocalVideoConfig:config streamType:kNERtcStreamChannelTypeSubStream];

kNERtcVideoCropMode16_9
@ kNERtcVideoCropMode16_9
16:9
Definition: NERtcEngineEnum.h:846

kNERtcDegradationDefault
@ kNERtcDegradationDefault
（默认）根据场景模式调整适应性偏好。
Definition: NERtcEngineEnum.h:523

kNERtcVideoFrameRateFps30
@ kNERtcVideoFrameRateFps30
30 fps.
Definition: NERtcEngineEnum.h:478

NERtcBaseVideoEncodeConfiguration::bitrate
NSInteger bitrate
视频编码的码率，单位为 Kbps。您可以根据场景需要，手动设置想要的码率。详细码表请参考设置视频属性。
Definition: NERtcEngineBase.h:426

NERtcBaseVideoEncodeConfiguration::frameRate
NERtcVideoFrameRate frameRate
视频编码的帧率。详细信息请参考 NERtcVideoFrameRate。
Definition: NERtcEngineBase.h:353

NERtcBaseVideoEncodeConfiguration::minFrameRate
NSInteger minFrameRate
视频编码的最小帧率。默认为 0，表示使用默认最小帧率。
Definition: NERtcEngineBase.h:363

NERtcBaseVideoEncodeConfiguration::minBitrate
NSInteger minBitrate
视频编码的最小码率，单位为 Kbps。您可以根据场景需要，手动设置想要的最小码率，若设置为0，SDK 将会自行计算处理。
Definition: NERtcEngineBase.h:436

NERtcVideoEncodeConfiguration
本地视频发送配置
Definition: NERtcEngineBase.h:503

NERtcVideoEncodeConfiguration::width
int width
视频编码分辨率，衡量编码质量，以宽x高表示。与maxProfile属性二选一。推荐优先使用自定义宽高设置。 width表示视频帧在横轴上的像素，即自定义宽。
Definition: NERtcEngineBase.h:520

NERtcVideoEncodeConfiguration::cropMode
NERtcVideoCropMode cropMode
视频画面裁剪模式，默认为 kNERtcVideoCropDefault。自定义视频输入不支持设置裁剪模式。
Definition: NERtcEngineBase.h:548

NERtcVideoEncodeConfiguration::degradationPreference
NERtcDegradationPreference degradationPreference
带宽受限时的视频编码降级偏好。详细信息请参考 NERtcDegradationPreference。
Definition: NERtcEngineBase.h:570

NERtcVideoEncodeConfiguration::height
int height
视频编码分辨率，衡量编码质量，以宽x高表示。与maxProfile属性二选一。推荐优先使用自定义宽高设置。 height表示视频帧在纵轴上的像素，即自定义高。
Definition: NERtcEngineBase.h:538

返回

0（kNERtcNoError）：方法调用成功。
其他：方法调用失败。
- 30003（kNERtcErrInvalidParam）：参数错误，比如 config 设置为空。
- 30004（kNERtcErrNotSupported）：不支持的操作，比如当前使用的是纯音频 SDK。
- 30005（kNERtcErrInvalidState）：当前状态不支持的操作，比如引擎未初始化成功。

◆ setParameters:

- (int) setParameters: (NSDictionary *) parameters

设置音视频通话的相关参数。

注解

此接口可在加入房间前后调用。使用参数 kNERtcKeyVideoPreferHWEncode、kNERtcKeyVideoPreferHWDecode 时，请在初始化前调用此接口。
此方法提供技术预览或特别定制功能，若您需要使用此接口，请咨询技术支持获取帮助。

参数

parameters 参数内容参数 key，请参阅 NERtcEngineBase.h 中的定义

返回: 操作返回值，成功则返回 0

◆ setupEngineWithContext:

- (int) setupEngineWithContext: (NERtcEngineContext *) context

创建 NERtcEngine 并初始化 NERTC SDK 服务。

注解

请确保在调用其他 API 前先调用该方法创建并初始化 NERtc 实例。
使用同一个 App Key 的 App 才能进入同一个房间进行通话或直播。
一个App Key 只能用于创建一个NERtc 实例。如需更换 App Key，必须先调用 destroyEngine 方法销毁当前实例，再调用本方法重新创建实例。
若不再使用 NERtc 实例，需要调用 destroyEngine 进行销毁。

参数

context 传入的RTC engine context对象。详细信息请参考 NERtcEngineContext。

返回: 操作返回值，成功则返回 0

◆ setupLocalVideoCanvas:

- (int) setupLocalVideoCanvas: (NERtcVideoCanvas *_Nullable) canvas

设置本地视图。
该方法设置本地视频显示信息。只影响本地用户看到的视频画面，不影响远端。 App 通过调用此接口绑定本地视频流的显示视窗（view）。在 App 开发中，通常在初始化后调用该方法进行本地视频设置，然后再加入房间。

注解

该方法在加入频道前后都能调用。
如果您希望在通话中更新本地用户视图的渲染或镜像模式，请使用 INERtcEngineEx#setLocalRenderScaleMode: 方法。

参数

canvas 视频画布。详细信息请参考 NERtcVideoCanvas。如果需要删除则传 nil。

返回

0: 方法调用成功；
其他: 方法调用失败。

◆ setupRemoteVideoCanvas:forUserID:

- (int) setupRemoteVideoCanvas:	(NERtcVideoCanvas *_Nullable)	canvas
forUserID:	(uint64_t)	userID

设置远端用户视图。
该方法绑定远端用户和显示视图，并设置远端用户视图在本地显示时的渲染模式和镜像模式，只影响本地用户看到的视频画面。

注解

如果 App 无法事先知道对方的用户 ID，可以在 APP 收到 onNERtcEngineUserDidJoinWithUserID 事件时设置。
解除某个用户的绑定视图可以把 canvas 设置为空。
退出房间后，SDK 会清除远程用户和视图的绑定关系。
如果您希望在通话中更新本地用户视图的渲染或镜像模式，请使用 INERtcEngineEx#setRemoteRenderScaleMode:forUserID: 方法。

参数

userID	远端用户 ID。
canvas	视频窗口。详细信息请参考 NERtcVideoCanvas。如果需要删除则传 nil。

返回

0: 方法调用成功；
其他: 方法调用失败。

◆ switchCamera

- (int) switchCamera

切换前置/后置摄像头。
该方法需要在相机启动后调用，例如调用 startPreview 或 joinChannel 后。

注解: 纯音频 SDK 禁用该接口，如需使用请前往云信官网下载并替换成视频 SDK。

返回: 操作返回值，成功则返回 0

◆ switchChannelWithToken:channelName:completion:

- (int) switchChannelWithToken:	(NSString *)	token
channelName:	(NSString *)	channelName
completion:	(NERtcJoinChannelCompletion)	completion

快速切换音视频房间。
房间场景为直播场景时，房间中角色为观众的成员可以调用该方法从当前房间快速切换至另一个房间。
成功调用该方切换房间后，本端会收到离开房间的回调 onNERtcEngineDidLeaveChannelWithResult；远端用户会收到 onNERtcEngineUserDidLeaveWithUserID 和 onNERtcEngineUserDidJoinWithUserID 的回调。

注解

房间成员成功切换房间后，默认订阅房间内所有其他成员的音频流，因此产生用量并影响计费。如果想取消订阅，可以通过调用相应的 subscribeRemoteAudio 方法实现。
该方法仅适用于直播场景中，角色为观众的音视频房间成员。即已通过接口 setchannelprofile 设置房间场景为直播，通过 setClientRole 设置房间成员的角色为观众。

参数

token	在服务器端生成的用于鉴权的安全认证签名（Token）。可设置为： null。调试模式下可设置为 null。安全性不高，建议在产品正式上线前在云信控制台中将鉴权方式恢复为默认的安全模式。已获取的NERTC Token。安全模式下必须设置为获取到的 Token 。若未传入正确的 Token 将无法进入房间。推荐使用安全模式。
channelName	期望切换到的目标房间名称
completion	操作完成的 block 回调

返回

0(NERtcEngineErrorCode.kNERtcNoError)：方法调用成功。
30001(NERtcEngineErrorCode.kNERtcErrFatal)：通用错误。
30003(NERtcEngineErrorCode.kNERtcErrInvalidParam)：参数错误。
30109(NERtcEngineErrorCode.kNERtcErrSwitchChannelInvalidState): 切换房间状态无效。
403(NERtcEngineErrorCode.KNERtcErrChannelReservePermissionDenied): 用户角色不是观众。
30100(NERtcEngineErrorCode.kNERtcErrChannelAlreadyJoined): 房间名无效，已在此房间中。

该协议的文档由以下文件生成:

exportHeaders/INERtcEngine.h

构造函数

详细描述

函数文档

◆ connectionState

◆ enableLocalAudio:

◆ enableLocalVideo:

◆ enableLocalVideo:streamType:

◆ enableMediaPub:withMediaType:

◆ joinChannelWithToken:channelName:myUid:completion:

◆ leaveChannel

◆ setAudioProfile:scenario:

◆ setChannelProfile:

◆ setClientRole:

◆ setLocalVideoConfig:

◆ setLocalVideoConfig:streamType:

◆ setParameters:

◆ setupEngineWithContext:

◆ setupLocalVideoCanvas:

◆ setupRemoteVideoCanvas:forUserID:

◆ switchCamera

◆ switchChannelWithToken:channelName:completion: