C SDK 更新记录

2.5.0

升级注意

TIRTCCALLBACKS 末尾新增 on_sleep_wakeup_info 回调字段。升级时不能只替换动态库，必须配套更新头文件并重新编译；创建 TIRTCCALLBACKS 时应先整体清零，不使用此能力时将该字段保持为 NULL。
TiRtcInit() 会将 TGTRP 网络轮询超时时间初始化为 10 ms。需要自定义时，应在 TiRtcInit() 之后设置 TIRTC_OPT_TGTRP_POLL_TIMEOUT；此前设置的值会被初始化过程覆盖。
在使用标准 C 输出流的平台上，SDK 默认控制台日志统一输出到 stdout。只采集 stderr 的应用需要调整日志采集方式；通过 TiRtcLogSetCallback() 接入日志的应用不受影响。

新增

新增 TIRTC_SLEEP_WAKEUP_SERVER、TIRTC_SLEEP_WAKEUP_INFO 和 on_sleep_wakeup_info，用于取得低功耗休眠模块连接服务器所需的地址和登录数据。回调在 TiRtcStart() 内由调用线程同步触发，并且仅在服务端返回有效休眠参数时触发。参见接入低功耗休眠唤醒。

优化

修复

破坏性变更

移除 TiRtcLogConfig()。升级时删除旧调用，并配套更新头文件和库。需要保存或转发日志时，使用 TiRtcLogSetCallback() 接入应用日志系统，由应用负责文件写入、容量限制和滚动；日志等级仍通过 TiRtcLogSetLevel() 设置。参见配置 SDK 日志输出。

修复

升级注意

TIRTCCALLBACKS 新增 on_update_bitrate 回调字段。升级时，头文件和库必须配套更新。应用不使用视频发送码率建议功能时，on_update_bitrate 必须为 NULL。
TIRTC_OPT_NETWORK_TYPE 设为 TIRTC_NETCONN_4G 后，TIRTC_OPT_ICCID 为必填项。未在 TiRtcStart() 前提供 ICCID 时，TiRtcStart() 返回 TIRTC_E_INVALID_PARAMETER。参见配置 4G 设备的网络信息。
stream_id 仍只允许取值 0..15。2.3.0 增加了范围校验；旧应用如果使用其他值，音视频和流消息发送、关键帧请求及音视频订阅接口会返回 TIRTC_E_INVALID_PARAMETER。
2.3.0 新增 TIRTC_E_HTTP_* 错误码。旧应用如果会根据具体错误码执行重试或告警，需要补充相应处理；只判断返回值是否为 0 的应用不受影响。

新增

新增 TGTRP 实时音视频传输协议。该协议由 TiRTC 自研，针对弱网络环境进行了深度优化。传输方式由 SDK 在建立连接时自动协商，应用不需要修改现有的音视频发送逻辑。
SDK 可以根据网络可用带宽向设备应用提供视频发送码率建议。设备应用调用 TiRtcConnSetVideoBitrateParams() 设置码率参数，并在收到 on_update_bitrate 回调后调整视频编码器。参见根据网络带宽调整视频发送码率。
新增 TIRTC_OPT_TGTRP_POLL_TIMEOUT，用于设置网络轮询超时时间。增大取值可以降低系统负载，但会增加网络响应延迟。
新增 Taixin TXW82X 和 Goke GK7205V10 平台支持。

优化

on_conn_accepted 会在命令、音频和视频通道全部就绪后触发。设备应用收到回调后，可以立即使用 hconn 发送数据。
TiRtcGetBuildInfo() 现在会返回 C SDK、底层传输组件和 mbedTLS 的版本与构建时间。如果发布包写入了提交标识，返回结果中也会包含该标识。
视频发送缓冲区满或恢复时，日志会记录 stream_id、当前占用和容量上限，便于定位 TIRTC_E_BUSY。

修复

变更

优化 ESP32-S3 和 ESP32-P4 的 FreeRTOS 线程资源管理：ESP32-S3 改用 ESP-IDF 扩展任务接口管理 PSRAM 线程栈，ESP32-P4 的线程栈改为使用 PSRAM，降低其对内部 RAM 的占用。

修复

破坏性变更

设备端启动前必须通过 TiRtcSetOption(TIRTC_OPT_CLIENT_ID, ...) 设置 client_id。未设置 client_id 会导致启动失败。升级到 2.2.0 前，请为每台设备准备一个稳定的硬件或生产标识，长度为 1 到 64 个可打印 ASCII 字符，并在设备端启动时上报，具体规则见连接设备。

新增

修复