华为云用户手册

HWRtcRemoteAudioStateReason 表25 远端音频状态变化原因 枚举 描述 HWRtcRemoteAudioStateReasonRemoteOffline 远端用户离线 HWRtcRemoteAudioStateReasonRemoteMuted 远端用户停止音频流发送 HWRtcRemoteAudioStateReasonRemoteUnmuted 远端用户开启音频流发送 HWRtcRemoteAudioStateReasonRemoteFirstDecoded 远端用户音频首包解码

HWRtcJoinParam 表3 入会参数 属性 类型 描述 userId NSString 用户ID，支持最大长度64，支持数字、字母大小写、下划线、中线、"."字符 userName NSString 用户昵称，支持最大长度128 ctime long long 签名时间戳，单位秒，有signature时必选 authorization NSString 签名，必填，鉴权私钥请在应用管理中获取，签名的具体生成方法请参见接入鉴权。支持最大长度为1024。 role HWRtcRole 角色 optionalInfo NSString 其他信息 roomId NSString 房间Id，支持最大长度64，支持数字、字母大小写、下划线、中线字符 autoSubscribeVideo bool 是否自动订阅视频 autoSubscribeAudio bool 是否自动订阅音频 scenario HWRtcRemoteAudioMode 使用的场景 0：主动订阅（默认） 1：TopN（千人） 2：P2P 3：RTSA CMD自动订阅

辅流管理 表5 辅流管理接口 接口 描述 setRemoteAuxiliaryStreamViewRotation 设置远端辅流视图旋转角度 startRemoteAuxiliaryStreamView 开启辅流渲染视图（发起辅流选看） stopRemoteAuxiliaryStreamView 关闭辅流渲染视图（停止辅流选看） updateRemoteAuxiliaryStreamRenderMode 设置辅流视图显示模式，镜像模式 setRemoteAuxiliaryStreamViewOrientation 设置远端辅流视图方向（横竖屏）

视频管理 表3 视频管理接口 接口 描述 setupRemoteView 设置远端流渲染视图 updateRemoteRenderMode 设置远端用户视图渲染模式,镜像模式 setRemoteVideoStreamType 大小流模式，设置远端视频流类型 setPriorRemoteVideoStreamType 大小流模式，设置所有订阅的远端视频流类型 pullRemoteVideo 设置是否接收对应远端用户的视频流 pullAllRemoteVideo 设置是否接收所有用户的视频流 startRemoteStreamView 设置远端用户渲染视图（发起选看-老接口） stopRemoteStreamView 关闭远端用户的渲染视图 setRemoteVideoAdjustResolution 设置是否开启远端分辨率自适应

createConnection virtual IHRTCConnection* createConnection(const char* roomId, IHRTCConnectionEventHandler* eventHandler) = 0) 【功能说明】 通过此接口可以创建一个与房间关联的IHRTCConnection连接对象，可多次调用以创建多个IHRTCConnection连接对象。调用每个连接对象中的joinRoom方法等接口，可以实现同时加入到多个房间，完成订阅和选看多个连接房间中的用户等功能。具体请参见IHRTCConnection和事件回调（IHRTCConnectionEventHandler）目录下的有关接口和回调。 【请求参数】 roomId：房间ID。 eventHandler：IHRTCConnectionEventHandler，引擎回调句柄，指定一个回调事件。SDK通过指定的事件通知应用程序的运行事件，如加入或离开房间等。具体请参见5.3.4-事件回调（IHRTCConnectionEventHandler）。 【返回参数】 IHRTCConnection：成功返回连接对象指针，失败返回内容为空。 同一时间最多只能创建4个连接对象，每个连接对象对应的房间ID必须互不相同。加上IHRTCEngine对象，即同时最多可加入5个房间，且在这5个房间中最多只能同时有一个joiner角色，其他只能为player角色。如果使用IHRTCEngine对象加入房间，则加入房间的房间ID不能和已创建连接对象对应的房间ID相同。

