Docs Overview/
RTC Engine/
SDK/
Android/
常见问题/
发布日志/

发布日志

此页面包含 实时音视频（TRTC）SDK 的版本历史 和 全功能（All-In-One）SDK 的版本历史，请根据您的功能需要选择适合您的 SDK。

Version 12.2 @ 2024.11.27

新特性：

Android：支持 16KB page sizes。
全平台：实时探测链路质量并自动切换更优的链路的功能。

功能优化：

Android：硬件耳返支持更多手机品牌：小米、oppo、一加、荣耀。
iOS：优化自动曝光下的对焦效果。
iOS：优化视频画面缩放后的画质效果。
全平台：优化 Speech 音质下的声音效果。

缺陷修复：

修复 MaxOS 15 audio loopback 采集失败问题。
修复 Android 设备屏幕采集授权窗口弹出失败问题。
修复 Windows 硬件编码器的兼容性问题。

接口行为调整：

iOS&Android TRTCCloud::generateCustomPTS 接口调整为静态接口。
Android、iOS 以及 Windows 对外渲染画面调整模式增加 TRTCVideoFillMode_ScaleFill 模式，详见 TRTCVideoFillMode。

Version 12.1 @ 2024.10.08

新特性：

Windows： Intel 显卡支持H.265编码和B帧编码。
Windows： Nvidia 显卡支持ROI（区域兴趣）。

功能优化：

全平台：优化降噪和回声消除算法，提升音质听感。
全平台：优化 AGC（自动增益控制）音量曲线，预防爆音。
全平台：优化纯视频场景弱网抗性。
Android：优化设备初始化参数，大幅提升音频采集稳定性。
iOS：提升通话音量音质听感。

缺陷修复：

Android： 自定义采集的视频帧旋转角度不生效问题。
修复 Android 14 屏幕分享偶现失败问题。
修复 Android 设备采集失败黑屏问题。
修复 windows 系统混音双声道效果失效问题。
修复 windows 特定设备采集无声问题。
修复 iOS/Mac 蓝牙耳机下开耳返出现杂音问题。

Version 12.0 @ 2024.8.20

新特性：

iOS：提升视频编码画质。
支持自定义混响参数设置能力。

功能优化：

移动端重力感应支持 UIFixLayout 模式。
优化极差弱网下音视频传输表现。
AI 降噪支持保护主讲人语音的能力。
移动端进房补齐当前Router类型事件。
识别不同语料进行智能编码节省带宽。
Android 支持专业声卡识别和降低主播音质损伤。
Windows SystemLoopback 支持排除某个进程混音能力。

缺陷修复：

Android：解决停止本地采集没有触发 GLContextDestory 回调的问题。
Android：解决学习机设置 ResolutionMode 无效的问题。
全平台：修复 onMixedPlayAudioFrame 在设置采样点帧长出现杂音的问题。
iOS：修复麦克风弹框期间调用 stopLocalAudio 无声问题。

接口行为调整：

文档变更：Android 14 屏幕采集接口用法变更，详见 API startScreenCapture 。
从 Android 14 版本开始，如果您不需要使用屏幕分享功能，则需要在您工程项目中的 AndroidManifest.xml 中移除屏幕分享前台服务的权限，操作如下：<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PROJECTION" tools:node="remove" /> 如果您需要使用屏幕分享功能，则需要按照 Google 的要求填写 Play 管理中心声明，参考文档如下所示。

Version 11.9 @ 2024.6.12

新特性：

全平台：优化 AI 降噪效果，大幅提升在网吧、会议等场景声音体验。
全平台：支持播放音速达全量的版权音乐，提升K歌、合唱、语聊等热门场景的互动体验。
全平台：支持播放 ape 格式的音频文件。
全平台：优化现有操作事件准确性，提升无声、声音小等异常场景排障效率。
iOS&Android：支持高清截图能力。
iOS：TXDeviceManager 新增设置采集参数接口 setCameraCapturerParam。

缺陷修复：

Android：解决麦克风采集偶现电音问题。
全平台：修复特定 BGM 格式及非法数据引起的稳定性问题。
Android：解决外放模式偶现声音小的问题。
Windows：修复偶现获取当前摄像头不对的问题。

Version 11.8 @ 2024.5.10

新特性：

iOS：支持画中画能力。

