# 修订记录 表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等，具体请参见[接口参考](https://support.huaweicloud.com/csdk-rtc/rtc_05_0051.html)。 | | 2021-06-05 | 第十一次正式发布 本次发布版本为1.8.0版本，整合了之前若干版本和分支的一个全新版本，主要变更内容为跨房功能重构，结合服务端升级，可以支持2W人超大型会议和最多同时跨5个房间互动等场景。此外，管控面和用户体验上也新增了部分功能和优化。 本次变更如下： 新增的接口及回调： - [changeUserName](https://support.huaweicloud.com/csdk-rtc/rtc_05_0055.html#rtc_05_0055__section153811943172113)、renewAuthorization、onUserNameChangedNotify：会议中修改用户昵称的接口、签名更新的接口、修改用户昵称的回调。 - onFirstRemoteAuxiliaryStreamDecoded：引擎收到第一帧远端辅流并解码成功的回调。 - [createConnection](https://support.huaweicloud.com/csdk-rtc/rtc_05_0055.html#rtc_05_0055__section27153266344)：加入多房间（跨房）前，与要跨入的房间先建立连接的接口，跨一个房间建立一个连接。 - setRemoteAudioMode：设置音频订阅模式的接口，整合了setRemoteAudioTopNVoice和enableTopThreeAudioMode两个接口。 废弃的接口及回调： - connectOtherRoom、onConnectOtherRoom、disconnectOtherRoom、onDisconnectOtherRoom：新跨房通过与对应房间先建立连接HWRtcConnection，再通过连接调用其下的joinRoom和leaveRoom接口实现跨房和退房功能，回调亦通过HWRtcConnection下属回调OnJoinRoomSuccess/Failure、OnLeaveRoom实现，具体请参见[3.3.3HWRtcConnection](https://support.huaweicloud.com/csdk-rtc/rtc_05_0066.html)和[3.3.4事件回调（HWRtcConnection）](https://support.huaweicloud.com/csdk-rtc/rtc_05_0074.html)章节，原HWRtcEngine下属相关接口和回调已废弃。 - setRemoteAudioTopNVoice、enableTopThreeAudioMode：经setRemoteAudioMode整合后已废弃。 参数变更的接口及回调： changeUserRole：不再需要roomId参数，跨房所在房间用HWRtcConnection连接调用角色切换接口，HWRtcEngine只作其所在房间的角色切换。 | | 2021-01-28 | 第十次正式发布 本次变更如下： - [HWRtcEngine](https://support.huaweicloud.com/csdk-rtc/rtc_05_0052.html)新增接口：getVersion | | 2020-12-25 | 第九次正式发布 本次变更如下： - [HWRtcEngine](https://support.huaweicloud.com/csdk-rtc/rtc_05_0052.html)新增接口：pullRemoteVideo、pullAllRemoteVideo、enableSmallVideoStream、setPriorRemoteVideoStreamType、setRemoteVideoStreamType、setupRemoteView、setRemoteVideoAdjustResolution、setVolumeNotifyInterval - 新增[事件回调](https://support.huaweicloud.com/csdk-rtc/rtc_05_0065.html)：onUserAuxiliaryStreamAvailable - 新增[数据类型](https://support.huaweicloud.com/csdk-rtc/rtc_05_0082.html)：HWRtcVideoStreamType、HWRtcVideoEncodeResolutionMode - 更新客户端错误码 | | 2020-12-17 | 第八次正式发布 本次变更如下： - 删除接口onStreamAvailable - 新增接口onAuxiliaryStreamStatsNotify - 本地预览画面接口修改为setupLocalVideo - joinRoom回调与Windows端保持一致 | | 2020-11-26 | 第七次正式发布 本次变更如下： 新增SparkRTC[接入鉴权](https://support.huaweicloud.com/csdk-rtc/rtc_05_0348.html)方法说明 | | 2020-10-21 | 第六次正式发布 本次变更如下： - [HWRtcEngine](https://support.huaweicloud.com/csdk-rtc/rtc_05_0052.html)新增接口：setPlaybackDevices、setRecordingDevices、getRecordDevices、startAudioFile、stopAudioFile、pauseAudioFile、resumeAudioFile、setExternalAudioCapture、setExternalVideoCapture、pushExternalAudioFrame、pushExternalVideoFrame、setExternalMediaFrameOutput - 新增[事件回调](https://support.huaweicloud.com/csdk-rtc/rtc_05_0065.html)：onUserVolumeStatsNotify、onStartAudioFile、onStopAudioFile、onPauseAudioFile、onResumeAudioFile、onRenderExternalVideoFrame、onPlaybackExternalAudioFrame - 新增[数据类型](https://support.huaweicloud.com/csdk-rtc/rtc_05_0082.html)：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 | 第一次正式发布 |