修订记录 表1 修订记录 修改时间 修改说明 2022-06-21 第十七次正式发布 本次变更如下： 新增以下接口： addMultiRoomMediaRelay：添加单个跨房 removeMultiRoomMediaRelay：删除单个跨房 stopMultiRoomMediaRelay：停止所有跨房 appendLocalView：设置本地视频另一个窗口显示 appendRemoteView：设置远端视频另一个窗口显示 新增以下事件回调： onRemoteMicrophoneStateChanged：远端麦克风设备状态变更通知 onUserNetworkQualityNotify：加入房间后的用户级网络质量状态回调 新增以下数据类型： HWRtcRemoteMicState：麦克风设备状态 HRTCMultiRoomMediaRelayConfiguration：跨房配置 HR TCS rcMultiRoomMediaInfo：源房间信息 HRTCDstMultiRoomMediaInfo：目标房间信息 HRTCMultiRoomMediaRelayState：跨房状态 HRTCMultiRoomMediaRelayStateCode：跨房状态码 2022-03-24 第十六次正式发布 本次变更如下： 修改appid获取方式的相关描述。 2022-03-18 第十五次正式发布 本次变更如下： 新增setNetworkBandwidth接口 2022-02-25 第十四次正式发布 本次变更如下： 新增的接口及回调： recordingDeviceTest音频采集设备测试（只支持macOS） finishRecordingDeviceTest结束音频采集设备测试（只支持macOS） playbackDeviceTest音频播放设备测试（只支持macOS） finishPlaybackDeviceTest结束音频播放设备测试（只支持macOS）echoTest音频设备回路测试（只支持macOS） finishEchoTest结束音频设备回路测试（只支持macOS） cameraDeviceTest视频采集设备测试 finishCameraDeviceTest结束视频采集设备测试 onAudioDeviceTestVolumeNotify音频设备测试回调 startScreenShareWithAppGroup开启屏幕共享(只支持iOS) setupWithAppGroup屏幕录制启动。 broadcastFinished屏幕录制关闭。 sendVideoSampleBuffer发送屏幕录制数据。 replayBroadcastFinished主动停止屏幕录制。 2021-12-02 第十三次正式发布 本次变更如下： 优化部分文档描述。 2021-11-22 第十二次正式发布 本次变更涉及部分API的逻辑优化与融合，如joinRoom、onConnectionChangedNotify、pushLocalVideo等，具体请参见接口参考。 2021-06-05 第十一次正式发布 本次发布版本为1.8.0版本，整合了之前若干版本和分支的一个全新版本，主要变更内容为跨房功能重构，结合服务端升级，可以支持2W人超大型会议和最多同时跨5个房间互动等场景。此外，管控面和用户体验上也新增了部分功能和优化。 本次变更如下： 新增的接口及回调： changeUserName、renewAuthorization、onUserNameChangedNotify：会议中修改用户昵称的接口、签名更新的接口、修改用户昵称的回调。 onFirstRemoteAuxiliaryStreamDecoded：引擎收到第一帧远端辅流并解码成功的回调。 createConnection：加入多房间（跨房）前，与要跨入的房间先建立连接的接口，跨一个房间建立一个连接。 setRemoteAudioMode：设置音频订阅模式的接口，整合了setRemoteAudioTopNVoice和enableTopThreeAudioMode两个接口。 废弃的接口及回调： connectOtherRoom、onConnectOtherRoom、disconnectOtherRoom、onDisconnectOtherRoom：新跨房通过与对应房间先建立连接HWRtcConnection，再通过连接调用其下的joinRoom和leaveRoom接口实现跨房和退房功能，回调亦通过HWRtcConnection下属回调OnJoinRoomSuccess/Failure、OnLeaveRoom实现，具体请参见3.3.3HWRtcConnection 和3.3.4事件回调（HWRtcConnection）章节，原HWRtcEngine下属相关接口和回调已废弃。 setRemoteAudioTopNVoice、enableTopThreeAudioMode：经setRemoteAudioMode整合后已废弃。 参数变更的接口及回调： changeUserRole：不再需要roomId参数，跨房所在房间用HWRtcConnection连接调用角色切换接口，HWRtcEngine只作其所在房间的角色切换。 2021-01-28 第十次正式发布 本次变更如下： HWRtcEngine新增接口：getVersion 2020-12-25 第九次正式发布 本次变更如下： HWRtcEngine新增接口：pullRemoteVideo、pullAllRemoteVideo、enableSmallVideoStream、setPriorRemoteVideoStreamType、setRemoteVideoStreamType、setupRemoteView、setRemoteVideoAdjustResolution、setVolumeNotifyInterval 新增事件回调：onUserAuxiliaryStreamAvailable 新增数据类型：HWRtcVideoStreamType、HWRtcVideoEncodeResolutionMode 更新客户端错误码 2020-12-17 第八次正式发布 本次变更如下： 删除接口onStreamAvailable 新增接口onAuxiliaryStreamStatsNotify 本地预览画面接口修改为setupLocalVideo joinRoom回调与Windows端保持一致 2020-11-26 第七次正式发布 本次变更如下： 新增SparkRTC接入鉴权方法说明 2020-10-21 第六次正式发布 本次变更如下： HWRtcEngine新增接口：setPlaybackDevices、setRecordingDevices、getRecordDevices、startAudioFile、stopAudioFile、pauseAudioFile、resumeAudioFile、setExternalAudioCapture、setExternalVideoCapture、pushExternalAudioFrame、pushExternalVideoFrame、setExternalMediaFrameOutput 新增事件回调：onUserVolumeStatsNotify、onStartAudioFile、onStopAudioFile、onPauseAudioFile、onResumeAudioFile、onRenderExternalVideoFrame、onPlaybackExternalAudioFrame 新增数据类型：HWRTCMediaDirectionHWRtcAudioFilePlayMode、HWRtcAudioFrameType、HWRtcVideoImageFormat、HWRtcAudioFrame、HWRtcVideoFrame、HWRtcStartAudioFileParam 2020-09-04 第五次正式发布 本次变更如下： 增加视频镜像接口：，setVideoEncoderMirror 增加音视频流采集发流控制接口及流状态变化回调：enableLocalVideo，onRemoteAudioStateChangedNotify，onRemoteVideoStateChangedNotify HRtcErrorCode增加90000040~90000042错误码 增加HRTCLeaveReason，HRTCVideoMirrorType，HRTCRemoteAudioStreamState，HRTCRemoteAudioStreamStateReason，HRTCRemoteVideoStreamState，HRTCRemoteVideoStreamStateReason枚举 2020-08-17 第四次正式发布 本次变更如下： 增加选看跨房功能接口及回调：connectOtherRoom，disconnectOtherRoom，onConnectOtherRoom，onDisconnectOtherRoom 增加音频流接收选择接口：muteRemoteAudio，muteAllRemoteAudio 增加音视频流统计信息上报：onVideoStatsNotify，onAudioStatsNotify，onAuxiliaryStreamStatsNotify 增加卡顿统计信息上报：onLeaveRoom(HRT CS tatsInfo) HRtcErrorCode增加90000034~90000039错误码 服务端错误码增加RTC.32000030~RTC.32000033错误码 优化升级HRTCStatsInfo类 2020-07-03 第三次正式发布 本次变更如下： 选看远端接口修改为startRemoteStreamView，updateRemoteRenderMode，stopRemoteStreamView 增加辅流相关接口startRemoteAuxiliaryStreamView，stopRemoteAuxiliaryStreamView，setRemoteAuxiliaryStreamViewRotation，updateRemoteAuxiliaryStreamRenderMode 修改错误码等 2020-06-20 第二次正式发布 本次变更如下： SDk集成中，修改需要添加的库文件。 修改接口参考中的类、方法等内容，具体如下所示： RtcEngine类增加setVideoEncoder、changeUserRole、adjustRecordingVolume等方法。 HwRtcEngineDelegate类增加rtcEngineUserRoleChangeWithNewRole等方法。 增加HwRtcVideoEncode、HwRtcVideoStatsInfo和HwRtcEncodeStreamType类。 HwRtcStreamType枚举类增加类成员。 RtcErrorCode增加90000019~90000030的错误码。 2020-04-15 第一次正式发布 父主题： iOS/macOS SDK