功能优化：

Android：音频兼容性问题优化，支持更加完善的机型采播选路策略。
Window：优化AI降噪性能。
Windows：单主播场景上行画质优化。
全平台：优化 Bgm 错误提示信息。
Windows：缩放效果优化。

缺陷修复：

Android：优化外放声音小badcase。
Mac：修复开 Loopback 杀进程无声问题。
Mac：修复链接HDMI、DisplayPort无声问题。
全平台：修复实验性接口打开3A无效问题。
Windows：修复不同音质类型切换导致AGC失效问题。
Android：屏幕分享适配高TargetVersion。

接口行为调整：

全平台：C++接口支持 onMixedAllAudioFrame 回调。

Version 11.7 @ 2024.3.4

新特性：

全平台：增加摄像头采集的警告码。
全平台：新增重力感应接口 setGravitySensorAdaptiveMode。
全平台：支持回调本地人声音高信息，详见 enableAudioVolumeEvaluation 。

功能优化：

全平台：优化进房流程，大幅降低二次进房耗时。
全平台：仪表盘监控单个用户端到端通话质量最大路数从 16 路提升到 50 路。
Android：优化 Android 音频采集处理策略，降低杂音率，提升声音采集效果。
iOS：优化打断恢复重启策略，降低无声率。
iOS：优化unity 3D引擎兼容性问题。
iOS：优化后置三摄、双摄采集对焦效果，提升对焦速度。

缺陷修复：

Android 修复部分漏回声case。
Android 修复部分蓝牙被打断中途外放问题。

接口行为调整：

全平台：频繁调用 switchRole 接口时，onSwitchRole 只返回最后一次调用结果。
全平台：增加摄像头采集相关警告码
错误码
描述
WARNING_CAMERA_IS_OCCUPIED = 1114
摄像头被占用
WARNING_CAMERA_DEVICE_ERROR = 1115
摄像头设备异常
WARNING_CAMERA_DISCONNECTED = 1116
摄像头无法连接
WARNING_CAMERA_START_FAILED = 1117
摄像头启动失败
WARNING_CAMERA_SERVER_DIED = 1118
系统异常
全平台：setVideoMuteImage 接口默认垫片帧率由 0fps 调整为 5fps，限定垫片最大帧率为 10fps。
iOS：setSubStreamEncoderParam 接口行为由设置屏幕分享的编码参数调整为设置辅路编码参数。
Windows:selectScreenCaptureTarget 中默认高亮颜色（highLightColor）由绿色调整为黄色。
全平台：调整重力感应相关接口：
新增接口
(void)setGravitySensorAdaptiveMode:(TRTCGravitySensorAdaptiveMode)mode;
参见接口文档
废弃接口
setVideoEncoderRotation
废弃
setVideoEncoderMirror
废弃
setGSensorMode
废弃

Version 11.6 @ 2024.1.15

新特性：

iOS：新增 `TXLivePlayer` 支持画中画。
Windows：新增 startSystemAudioLoopback 支持采集指定的第三方进程音频，详情见 startSystemAudioLoopback。

功能优化：

Android&iOS：优化使用 URL 播放 BGM 的成功率。
Windows：优化并适配 Intel HEVC 软件解码器（Quick Sync Video）。
全平台：优化低带宽条件下的音频弱网表现。
全平台：优化低带宽条件下的视频弱网表现。
全平台：优化高丢包高延时下的音质。
全平台：优化 SDK 底层逻辑，提升整体稳定性。

缺陷修复：

Android：修复频繁 `switchRoom` 时偶现首帧解码慢的问题。
Android：修复在单次会话中尝试再次 `startScreenCapture` 时偶现的画面比例不正确的问题。
Windows：修复设置竖屏分辨率时部分虚拟摄像头采集失败的问题。

Version 11.5 @ 2023.11.27

功能优化：

全平台：优化视频模块的整体性能及稳定性。
全平台：优化音频模块的整体稳定性。
全平台：优化部分 API 接口行为策略，详情见接口行为调整。
全平台：优化音频背景音乐模块整体策略及性能占用，减少背景音乐播放异常的情况。
Windows：优化 HEVC 硬件解码策略，适配 AMD、Nvidia 显卡。
Windows：优化屏幕共享整体性能，提升屏幕采集帧率及稳定性。
Android：优化 TRTC + VODPlayer 场景下的播放效果。
iOS&Mac：优化使用 Metal 进行预处理及渲染的性能。

