Flutter SDK 更新记录

接入指南 API 说明

2.5.2

tirtc_flutter: 2.5.2

优化

优化 iOS 部分真机在特定运行状态下可能出现的音频播放稳定性问题，在兼顾播放延迟与音画同步的前提下调整系统音频输出缓冲策略，提升对回调调度波动及瞬时负载变化的容错能力。

2.5.0

tirtc_flutter: 2.5.0

新增

TiRtcAudioInputOptions 新增 media 字段，可直接使用设备端 C SDK TIRTCMEDIA 的音频格式值。原有 codec 配置继续兼容，无需强制迁移。
新增原始音视频诊断采集 API，可以按 Stream ID 采集指定的下行音视频和本地上行音频，停止采集后随下一次日志上传提交。
新增当前 RTC 音频输出绑定的来源连续性指标，可查看已观察帧数、成功进入播放队列的帧数和源时间轴缺失时长。
RTC 建立连接同步失败时新增 6136（当前网络不可用）和 6137（服务地址域名无法解析）错误码，便于应用采用不同的恢复策略。

优化

优化默认音频平滑播放策略，减少网络抖动、突发到包、短时丢包或数据积压造成的卡顿和延迟累积。
强化同一 Stream ID 下的视频分辨率热切换。切换时不需要重建连接、订阅、Video Output 或渲染 View，实际渲染新画面后会回调新的尺寸。
扩展本地 MP4 保存的音频格式兼容范围，并丰富初始化、连接、媒体输入和播放时间线等诊断日志。

修复

修复异常帧时间戳或停止全部接收后重新订阅新来源时，旧播放时间线可能继续影响后续播放的问题。
修复成功生成的 MP4 或 JPEG 在相关任务、输出对象或 SDK 关闭后可能提前失效的问题。

依赖升级

Android、iOS / macOS 和 OpenHarmony / HarmonyOS NEXT 原生 SDK 依赖统一升级到 2.5.0。

2.4.1

tirtc_flutter: 2.4.1

新增

Ti 云存新增录像文件不存在（6134）和录像文件下载失败（6135）错误码；6122 明确表示录像文件已经下载，但 SDK 无法解密或解析出有效的音视频帧。

优化

Ti 云存 HTTP Debug 日志新增脱敏的请求、响应和 cURL 模板，便于定位请求参数、远端响应和下载阶段错误。
Android、iOS / macOS 和 OpenHarmony / HarmonyOS NEXT 原生 SDK 依赖统一升级到 2.4.1。

修复

Ti 云存支持播放每帧包含完整 ADTS 头的 AAC 录像。

2.4.0

tirtc_flutter: 2.4.0

新增

支持将播放中的一路视频和可选一路音频保存为本地 MP4，并将文件移动到系统媒体库。
支持将视频当前画面保存为 JPEG，可自定义保存文件名。

优化

默认启用自适应音频播放，减少网络数据突发到达后形成的播放积压和延迟。
Android、iOS / macOS 和 OpenHarmony / HarmonyOS NEXT 原生 SDK 依赖统一升级到 2.4.0。

修复

修复切换音频输出设备后，应用可能读到旧输出路由状态的问题。
修复网络波动后的追赶解码可能被误报为缓冲不足的问题。

2.3.1

tirtc_flutter: 2.3.1

修复

修复特定网络波动场景下，音视频数据在短时中断后集中到达时，播放延迟可能逐渐增大的问题。

依赖升级

Android、iOS、macOS 和 OHOS 原生依赖统一升级到 2.3.1。

2.3.0

tirtc_flutter: 2.3.0

新增

支持调节音频播放音量。
音频采集支持 Opus 和 AMR-NB 编码。
macOS 新增 x86_64（x64）架构支持。

优化

优化 Android 视频首帧和解码器启动速度，缩短首次出图等待时间。
提升日志初始化和写入稳定性。

修复

修复纯视频场景下可能出现的播放时序异常。
修复软件解码启动阶段可能被误判为失败，以及部分视频尺寸识别不准确的问题。
修复部分音频格式可能无法正常播放的问题。
修复特定连接时序下远端音视频订阅可能不生效的问题。
修复 OHOS 视频硬件解码及 macOS Universal 原生依赖的兼容问题。

依赖升级

Android、iOS、macOS 和 OHOS 原生依赖统一升级到 2.3.0。

2.2.2

tirtc_flutter: 2.2.2

新增

Flutter 客户端 SDK 首个正式版。
支持 Android、iOS、macOS、OpenHarmony / HarmonyOS NEXT 客户端接入。
支持连接目标设备、播放远端音视频、收发命令、收发流消息、手动订阅媒体和请求关键帧。
支持客户端麦克风语音对讲：应用申请麦克风权限后，可用 TiRtcAudioInput 把本地音频发布到已建立的连接。
Android 原生依赖固定为 com.tange.ai:tirtc:2.2.9。
iOS 和 macOS 原生依赖固定为 TiRTC 2.2.9。