基本使用逻辑 创建新的项目工程，导入SDK后，需要先创建引擎。 您可以在入会前进行视频编码、声音播放模式等参数的配置。 设置本地视图。 用户加入房间后，将通过回调的方式通知房间内的其他用户，收到用户加入的回调后，可以为其设置远端视图。 在会中，也可以进行切换摄像头等参数的配置。 离开房间后，需销毁对应资源。 在时序图中，单击相应接口名称可快速跳转到相应接口位置查看其使用方法。 父主题： iOS/macOS SDK

修订记录 表1 修订记录 修改时间 修改说明 2022-06-21 第十八次正式发布 本次变更如下： 新增以下接口： addMultiRoomMediaRelay：添加单个跨房 removeMultiRoomMediaRelay：删除单个跨房 stopMultiRoomMediaRelay：停止所有跨房 appendLocalView：设置本地视频另一个窗口显示 appendRemoteView：设置远端视频另一个窗口显示 新增以下事件回调： onRemoteMicrophoneStateChanged：远端麦克风设备状态变更通知 onUserNetworkQualityNotify：加入房间后的用户级网络质量状态回调 新增以下数据类型： HWRtcRemoteMicState：麦克风设备状态 HRTCMultiRoomMediaRelayConfiguration：跨房配置 HRTCSrcMultiRoomMediaInfo：源房间信息 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(HRTCStatsInfo) 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