# 发版说明 (/zh-CN/solutions/iot-apaas/reference/release-notes) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ### 已知问题和局限性 [#已知问题和局限性] SDK 在 1.5.0 版本对呼叫功能进行了重构，由此对 SDK 版本之间的互通产生了以下影响： - 1.5.0 版本仅能与 1.5.0 及以上版本互通。 - 1.3.0 版本仅能与 1.3.0 及以下版本互通。 声网强烈建议你升级至 1.5.0 版本，以获取更好的体验。 ## 1.5.0 版 [#150-版] 该版本于 2023 年 6 月 28 日发布。 ### 升级必看 [#升级必看] 为提高弱网环境下呼叫出图成功率、缩短呼叫出图响应时间，该版本重构了呼叫功能。重构后的 SDK 无法与之前版本的 SDK 互通，声网推荐你升级所有的设备端和客户端。 ### 新增特性 [#新增特性] #### H.265 视频格式 [#h265-视频格式] 该版本新增了对 H.265 视频格式的支持。你可以在设备端调用 `agora_iot_cloud_record_start` 方法并将 `video_type` 设置为 `AGO_VIDEO_DATA_TYPE_H265`，从而将 H.265 格式的视频推送到云存储中。 #### 云存储视频加密公钥 [#云存储视频加密公钥] 该版本在客户端上新增了以下 API，用于加强云存储视频加密的安全性： - Android: `setPublicKey` 方法和 `onSetPublicKeyDone` 回调 - iOS: `publicKeySet` 方法 你可以在应用层自行生成公钥和私钥，再通过该方法将公钥传入 SDK。例如，只有 SDK 的公钥和你 app 的私钥都正确，用户才能查看加密视频。 #### MQTT 连接状态 [#mqtt-连接状态] 为方便获取 MQTT（消息队列遥测传输协议）模块的连接状态，该版本在 iOS 客户端新增了 `getMqttIsConnected` 方法。 #### 新增错误码 [#新增错误码] 为方便排查问题，该版本在 Android 客户端新增如下错误码： - `XERR_FILE_NO_STREAM` (`-20009`)：文件里没有数据流。 - `XERR_ACCOUNT_SET_PUBLICKEY` (`-30017`)：设置公钥失败。 - `XERR_CALLKIT_CALLDEV_FAILURE` (`-40011`)：呼叫设备失败。 - `XERR_CALLKIT_RTCTOKEN_FAILURE` (`-40012`)：生成 RTC Token 失败。 ### 改进 [#改进] #### 云存储 [#云存储] 为提升云存储的易用性，该版本在设备端进行了以下改进： - 删除了 `agora_iot_cloud_record_start` 方法中的 `record_id` 和 `end_time` 参数，并在 SDK 内部添加了对应状态参数的处理逻辑，因此你不再需要自行处理这些参数。 - 在 `ago_video_frame_t` 中增加了 `fps` 参数。SDK 会根据该参数的设置调整推送视频的速度，从而实现视频预录制，不再依赖 `agora_iot_push_video_frame` 方法的调用时间戳。 :::warning[注意] 只有在 `agora_iot_push_video_frame` 方法中设置 `push_type` 参数为 `AGO_AV_PUSH_TYPE_MASK_OSS` 时，`ago_video_frame_t` 中的 `fps` 参数才有效。 ::: #### 24 小时连续通话 [#24-小时连续通话] 该版本将单个视频通话的最大时长由 1 小时升级至 24 小时，超过上限后 SDK 会自动结束通话。 #### 来电通知 [#来电通知] 该版本在 iOS 客户端的 `ICallKitMgr.register` 方法中新增了 `incoming` 和 `memberState` 参数，你可以通过该参数获取来电的设备、用户 ID 等相关信息。 #### 音视频流录制 [#音视频流录制] 该版本在 Android 客户端中优化了开始录制的方法并新增了状态回调，具体如下： - 在 `talkingRecordStart` 方法中新增了 `outFilePath` 参数，你可以指定录制文件的存储路径。 - 提供了 `isTalkingRecording` 方法，获取是否正在录制当前通话。 - 提供了 `onRecordingError` 回调，报告录制失败的错误码。 #### DP 属性点 [#dp-属性点] 该版本在设备端中支持使用数组指针赋值 string 类型的 DP 属性点，你可以通过 `agora_dp_value_t` 的 `dp_str` 参数实现。同时，SDK 将不再自动释放 `dp_str` 参数的内存，你需要手动管理内存以避免内存泄露。 #### 最小带宽探测码率 [#最小带宽探测码率] 该版本在设备端的 `agora_iot_config_t` 中新增了 `min_possible_bitrate` 参数，你可以设置带宽探测的最小码率。当带宽探测的实际码率比 `min_possible_bitrate` 参数的设置值低时，`cb_target_bitrate_changed` 回调会返回 `min_possible_bitrate` 参数的设置值。 #### 实时消息 [#实时消息] 该版本在设备端将实时消息的长度扩展至 4096 字节，你可以通过 `agora_iot_send_rtm` 方法的 `msg_len` 参数进行设置。此外，该版本还把 `peer_uid` 参数改名为 `peer_id`。 #### 本地回放 [#本地回放] 该版本在设备端上扩展了本地回放的以下能力： - 为支持同一设备的多个客户端同时观看不同的视频回放文件，该版本在设备端 `agora_iot_file_player_callback` 类的 `cb_start_push_frame` 和 `cb_stop_push_frame` 回调中新增 `channel_name` 参数。 - 为支持发送多种格式的音视频帧到本地回放频道，该版本删除了 `agora_iot_file_video_t`、`agora_iot_file_audio_t` 和 `agora_iot_file_video_e` 数据类型，并将 `agora_iot_file_player_push_video_frame` 和 `agora_iot_file_player_push_audio_frame` 方法的 `frame` 参数分别改为 `ago_video_frame_t` 和 `ago_audio_frame_t` 类型。 ## 1.3.0 版 [#130-版] 该版本于 2023 年 2 月 16 日发布，新增了对云存储视频文件的加密。 ## 1.2.0 版 [#120-版] 该版本于 2022 年 11 月 23 日发布，主要新增如下功能： - 推送和查询告警消息、图片、视频。详见[告警服务](/zh-CN/solutions/iot-apaas/build/customize-and-extend/alarm)。 - 通过云存储服务录制告警视频。详见[云存储服务](/zh-CN/solutions/iot-apaas/build/customize-and-extend/cloud-storage)。 ## 1.1.0 版 [#110-版] 该版本于 2022 年 9 月 19 日发布，主要新增如下功能： - [通过 OTA 升级设备端固件](/zh-CN/solutions/iot-apaas/build/customize-and-extend/upgrade-ota)。 - [使用 RESTful API 对接第三方用户账号](/zh-CN/solutions/iot-apaas/reference/restful#对接自研或第三方账户系统)。 ## 1.0.0 版 [#100-版] 该版本于 2022 年 6 月 27 日发布。 该版本是声网灵隼物联网云平台（简称声网灵隼）的第一个版本，主要为音视频设备一站式上云和自主智能化开发提供连接管理、设备管理、上下行链路以及基于声网的实时音视频的呼叫管理能力。