connection:onMediaAddressNotify - (void)connection:(HWRtcConnection *)connection onMediaAddressNotify:(NSString * _Nonnull)mediaIpv4 mediaIpv6:(NSString * _Nonnull)mediaIpv6; 【功能说明】 加入房间成功之后，回调SFU的ipv4和ipv6地址。 【回调参数】 connection：跨房引擎 mediaIpv4：sfu ipv4地址。 mediaIpv6：sfu ipv6地址。

connection:onRejoinRoomSuccess - (void)connection:(HWRtcConnection *)connection onRejoinRoomSuccess:(NSString * _Nonnull)userid; 【功能说明】 重新加入房间回调。例如，网络异常后重连成功加入房间触发。 【回调参数】 connection：跨房引擎。 userid：用户ID。

connection:onLeaveRoom -(void)connection:(HWRtcConnection *)connection onLeaveRoom:(HWRtcLeaveReason)leaveReason statsInfo:(HWRtcStatsInfo * _Nonnull)statsInfo; 【功能说明】 离开房间，触发此回调。 【回调参数】 connection：跨房引擎。 leaveReason：离开的房间原因，具体请参见HWRtcLeaveReason。 statsInfo：卡顿统计信息，具体请参见HWRtcStatsInfo。 APP调用leaveRoom接口时，会返回HWRtcLeaveReasonUserLeaveRoom，APP可以通过以下任一方式回退到登录界面。 APP在调用leaveRoom接口时退到登录界面，或者在收到onLeaveRoom回调，且回调消息不等于HWRtcLeaveReasonUserLeaveRoom时（防止重复操作），退到登录界面。 APP只在收到onLeaveRoom消息时退到登录界面。