接口行为调整：

全平台：视频设置分辨率为540P竖屏时（预期540x960），具体的编码处理分辨率由544x960调整为536x960。
全平台：背景音乐进度回调onPlayProgress回调间隔由200ms 调整为300ms。
全平台：背景音乐模块内部实现调整为单例，多实例情况下 musicID 需要全局唯一。开发者在使用子实例播放背景音乐时，请确保不同实例使用不同的 musicID。
全平台：本地录制事件状态码调整为异步返回，相关接口调用后默认返回 0，具体的状态码通过相应的事件回调获取。
全平台：启动录制事件回调onLocalRecordBegin调整以下状态码：

事件

11.5 之前版本状态码
11.5 版本状态码
录制已经启动，需要先停止录制
-1
-6
录制目录无写入权限，请检查目录权限问题
-2
-8
文件后缀名有误（比如不支持的录制格式）
-3
-2
iOS&Android：优化移动端屏幕共享连续性，在共享暂停时保留发送最后一帧，发送帧率为1 - 2fps。
iOS&Android：调整重力感应响应行为，只响应重力感应开或者关。

Version 11.4 @ 2023.08.30

新特性：

全平台：TRTCLocalRecordingParams 新增maxDurationPerFile用于控制分片录制时长，分片文件路径可通过 onLocalRecordFragment 回调获取。
Android&iOS：V2TXLivePusher 推流本地预览增加渲染模式设置接口 setRenderFillMode。
Mac：新增enableCrashMonitoring ，支持捕获 crash 信息并进行本地存储，使用时需要在项目中添加 TXCCrashMonitor.framework。

功能优化：

全平台：优化提升 IPv6 网络环境下的整体表现。
全平台：优化合唱场景下歌词精准对齐。
全平台：优化 AI 降噪算法，进一步提升降噪效果。
全平台：优化提升纯音频场景下观众拉流播放流畅度。
全平台：优化 switchRoom 切换房间的平滑性，避免闪黑帧。
Android&iOS：优化提升直播播放秒开率。
Android&iOS：优化音频采集处理策略，降低因采集设备异常导致的无声问题概率。
Android：优化麦克风被系统静默后的回调通知。
Android：优化特定 Android 定制设备重力感应适配逻辑，避免设备返回的重力感应方向错误时画面旋转角度不对。
Android：优化渲染处理方式，支持 View 双指缩放时画面实时跟随，提升浮窗播放时的用户体验。
iOS：优化后台状态下音频采集策略，降低因系统打断引起的无声问题概率。
iOS：优化提升音频设备重启速度。

Version 11.3 @ 2023.07.07

新特性：

全平台：新增视频画面梯形校正功能（仅 Professinal 版本支持），用于手动修正透视画面角度畸变。详见 `setPerspectiveCorrectionPoints`。
全平台：新增声音频谱回调，可用于声浪动画或音量频谱展示。详见 `enableAudioVolumeEvaluation` 及 `TRTCVolumeInfo`。
全平台：新增混响效果“录音棚2”，详见 `TXVoiceReverbType`。
全平台：新增混流接口 SEI 参数设置，用于转推 CDN 分发时透传 SEI。详见 `TRTCTranscodingConfig`。
Windows：新增音速达版权曲库音乐打分功能，可用于合唱实时评分，详见 `createSongScore`。
iOS&Android：新增 `startPlayMusic` 对 .ogg 格式音乐文件的支持。
Flutter：新增 `setSystemAudioLoopbackVolume` 方法（iOS）。

功能优化：

全平台：优化自适应数字增益算法，提升声音听感，增强音量稳定性，避免音量过大或过小。
全平台：优化视频秒开耗时，提升进房后视频第一帧画面的加载速度。
全平台：优化单主播推流的弱网抗性，提升网络延时抖动情况下的流畅度。
Android：优化音频采集播放逻辑，避免在部分 Android 设备上出现声音异常的问题。
Android：优化视频辅流硬编表现，提升共享屏幕的画面质量。
iOS：优化音频设备重启逻辑，减少声音中断的发生次数。
iOS&Android：TXLivePlayer 删除点播相关接口，点播视频请使用 TXVodPlayer 进行播放。

缺陷修复：

Android：修复Android 12及以上版本系统部分本地录制的视频在苹果Safari 浏览器上无法播放的问题。

Version 11.2 @ 2023.06.05

新特性：

全平台：支持合唱场景下 BGM 伴奏、原唱无缝切换，详见 `setMusicTrack`。
Android：全功能版（Professional）、直播基础版（Smart）支持x86架构，并支持通过Maven获取。
Android：满足 Android 12 及以上版本的操作系统要求，在屏幕采集时启动前台服务，详见： `enableForegroundService`。
iOS：支持在 Apple 芯片设备上通过 Xcode 模拟器运行 SDK。
Mac：支持获取屏幕窗口信息时返回宽高等信息，对齐 Windows，详见：TXCScreenSourceInfo。

功能优化:

全平台：优化合唱场景的整体音质，提升合唱效果，减少合唱延迟。
全平台：优化上下麦时的音频效果，上下麦体验更平滑。
全平台：优化极限弱网下的音频体验。
全平台：优化直播单主播推流时的弱网体验。
全平台：优化视频通话场景大小流切换过程的流畅度。
Android&iOS：优化音乐场景下的音质表现，提升合唱体验。
Android&iOS：优化不同音量类型下使用蓝牙耳机的体验。
Android：优化硬件解码延时，提升首帧体验。
Android：优化耳返功能，提升开关耳返时的体验。
Android：优化 Android 设备的采集兼容性，减少音频异常问题。
iOS：优化画质表现，提升视频体验。

缺陷修复:

Windows：修复窗口分享时偶现闪烁问题。
Mac：修复 Intel 芯片设备上使用摄像头采集时偶现的硬编码器编码画面呼吸效应问题。

TRTC SDK 发布日志10.8 @ 2022.10.27

新特性

全平台：新增搓碟音效，提供更加全面的在线 K 歌体验，详见：TXAudioEffectManager.setMusicScratchSpeedRate。

功能优化

Android：优化视频解码启动速度，有效提升画面秒开速度，最快可以达到 50ms。 全平台：优化 NTP 时间的准确性，详见：TXLiveBase.updateNetworkTime。

缺陷修复

全平台：修复下特定场景下（无音视频上行）混流机器人 回推 TRTC 房间场景中，偶现的拉流异常以及回调错误的问题。
全平台：修复观众进房后切换角色时，因网络类型变化偶现的音视频上行失败问题。
全平台：修复在断网重连过程中出现的音质切换不生效问题。
全平台：修复在断网重连过程中偶现的上行无声问题。
Android & iOS：修复当调用 muteRemoteVideoStream 时会移除最后一帧视频画面的问题。

TRTC SDK 发布日志 10.7 @ 2022.09.20

新特性

全平台：云端混流支持调整每路输入流的音量，详见 TRTCMixUser.soundLevel。
全平台：新增了 onRemoteAudioStatusUpdated 回调接口，可用于更好地识别和监控远端音频流状态。

功能优化

全平台：升级编码内核，提升屏幕分享场景的画质。
全平台：优化弱网下编码码控效果。

缺陷修复

iOS：修复 iPad 部分设备采集音量较小的问题。
Android：修复偶现连接蓝牙耳机但是声音外放的问题。
全平台：修复频繁进退房场景下偶现的 crash 问题。

TRTC SDK 发布日志10.6 @ 2022.09.09

功能优化

全平台：提升在 IPv6 网络环境下的进房速度。
全平台：优化弱网络环境下音频的恢复效率以及音画同步效果，提升通话体验。
全平台：优化弱网络环境下的连接保持能力，减少断网重连概率。
全平台：优化 Music 档位（在 startLocalAudio 时指定）下音量较小的问题，提升用户体验。
Mac：优化使用蓝牙耳机时的沟通体验，杂音更少，声音更清晰。
Android：优化立体声采集的兼容性，支持更多机型。
Android：优化偶现的漏回声问题，提升沟通体验。

缺陷修复

Android & iOS：修复在 Speech 档位（在 startLocalAudio 时指定）下偶现的漏字问题。
Mac：修复切换麦克风时偶现的回声消除失效的问题。

All-In-One SDK 10.5 @ 2022.08.24

直播功能模块

功能优化