connection:onConnectionChangedNotify - (void)connection:(HWRtcConnection *)connection onConnectionChangedNotify:(HWRtcConnStateType)state reason:(HWRtcConnChangeReason)reason description:(NSString * _Nonnull)description; 【功能说明】 网络连接状态发生变化，触发此回调。 【回调参数】 connection：跨房引擎。 state：链接服务器状态，具体请参见HWRtcConnStateType。 reason：连接状态改变原因，具体请参见HWRtcConnChangeReason。 description：连接状态改变描述。

connection:onRemoteAudioStateChange - (void)connection:(HWRtcConnection *)connectiononRemoteAudioStateChange:(NSString * _Nonnull)roomid userid:(NSString * _Nonnull)userid state:(HWRtcRemoteAudioState)state reason:(HWRtcRemoteAudioStateReason)reason; 【功能说明】 远端用户音频流状态发生改变，会触发此回调。 【回调参数】 connection：跨房引擎。 roomid：房间ID。 userid：远端用户ID。 state：远端音频流状态，具体请参见HWRtcRemoteAudioState。 reason：远端音频流状态改变原因，具体请参见HWRtcRemoteAudioStateReason。

connection:onRenderSuccessNotify - (void)connection:(HWRtcConnection *)connectiononRenderSuccessNotify:(NSString *_Nonnull)userId isAux:(NSUInteger)isAux; 【功能说明】 用户视频流渲染成功通知回调。首帧渲染成功、分辨率变化或视频流中断后恢复触发。 【回调参数】 connection：跨房引擎。 userId：用户ID。 isAux：YES表示是辅流，NO表示不是辅流。

connection:onTopActiveSpeaker - (void)connection:(HWRtcConnection *)connection onTopActiveSpeaker:(NSString *_Nonnull)userId noStream:(BOOL)noStream; 【功能说明】 返回当前音量最大的用户ID。 【回调参数】 connection：跨房引擎 userId：用户ID。 noStream：该用户是否有视频流。

connection:onRemoteMicrophoneStateChanged - (void)connection:(HWRtcConnection *)connection onRemoteMicrophoneStateChanged:(NSString * _Nonnull)userId state:(HWRtcRemoteMicState)state; 【功能说明】 远端用户麦克风状态变更通知。 【回调参数】 connection：跨房引擎 userId：远端用户userId。 state：麦克风设备状态，具体请参见HWRtcRemoteMicState。

connection:onRemoteUserOffline - (void)connection:(HWRtcConnection *)connection onRemoteUserOffline:(NSString * _Nonnull)userId reason:(NSInteger)reason; 【功能说明】 远端用户离开跨房房间，触发此回调。 本端用户离开当前房间，会回调当前房间所有用户offline。 【回调参数】 connection：跨房引擎。 userId：离开房间的远端用户ID。 reason：远端用户离线原因，预留参数。

connection:onFirstRemoteVideoDecoded - (void)connection:(HWRtcConnection *)connection onFirstRemoteVideoDecoded:(NSString * _Nonnull)userId width:(int)width height:(int)height elapsed:(NSUInteger)elapsed; 【功能说明】 跨房引擎收到第一帧远端视频流并解码成功回调。 【回调参数】 connection：跨房引擎。 userId：用户ID。 width：视频流宽度。 height：视频流高度。 elapsed: 首帧解码后消耗的时间，单位ms。

connection:onRemoteVideoStateChange - (void)connection:(HWRtcConnection *)connectiononRemoteVideoStateChange:(NSString * _Nonnull)roomid userid:(NSString * _Nonnull)userid state:(HWRtcRemoteVideoState)state reason:(HWRtcRemoteVideoStateReason)reason 【功能说明】 远端用户视频流状态发生改变，会触发此回调。 【回调参数】 connection：跨房引擎。 roomid：房间ID。 userid：远端用户ID。 state：远端视频流状态，具体请参见HWRtcRemoteVideoState。 reason：远端视频流状态改变原因，具体请参见HWRtcRemoteVideoStateReason。

connection:onError - (void)connection:(HWRtcConnection *)connection onError:(int)errorCode errorMsg:(NSString * _Nonnull)errorMsg; 【功能说明】 发生错误，触发此回调。返回客户端错误码或者服务端错误码。 【回调参数】 connection：跨房引擎。 errorCode：错误码，具体请参见HRTCErrorCode。 errorMsg：错误信息描述。

connection:onRemoteVideoResolutionChangedNotify - (void)connection:(HWRtcConnection *)connection onRemoteVideoResolutionChangedNotify:(NSString *_Nullable)userId width:(NSInteger)width height:(NSInteger)height; 【功能说明】 远端视频大小改变回调。 【回调参数】 connection：跨房引擎。 userId：用户ID。 width：视频流宽度。 height：视频流高度。

connection:onFirstRemoteAuxiliaryStreamDecoded -(void)connection:(HWRtcConnection *)connectiononFirstRemoteAuxiliaryStreamDecoded:(NSString * _Nonnull)userId width:(int)width height:(int)height； 【功能说明】 引擎收到第一帧远端视频流并解码成功回调。 【回调参数】 connection：跨房引擎。 userId：视频流对应的用户ID。 width：视频流宽度。 height：视频流高度。

connection:onJoinRoomFailure - (void)connection:(HWRtcConnection *)connection onJoinRoomFailure:(int)errorCode errorMsg:(NSString * _Nonnull)errorMsg; 【功能说明】 加入房间失败，触发此回调。 【回调参数】 connection：跨房引擎。 errorCode：错误码，具体请参见HRTCErrorCode。 errorMsg：错误信息描述。

connection:onRemoteUserOnline - (void)connection:(HWRtcConnection *)connection onRemoteUserOnline:(NSString * _Nonnull)userId userName:(NSString * _Nonnull)userName; 【功能说明】 远端用户加入跨房房间成功，触发此回调。该回调提示有远端用户加入了跨房房间，并返回新加入用户信息。 【回调参数】 connection：跨房引擎。 userId：远端用户ID。 userName：远端用户昵称。

connection:onFirstRemoteVideoDecoded - (void)connection:(HWRtcConnection *)connection onFirstRemoteVideoDecoded:(NSString * _Nonnull)userId width:(int)width height:(int)height; 【功能说明】 跨房引擎收到第一帧远端视频流并解码成功回调。 【回调参数】 connection：跨房引擎。 userId：用户ID。 width：视频流宽度。 height：视频流高度。

connection:onUserRoleChangedNotify - (void)connection:(HWRtcConnection *)connection onUserRoleChangedNotify:(HWRtcRole)oldRole newRole:(HWRtcRole)newRole; 【功能说明】 用户跨房的房间内角色切换成功，触发此回调。 【回调参数】 connection：跨房引擎。 oldRole：切换前的角色，具体请参见HWRtcRole。 newRole：切换成功后的角色，具体请参见HWRtcRole。