Android：优化视频解码的内存管理，防止出现内存堆积。
Windows：优化内置麦克风的降噪效果，尤其是在音乐模式下，表现更佳。
Mac：优化开启麦克风采集时，大概率出现的杂音问题。

缺陷修复

全平台：修复 V2TXLivePlayer 在快直播拉流时，偶现 SEI 无法收到的问题。
全平台：修复 V2TXLivePlayer 在快直播拉流时，时间戳回退导致无声的问题。

短视频功能模块

缺陷修复

Android：修复 UGC 鸿蒙系统下图片转场生成的视频绿屏问题。
Android：修复编辑生成的视频长度不对的问题。
Android：修复多声道视频无法播放和重编码的问题。
Android：修复动感光波的特效在选择的时间段内只产生一次效果的问题。
Android&iOS：修复短视频录制片段回删后 BGM 播放进度不对的问题。

音视频通话功能模块

功能优化

全平台：优化 qos 策略，提升弱网体验。
iOS&Android：全链路降低延迟；优化耳返体验。
Android：优化视频解码的内存管理，防止出现内存堆积。
Windows：优化内置麦克风的降噪效果，尤其是在音乐模式下，表现更佳。
Mac：优化开启麦克风采集时，大概率出现的杂音问题。

缺陷修复

全平台：修复频繁进退不同房间时，回调事件：OnUserVideoAvailable 和 OnUserAudioAvailable 偶现异常的问题。

播放器功能模块

缺陷修复

Android&iOS：修复播放失败不带视频格式后缀短链异常。

All-In-One SDK @ 2022.07.25

直播功能模块

新特性

iOS&Android：V2TXLivePlayer 结束播放时，允许保留最后一帧。

功能优化

全平台：优化 TXLivePlayer\V2TXLivePlayer 在 FLV 拉流时，内存占用的问题。
Android：修复 TXLivePlayer\V2TXLivePlayer 拉流时，偶现卡顿的问题。
Android：优化低延迟耳返及双声道采集的兼容性。
Android：优化硬解码切软解码的策略，提升解码性能。
iOS：优化 iPad 采集音量小的问题。

缺陷修复

Android：修复 TXLivePlayer\V2TXLivePlayer 拉流时，偶现切换到软解的问题。

短视频功能模块

功能优化

Android：增加短视频编辑 setBGMLoop 接口。

缺陷修复

Android：修复视频 setWaterMark 不生效的问题。
Android：修复 TXVideoEditor 预览渲染模式不对的问题。

音视频通话功能模块

新特性

iOS&Android：自定义视频采集支持 RGBA32 格式，详见：sendCustomVideoData。
Windows&Mac：水印设置支持本地预览，详见：setWaterMark。

功能优化

Android：优化低延迟耳返及双声道采集的兼容性。
Android：优化硬解码切软解码的策略，提升解码性能。
iOS：优化 iPad 采集音量小的问题。

缺陷修复

全平台：修复偶现的进退房回调异常的问题。
Windows：修复切换分享窗口，新窗口的内容被剪裁的问题。

播放器功能模块

功能优化

Android&iOS：HLS 直播支持自适应播放。

缺陷修复

Android：修复 onNetStatus 和进度回调间隔异常 。
Android：修复播放器没有调用 setConfig 引起的空指针异常。
iOS：修复部分场景下重播卡顿问题。

All-In-One SDK 10.3 @ 2022.07.08

直播功能模块

新特性： 全平台：TXLivePlayer\V2TXLivePlayer 支持 HLS 播放。
功能优化：
全平台：优化 Music 音质下的声音效果。
全平台：优化 TXLivePlayer\V2TXLivePlayer 的 SEI 解析逻辑，兼容部分非标准 SEI。
全平台：优化 TXLivePlayer\V2TXLivePlayer 在 FLV、RTMP 拉流时，时间戳回退导致的音画不同步问题。
缺陷修复：
全平台：修复 TXLivePlayer\V2TXLivePlayer 播放部分快直播 AAC-HEv2 流时，声音异常的问题。
全平台：修复 TXLivePlayer 视频缓存计算不正确的问题。

短视频功能模块

缺陷修复:
Android：修复视频录制 setZoom 不生效的问题。
Android：修复三星s22录制失败的问题。
iOS：自定义视频预处理不回调的问题。