connection:onUserAuxiliaryStreamAvailable - (void)connection:(HWRtcConnection *)connectiononUserAuxiliaryStreamAvailable:(NSString * _Nonnull)userId isAvailable:(BOOL)isAvailable; 【功能说明】 远端开启，停止辅流后，触发此回调。 【回调参数】 connection：跨房引擎。 userId：远端用户ID。 isAvailable：YES表示远端开启屏幕共享，NO表示远端停止屏幕共享。

connection:onFirstRemoteAuxiliaryStreamDecoded -(void)connection:(HWRtcConnection *)connectiononFirstRemoteAuxiliaryStreamDecoded:(NSString * _Nonnull)userId width:(int)width height:(int)height elapsed:(NSUInteger)elapsed; 【功能说明】 引擎收到第一帧远端视频流并解码成功回调。 【回调参数】 connection：跨房引擎。 userId：视频流对应的用户ID。 width：视频流宽度。 height：视频流高度。 elapsed：首帧解码后消耗的时间，单位ms。

客户端错误码 本章节介绍了iOS/macOS SDK的客户端错误码HWRtcErrorCode的详细信息。 表1 错误码说明 类成员 错误码 描述 错误原因 HWRtcErrorCodeSuccess 0 调用成功 - HWRtcErrorCodeSdkInternalError 90000001 sdk内部系统错误 SDK内部异常。 HWRtcErrorCodeMsgToolarge 90000002 发送的消息太大 发送消息时，消息体太大。 HWRtcErrorCodeMemNotEnough 90000003 内存不足 内存无法申请。 HWRtcErrorCodeSynsendMsgError 90000004 消息发送失败 消息队列异常，导致内部消息发送失败。 HWRtcErrorCodeParamError 90000005 参数错误 包括如下两方面： 接口入参无效。 内部参数错误。 HWRtcErrorCodeApiCalledInWrongOrder 90000006 api接口调用顺序不当 当前只有日志设置必须在初始化之前。 HWRtcErrorCodeSetupLocalViewFail 90000007 设置本地窗口失败 player场景没有本地画面，不应该设置。 HWRtcErrorCodeSetupRemoteViewFail 90000008 设置远端窗口失败 publisher场景没有远端画面，不应该设置。 HWRtcErrorCodeSetDeviceFail 90000009 设置设备失败 设置播放、录音、视频设备失败。 HWRtcErrorCodeInitializing 90000010 初始化过程中 初始化过程中，不能再做初始化或者去初始化操作。 HWRtcErrorCodeUnInitializing 90000011 去初始化过程中 去初始化过程中，不能再做初始化或者去初始化操作。 HWRtcErrorCodeLogUploading 90000012 日志正在上传 日志正在上传过程中。 HWRtcErrorCodeMediaPortError 90000013 媒体端口获取失败 音频从10010开始，视频从10020开始，尝试10次，端口被占用。 HWRtcErrorCodeWatchViewTooMuch 90000014 选看超过规格 当前支持最多设置16个设置远端窗口，若超过，则会失败。 HWRtcErrorCodeMediaCmpErr 90000015 媒体协商失败 与服务器之间媒体协商失败。 HWRtcErrorCodeServerNoResponse 90000016 服务器无响应 服务器无响应。 HWRtcErrorCodeUserRoleChangeFail 90000017 切换角色失败 切换角色失败。 HWRtcErrorCodeJoinRoomFail 90000018 加入房间失败 加入房间失败。 HWRtcErrorCodeJoinRoomStatusBusy 90000019 会议状态不是空闲态 已在房间中或正在进行网络探测。 HWRtcErrorCodejoinRoomServerError 90000020 加入房间服务器错误 加入房间服务器错误。 HWRtcErrorCodejoinRoomServiceUnreachable 90000021 加入房间服务器无法访问 加入房间服务器无法访问。 HWRtcErrorCodejoinRoomAuthFail, 90000022 加入房间验证错误 加入房间验证错误。 HWRtcErrorCodejoinRoomAuthRetry 90000023 加入房间失败 加入房间失败，鉴权重试。 HWRtcErrorCodejoinRoomClockSync 90000024 加入房间失败 加入房间失败，时钟同步。 HWRtcErrorCodejoinRoomUrlNotRight 90000025 加入房间失败 加入房间失败，url错误 HWRtcErrorCodeKickedOff 90000026 被踢出房间 相同用户ID等原因，被踢出房间。 HWRtcErrorCodeScreenShareFail 90000027 共享失败 共享失败。 HWRtcErrorCodeExtMediaOutPut 90000028 当前为外部媒体输出模式，禁用该操作 当前为外部媒体输出模式，禁用该操作。 HWRtcErrorCodeReconnectFail 90000029 重连失败 重连失败。 HWRtcErrorCodeBreakDown 90000030 服务器宕机 服务器宕机。 HWRtcErrorCodeSignatureExpired 90000031 签名已经过期 签名已经过期。 HWRtcErrorCodeSetRemoteRenderModeFail 90000032 设置远端窗口模式失败 设置远端窗口模式失败。 HWRtcErrorCodeSetRemoteAudioMuteFail 90000033 订阅或取消订阅音频失败 订阅或取消订阅音频失败。 HWRtcErrorCodeConnectOtherRoomFail 90000034 连接其他房间失败 连接其他房间失败。 HWRtcErrorCodeDisConnectOtherRoomFail 90000035 断开连接其他房间失败 断开连接其他房间失败。 HWRtcErrorCodeSetUseRoleNotAllowed 90000036 不允许角色切换 不允许角色切换。 HWRtcErrorCodeExtMediaCaptureInput 90000037 当前为第三方采集模式，禁用该操作 当前为第三方采集模式，禁用该操作。 HWRtcErrorCodeSetExtAudioCaptureFail 90000038 设置第三方音频采集失败 设置第三方音频采集失败。 HWRtcErrorCodeSetExtVideoCaptureFail 90000039 设置第三方视频采集失败 设置第三方视频采集失败。 HWRtcErrorCodeSetShareComputerSoundFail 90000040 设置共享声音开关失败 设置共享声音开关失败。 HWRtcErrorCodeSetLocalAudioMuteFail 90000041 启停上行音频流失败 启停上行音频流失败。 HWRtcErrorCodeSetLocalVideoMuteFail 90000042 启停上行视频流失败 启停上行视频流失败。 HWRtcErrorCodeUserRemoved 90000043 用户被移除 用户被移除。 HWRtcErrorCodeRoomDismissed 90000044 房间被解散 房间被解散。 HWRtcErrorCodeSetupRemoteViewFail 90000045 设置远端View失败 设置远端View失败。 HWRtcErrorCodeLocalAudioDisableFail 90000056 当前未推音频流 当前未推音频流。 HWRtcErrorCodeRoleNotSupport 90000057 当前角色不支持该操作 当前角色不支持该操作。 HWRtcErrorCodeButt 90000058 置于最后 置于最后。 RTCErrorCode 90000060 发送CMD时，目标用户不存在 发送CMD时，目标用户不存在。 RTCErrorCode 90000061 CMD没有被启用 CMD没有被启用。 父主题： 接口参考