音视频通话功能模块

新特性：
Windows：新增录制本地录制功能，可用于在本地录制互动直播或音视频通话完整内容。详见 ITXLiteAVLocalRecord。
Windows&Mac：新增参数支持在 startMicDeviceTest 接口中开启/关闭 播放麦克风检测时麦克风采集到的声音。详见 startMicDeviceTest。
功能优化： 全平台：优化 Music 音质下的声音效果。
缺陷修复：
全平台：修复房间用户列表偶现的回调异常问题。
Windows：修复视频播放过程偶现的画面卡住问题。
Windows：修复视频播放过程偶现的播放失败问题。
Windwos：修复音频自定义采集场景中出现回声的问题。

播放器功能模块

新特性： iOS：视频播放支持画中画模式。
缺陷修复：
Android：修复硬解后台连续播放视频列表会中断问题。
Android&iOS：修复 Seek 完成事件不回调问题。

All-In-One SDK 10.2 @ 2022.06.26

直播功能模块

新特性：
全平台：TXLivePlayer\V2TXLivePlayer 拉流时，新增 License 校验。
全平台：V2TXLivePlayer 在 FLV 拉流时， 支持设定 HTTP Headers。
全平台：TXLivePusher\V2TXLivePusher 在 RTMP 推流时，允许中途变更音频编码参数。
功能优化：
全平台：优化 V2TXLivePlayer 在快直播拉流时，自适应码率的接口。
全平台：优化 V2TXLivePlayer 在快直播拉流时，重连耗时过长的问题。
全平台：优化 TXLivePlayer\V2TXLivePlayer 在 FLV、RTMP 拉流时，本地缓存偏低问题。
Android：优化 TXLivePlayer\V2TXLivePlayer 在拉流时，首帧秒开速度。
iOS：优化 iOS SDK 体积。
iOS：LiteaVSDK Live 版打包 TXLiveBase.h。
缺陷修复：
全平台：修复 TXLivePlayer 设定卡顿阈值不生效的问题。
全平台：修复 V2TXLivePusher 在 RTC 推流时，音视频首帧回调时机异常问题。
Android：修复 TXLivePlayer\V2TXLivePlayer 在拉流时，快速 stop、start 偶现黑屏的问题。

短视频功能模块

新特性：
Android：支持无音轨视频编辑。
功能优化：
Android：优化短视频编辑播放的首开速度。
缺陷修复：
Android：修复录制裁剪区域不对的问题。
Android：修复 H265 视频硬解帧宽高不对的问题。
iOS：修复短视频裁剪时间不准的问题。
iOS：修复 iOS 14 以上机型可能出现录制的杂音问题。
iOS：修复拍摄完成视频后再返回录制偶现崩溃的问题。

音视频通话功能模块

新特性：
全平台：全新推出更加灵活，且功能强大的混流转推 API。详见：startPublishMediaStream。
全平台：新增 3D 音频特效功能，详见：enable3DSpatialAudioEffect。
全平台：新增人声检测功能，当 muteLoalAudio 和 setAudioCaptureVolume 为 0 时不会影响人声检测结果。详见 enableAudioVolumeEvaluation，Tips：方便提示用户开麦。
全平台：切换角色时，增加支持权限校验的功能。详见：switchRole(TRTCRoleType role, const char* privateMapKey)。
iOS&Mac：自定义预处理的 C++ 接口，支持以纹理方式对接视频处理。
功能优化：
Android：优化耳返效果，降低延迟。
Android：优化音频的采集链路，解决部分机型存在的杂音问题。
iOS：优化上行视频处理链路，节省 CPU、GPU 占用。
Windows&Mac：优化窗口分享时的编码性能，编码宽高不再受采集窗口大小的影响。
Windows：优化性能，减少内存碎片及其分配时造成性能开销。
缺陷修复：
全平台：修复切换网络类型时，偶现的上行失败问题。
iOS：修复在部分 iOS 14系统上，本地录制文件存在的杂音问题。

播放器功能模块

功能优化： Android&iOS：优化播放过程中回调 cachedBytes、IP 地址等参数。
缺陷修复：
Android&iOS：修复硬解播放H265格式视频失败问题。
Android&iOS：修复播放 HLS 直播异常。
iOS：修复某些场景下获取 supportedBitrates 异常。