onVideoFrameCapture - (BOOL)onVideoFrameCapture:(HWRtcVideoFrame* _Nonnull)videoFrame; 【功能说明】 原始视频回调，从接口回调中取到原始视频数据以作前处理。 【回调参数】 HWRtcVideoFrame：视频数据格式 ，具体请参见HWRtcVideoFrame。 【返回参数】 YES：处理结果成功。 NO：处理结果失败。

connection:onVideoFrameRender:videoFrame - (BOOL)connection:(HWRtcConnection *)connectiononVideoFrameRender:(NSString *_Nonnull)userid videoFrame:(HWRtcVideoFrame* _Nonnull)videoFrame 【功能说明】 原始视频数据处理后回调。 【回调参数】 connection：跨房对象。 userid：用户ID。 HWRtcVideoFrame：视频数据格式 ，具体请参见HWRtcVideoFrame。 【返回参数】 YES：处理结果成功。 NO：处理结果失败。

onVideoFrameRender - (BOOL)onVideoFrameRender:(NSString *_Nonnull)userid videoFrame:(HWRtcVideoFrame* _Nonnull)videoFrame; 【功能说明】 原始视频数据处理后回调。 【回调参数】 userid：用户ID HWRtcVideoFrame：视频数据格式 ，具体请参见HWRtcVideoFrame。 【返回参数】 YES：处理结果成功。 NO：处理结果失败。