Flutter API 说明
Flutter plugin tirtc_flutter 提供客户端 Dart API，适用于用 Flutter 开发 Android、iOS、macOS、OpenHarmony / HarmonyOS NEXT 客户端。
如果你还没有完成包接入、原生工程配置或连接流程准备，先看 Flutter SDK 接入。
适用范围
TiRTC Flutter SDK 面向 Android、iOS、macOS、OpenHarmony / HarmonyOS NEXT 客户端应用。你的项目需要使用 Flutter >=3.13.0，Dart >=3.1.0 <4.0.0。
最低运行系统版本和平台要求：
- Android 5.0（API Level 21）及以上
- iOS
13.0及以上 - macOS
11.5及以上 - OpenHarmony / HarmonyOS NEXT，OpenHarmony SDK
12及以上
在 Dart 代码中导入 API
在 Dart 文件中，从 tirtc_flutter 按需导入业务代码使用的对象。示例代码使用统一导出入口。
dart
import 'package:tirtc_flutter/tirtc_flutter.dart';生命周期与调用顺序
典型客户端流程是：连接一个设备端，播放设备端音视频，并按需收发命令或发起语音对讲。主干从 TiRtc.initialize(...) 开始，以 disconnect() 和 dispose() 收尾。
初始化：传入
AppId，启动 SDK 运行时。dartawait TiRtc.initialize(TiRtcInitOptions(appId: appId));创建连接：创建
TiRtcConn，并在连接前设置状态、命令和流消息回调。dartfinal TiRtcConn conn = TiRtcConn() ..onStateChanged = handleConnStateChanged ..onCommand = handleCommand ..onStreamMessage = handleStreamMessage;准备播放：在发起连接前创建音频输出和视频输出，并指定要播放的
streamId。dartfinal TiRtcAudioOutput audioOutput = TiRtcAudioOutput(); audioOutput.attach(connection: conn, streamId: audioStreamId); final TiRtcVideoOutput videoOutput = TiRtcVideoOutput(); videoOutput.attach(connection: conn, streamId: videoStreamId);渲染视频：在界面中挂载
videoOutput.view()，让视频输出有对应的显示位置。dartWidget build(BuildContext context) => videoOutput.view();发起连接：传入目标设备的
device_id和业务服务端签发的token。dartconn.connect(remoteId: remoteId, token: token);请求媒体：连接进入
connected后，按需请求设备端发送音频流和视频流。dartconn.subscribeAudio(streamId: audioStreamId); // 连接成功后订阅音频 conn.subscribeVideo(streamId: videoStreamId); // 连接成功后订阅视频命令交互：连接进入
connected后，按需通过命令通道和设备端交换业务数据。dartconn.sendCommand(commandId: commandId, data: data); // 需要命令交互时调用 // 收到设备端命令时，在 handleCommand(commandId, data) 中处理。语音对讲（按需）：应用获得系统麦克风权限后，创建音频输入，绑定到同一条连接，并启动采集发送。
dartfinal TiRtcAudioInput talkbackInput = TiRtcAudioInput(); await talkbackInput.setOptions(talkbackOptions); await talkbackInput.attach(connection: conn, streamId: talkbackStreamId); await talkbackInput.start();收尾释放：业务结束时先释放按需创建的输入对象，再按订阅、输出、连接的顺序收尾。
dartawait talkbackInput.stop(); // 创建了 talkbackInput 时调用 await talkbackInput.detach(connection: conn); await talkbackInput.dispose(); conn.unsubscribeAudio(streamId: audioStreamId); // 停止播放时取消音频订阅 conn.unsubscribeVideo(streamId: videoStreamId); // 停止播放时取消视频订阅 audioOutput.detach(); videoOutput.detach(); audioOutput.dispose(); videoOutput.dispose(); conn.disconnect(); conn.dispose();
TiRtcInitOptions
TiRtcInitOptions 是 TiRtc.initialize(...) 的参数对象。
初始化时必须传 appId，取值为你的 AppId。
dart
const TiRtcInitOptions({
appId: '', // 必填：你的 AppId
endpoint: '', // 切换自部署云端实例或测试、联调环境时设置，例如 "https://ep-tirtc.my-domain.com"；其他情况保持空字符串
consoleLogEnabled: false, // true 时同时把 SDK 日志打印到控制台
})TiRtc
TiRtc 提供初始化和错误码名称转换入口。
dart
// 初始化 SDK。返回 0 表示成功，非 0 为错误码。
// 重复调用成功时返回 0，不会替换已生效的配置。
static Future<int> initialize(TiRtcInitOptions config)
// 把错误码转成错误名称。
static String errorToString(int code)示例：
dart
final int code = await TiRtc.initialize(
const TiRtcInitOptions(appId: 'your-app-id'),
);
if (code != 0) {
debugPrint('initialize failed: ${TiRtc.errorToString(code)} ($code)');
}TiRtcConn
TiRtcConn 表示客户端到远端设备的一条连接。创建对象不会立即发起连接；通常先设置回调，再调用 connect(...)。连接建立后，可以通过它发送命令、发送流消息、发起媒体订阅和请求视频关键帧。
音频播放和视频显示由 TiRtcAudioOutput / TiRtcVideoOutput 负责，TiRtcConn 本身不播放也不显示媒体。
状态
TiRtcConnState.idle：连接对象已创建，但还没有开始连接。TiRtcConnState.connecting：连接请求已提交，正在等待结果。TiRtcConnState.connected：连接已经建立，可收发命令、流消息，发起媒体订阅和关键帧请求。TiRtcConnState.disconnected：连接失败、对端断开或调用disconnect()后进入该状态。
属性和回调
dart
// 当前连接状态。
TiRtcConnState get state
// 连接状态变化时触发。errorCode 为 0 表示本次状态变化没有错误；非 0 为错误码。
TiRtcOnConnStateChanged? onStateChanged
// 收到设备端命令时触发。
TiRtcOnConnCommand? onCommand
// 收到设备端的流消息时触发。
TiRtcOnConnStreamMessage? onStreamMessage相关类型：
dart
typedef TiRtcOnConnStateChanged = void Function(
TiRtcConnState state,
int errorCode,
);
typedef TiRtcOnConnCommand = void Function(
int commandId,
Uint8List data,
);
typedef TiRtcOnConnStreamMessage = void Function(
int streamId,
int timestampMs,
Uint8List data,
);方法
dart
// 创建连接对象；构造函数本身不会发起连接。通常先设置回调，再调用 connect。
TiRtcConn()
// 发起连接；初始化完成并拿到连接凭证后调用。
// remoteId 是连接目标；连接设备端时传目标设备的 device_id，例如 "PRODFENGXXXX"。
// token 是业务服务端为本次连接签发的 token，二者不能为空。
// 返回 0 只表示请求已提交，最终连接结果看 onStateChanged；非 0 为错误码。
int connect({required String remoteId, required String token})
// 断开当前连接；业务结束、切换设备或重新连接前调用。对象仍可重新 connect。
int disconnect()
// 释放连接对象；确认不再使用这条连接后调用。调用后不要再使用这个实例。
void dispose()
// 在命令通道上发送自定义命令；连接进入 connected 后调用。
int sendCommand({required int commandId, required Uint8List data})
// 发送流消息；连接进入 connected 后调用。
// streamId 按 stream_id 约定使用 0..15，两端需要提前约定消息语义。
int sendStreamMessage({
required int streamId,
required int timestampMs,
required Uint8List data,
})
// 请求远端开始发送指定 streamId 的音频流；连接进入 connected 后调用。
// streamId 按 stream_id 约定使用 0..15。
// 这个方法只请求远端发送音频，不会自动播放。
// 播放远端音频前，先调用 TiRtcAudioOutput.attach(...) 指定要播放的 connection 和 streamId；然后调用 connect(...) 建立连接。
// 连接成功后，再调用 subscribeAudio(...) 请求远端发送这路音频。
int subscribeAudio({required int streamId})
// 请求远端停止发送指定 streamId 的音频流；streamId 按 stream_id 约定使用 0..15。
// 不会停止已经创建的 TiRtcAudioOutput。停止播放时再调用 TiRtcAudioOutput.detach()。
int unsubscribeAudio({required int streamId})
// 请求远端开始发送指定 streamId 的视频流；连接进入 connected 后调用。
// streamId 按 stream_id 约定使用 0..15。
// 这个方法只请求远端发送视频，不会自动显示。
// 显示远端视频前，先调用 TiRtcVideoOutput.attach(...) 指定要显示的 connection 和 streamId；然后调用 connect(...) 建立连接。
// 连接成功后，再调用 subscribeVideo(...) 请求远端发送这路视频。
int subscribeVideo({required int streamId})
// 请求远端停止发送指定 streamId 的视频流；streamId 按 stream_id 约定使用 0..15。
// 不会停止已经创建的 TiRtcVideoOutput。停止显示时再调用 TiRtcVideoOutput.detach()。
int unsubscribeVideo({required int streamId})
// 向远端请求指定视频流的关键帧；连接已建立且远端正在发送该视频流时调用。
// streamId 按 stream_id 约定使用 0..15。
int requestKeyFrame({required int streamId})示例：
dart
final TiRtcConn conn = TiRtcConn()
..onStateChanged = (TiRtcConnState state, int errorCode) {
if (errorCode == 0) {
debugPrint('conn state=$state');
return;
}
debugPrint('conn state=$state error=${TiRtc.errorToString(errorCode)} ($errorCode)');
}
..onCommand = (int commandId, Uint8List data) {
debugPrint('command=$commandId bytes=${data.length}');
};
final int code = conn.connect(remoteId: remoteId, token: token);
if (code != 0) {
debugPrint('connect failed: ${TiRtc.errorToString(code)} ($code)');
}
// 结束时：
conn.disconnect();
conn.dispose();TiRtcAudioOutputOptions
TiRtcAudioOutputOptions 配置 TiRtcAudioOutput 的音频输出参数。只需要填写要覆盖默认值的字段。
dart
const TiRtcAudioOutputOptions({
agcLevel: TiRtcAudioAgcLevel.disabled, // 自动增益等级
ansLevel: TiRtcAudioAnsLevel.disabled, // 自动噪声抑制等级
bufferStrategy: TiRtcOutputBufferStrategy.automatic, // 输出缓冲策略
// 最大输出缓冲水位，单位为毫秒；仅 automatic 有效。
// null 表示由 SDK 自动决定。
maxBufferWatermarkMs: null,
})相关枚举：
dart
// 自动增益控制等级。
enum TiRtcAudioAgcLevel {
disabled, // 关闭
low, // 低
medium, // 中
high, // 高
}
// 自动噪声抑制等级。
enum TiRtcAudioAnsLevel {
disabled, // 关闭
low, // 低
medium, // 中
high, // 高
}
// 输出缓冲策略。
enum TiRtcOutputBufferStrategy {
automatic, // SDK 根据当前平台和链路状态决定缓冲策略
noBuffer, // 不使用输出缓冲；不要同时设置 maxBufferWatermarkMs
}TiRtcAudioOutput
TiRtcAudioOutput 用来播放某条远端音频流。 播放远端音频前，先创建 TiRtcAudioOutput，调用 attach(...) 指定要播放的 connection 和 streamId，再调用 connect(...) 建立连接；连接成功后，调用 TiRtcConn.subscribeAudio(...) 请求远端发送这路音频。 attach(...) 成功只表示播放对象已经知道要播放哪路音频。如果远端还没有发送这路音频，用户仍然听不到声音。 attach(...) 只选择这路音频由哪个 TiRtcAudioOutput 播放；subscribeAudio(...) 才会请求远端发送。
状态
TiRtcAudioOutputState.idle：还没有选择要播放的远端音频流，或已经detach()。TiRtcAudioOutputState.buffering：已经选择要播放的远端音频流，正在等待可播放数据。TiRtcAudioOutputState.playing：正在播放远端音频。TiRtcAudioOutputState.failed：播放路径发生错误。
属性和回调
dart
// 当前音频播放状态。
TiRtcAudioOutputState get state
// 播放状态变化时触发。
TiRtcOnAudioOutputStateChanged? onStateChanged
// 音频输出对象发生错误时触发。
TiRtcOnAudioOutputError? onError相关类型：
dart
typedef TiRtcOnAudioOutputStateChanged = void Function(
TiRtcAudioOutputState state,
);
typedef TiRtcOnAudioOutputError = void Function(int code);方法
dart
// 创建音频输出对象。
TiRtcAudioOutput()
// 配置音频输出参数；创建对象后、attach 前调用。
// 返回 0 表示成功，非 0 为错误码；已绑定后调用会返回错误码。
int configure(TiRtcAudioOutputOptions options)
// 设置当前输出实例的相对播放音量；可以在 attach 前或播放过程中调用。
// volumePercent 必须是 0～100 的整数：0 表示静音，100 表示恢复原始音量。
// 静音不会停止音频流，也不会修改系统媒体音量。
// 返回 0 表示成功，非 0 为错误码。
int setVolume(int volumePercent)
// 指定这个输出对象要播放的远端音频流。通常在 connect 前调用；如果输出对象晚创建，也可以在连接建立后调用。
// 远端发送这路音频后，用户才会听到声音。
int attach({required TiRtcConn connection, required int streamId})
// 停止使用这个输出对象播放当前音频流；切换流或释放对象前调用。成功后状态回到 idle。
int detach()
// 释放音频输出对象；通常在 detach 后调用。调用后不要再使用这个实例。
void dispose()示例：
dart
final TiRtcAudioOutput audioOutput = TiRtcAudioOutput()
..onError = (int code) {
debugPrint('audio output error: ${TiRtc.errorToString(code)} ($code)');
};
final int code = audioOutput.attach(connection: conn, streamId: 10);
if (code != 0) {
debugPrint('audio attach failed: ${TiRtc.errorToString(code)} ($code)');
}
// 只调整当前 audioOutput，不修改系统媒体音量。
audioOutput.setVolume(0); // 静音
audioOutput.setVolume(100); // 恢复原始音量
// 结束时：
audioOutput.detach();
audioOutput.dispose();TiRtcVideoOutputOptions
TiRtcVideoOutputOptions 配置 TiRtcVideoOutput 的解码和缓冲参数。只需要填写要覆盖默认值的字段。
dart
const TiRtcVideoOutputOptions({
// 解码偏好：0 自动，1 软件解码，2 硬件解码。
// 这只是请求偏好，实际选择取决于设备、系统和视频编码格式。
decoderPreference: 0,
bufferStrategy: TiRtcOutputBufferStrategy.automatic, // 输出缓冲策略
// 最大输出缓冲水位，单位为毫秒；仅 automatic 有效。
// null 表示由 SDK 自动决定。
maxBufferWatermarkMs: null,
})相关枚举：
dart
// 输出缓冲策略。
enum TiRtcOutputBufferStrategy {
automatic, // SDK 根据当前平台和链路状态决定缓冲策略
noBuffer, // 不使用输出缓冲；不要同时设置 maxBufferWatermarkMs
}TiRtcVideoOutput
TiRtcVideoOutput 用来显示某条远端视频流。 显示远端视频前，先创建 TiRtcVideoOutput，调用 attach(...) 指定要显示的 connection 和 streamId，再调用 connect(...) 建立连接；连接成功后，调用 TiRtcConn.subscribeVideo(...) 请求远端发送这路视频。 attach(...) 成功只表示输出对象已经准备好。如果远端还没有发送这路视频，页面不会出画面。 attach(...) 只选择这路视频由哪个 TiRtcVideoOutput 显示；subscribeVideo(...) 才会请求远端发送。
状态
TiRtcVideoOutputState.idle：还没有选择要显示的远端视频流，或已经detach()。TiRtcVideoOutputState.buffering：已经选择要显示的远端视频流，正在等待可渲染数据或渲染视图准备。TiRtcVideoOutputState.rendering：正在渲染远端视频。TiRtcVideoOutputState.failed：视频输出路径发生错误。
属性和回调
dart
// 最近一次远端画面渲染尺寸。还没有画面或已经 detach 时可能为 null。
Size? get renderSize
// 播放状态变化时触发。
TiRtcOnVideoOutputStateChanged? onStateChanged
// 远端画面尺寸变化时触发。
TiRtcOnVideoOutputRenderSizeChanged? onRenderSizeChanged
// 视频输出对象发生错误时触发。
TiRtcOnVideoOutputError? onError相关类型：
dart
typedef TiRtcOnVideoOutputStateChanged = void Function(
TiRtcVideoOutputState state,
);
typedef TiRtcOnVideoOutputRenderSizeChanged = void Function(Size size);
typedef TiRtcOnVideoOutputError = void Function(int code);方法
dart
// 创建视频输出对象。
TiRtcVideoOutput()
// 设置视频输出参数；创建对象后、attach 前调用。
// 返回 0 表示成功，非 0 为错误码；需要修改参数时先 detach，再重新 setOptions 和 attach。
int setOptions(TiRtcVideoOutputOptions options)
// 指定这个输出对象要显示的远端视频流。通常在 connect 前调用；如果输出对象晚创建，也可以在连接建立后调用。
// 远端发送这路视频后，页面才会出画面。
int attach({required TiRtcConn connection, required int streamId})
// 停止使用这个输出对象显示当前视频流；切换流或释放对象前调用。成功后状态回到 idle，并清空 renderSize。
int detach()
// 返回这个输出对象对应的 Flutter 渲染视图；需要显示远端视频时在 build 中使用。
// 同一个输出对象同时只支持挂载一个 view。
Widget view()
// 释放视频输出对象和相关系统资源；通常在 detach 后调用。调用后不要再使用这个实例。
void dispose()示例：
dart
final TiRtcVideoOutput videoOutput = TiRtcVideoOutput()
..onRenderSizeChanged = (Size size) {
debugPrint('remote video size=${size.width}x${size.height}');
};
final int code = videoOutput.attach(connection: conn, streamId: 11);
if (code != 0) {
debugPrint('video attach failed: ${TiRtc.errorToString(code)} ($code)');
}
// Widget tree 中挂载：
Widget build(BuildContext context) => videoOutput.view();TiRtcAudioInputOptions
TiRtcAudioInputOptions 配置 TiRtcAudioInput 的麦克风采集和本地音频发送参数。配置会在下一次采集启动时生效；运行中调用 setOptions(...) 会返回错误码。
dart
const TiRtcAudioInputOptions({
codec: TiRtcAudioCodec.g711a, // 本地音频传输编码
sampleRate: TiRtcAudioSampleRate.rate16k, // 麦克风采样率
channels: TiRtcAudioChannelCount.mono, // 声道数；公开能力只支持单声道
aecMode: TiRtcAudioAecMode.disabled, // 回声消除模式
agcLevel: TiRtcAudioAgcLevel.disabled, // 自动增益等级
ansLevel: TiRtcAudioAnsLevel.disabled, // 自动噪声抑制等级
})相关枚举：
dart
// 本地音频传输编码。
enum TiRtcAudioCodec {
g711a,
aac,
pcm,
opus,
amr, // AMR-NB
}
// 麦克风采样率。
enum TiRtcAudioSampleRate {
rate8k,
rate16k,
}
// 声道数。公开能力只支持单声道。
enum TiRtcAudioChannelCount {
mono,
}
// 回声消除模式。
enum TiRtcAudioAecMode {
disabled, // 关闭
enabled, // 开启
}
// 自动增益控制等级。
enum TiRtcAudioAgcLevel {
disabled, // 关闭
low, // 低
medium, // 中
high, // 高
}
// 自动噪声抑制等级。
enum TiRtcAudioAnsLevel {
disabled, // 关闭
low, // 低
medium, // 中
high, // 高
}TiRtcAudioInput
TiRtcAudioInput 采集本地麦克风声音，并通过已建立的连接发送给远端设备。常见用途是语音对讲或语音回复。
应用需要自己申请麦克风权限；SDK 不会替应用弹出系统权限申请框。
状态
TiRtcInputState.idle：输入对象已创建，但还没有开始采集。TiRtcInputState.running：正在采集并传输本地音频。TiRtcInputState.stopped：已停止采集；当前绑定仍可保留给后续start()复用。TiRtcInputState.failed：采集或传输路径发生错误。
属性和回调
dart
// 当前本地音频输入状态。
TiRtcInputState get state
// 输入状态变化时触发。
TiRtcOnInputStateChanged? onStateChanged
// 本地音频输入发生错误时触发。message 可能为空。
TiRtcOnInputError? onError相关类型：
dart
typedef TiRtcOnInputStateChanged = void Function(
TiRtcInputState state,
);
typedef TiRtcOnInputError = void Function(
int code,
String? message,
);方法
dart
// 创建本地音频输入对象。
TiRtcAudioInput()
// 设置下次采集使用的参数；创建对象后、start 前调用。
// 返回 0 表示成功，非 0 为错误码；正在采集时调用会返回错误码。
Future<int> setOptions(TiRtcAudioInputOptions options)
// 把本地麦克风音频通过指定连接和 streamId 发送给远端设备。
// 连接必须已进入 connected；在 start 前调用，streamId 使用 0..15。
// 重复相同绑定返回 0；更换连接或 streamId 前先 detach。
Future<int> attach({required TiRtcConn connection, required int streamId})
// 开始麦克风采集和传输；返回 0 表示成功，非 0 为错误码。
// 调用 start 前，应用必须确保已经获得系统麦克风权限；SDK 不负责申请该权限。
// 还没有 attach 时会返回错误码。
Future<int> start()
// 停止采集和传输，但保留当前绑定；已经停止时调用也返回 0。
Future<int> stop()
// 移除当前连接上的本地音频绑定；停止发送、切换连接或切换 streamId 前调用。
// 运行中先 stop 再 detach。
Future<int> detach({required TiRtcConn connection})
// 释放本地音频输入对象并清理绑定；通常在 stop 和 detach 后调用。调用后不要再使用这个实例。
Future<void> dispose()示例：
dart
final TiRtcAudioInput input = TiRtcAudioInput()
..onError = (int code, String? message) {
debugPrint('audio input error: ${TiRtc.errorToString(code)} ($code) ${message ?? ''}');
};
final int attachCode = await input.attach(connection: conn, streamId: 14);
if (attachCode == 0) {
await input.start();
}
// 结束时：
await input.stop();
await input.detach(connection: conn);
await input.dispose();TiRtcLogging
TiRtcLogging 用于上传当前 SDK 日志。排查问题时，把上传成功返回的 logId 提供给支持人员。
dart
// 上传当前 SDK 日志；code == 0 且 logId != null 表示上传成功。
static Future<({int code, String? logId})> upload()示例：
dart
final ({int code, String? logId}) result = await TiRtcLogging.upload();
if (result.code == 0 && result.logId != null) {
debugPrint('TiRTC logId=${result.logId}');
}错误码
下表列出 Flutter SDK 公开方法和回调可能返回的全部错误码。0 表示成功；收到非 0 错误码时，找到对应行并按“解决方案”处理。
如果按表处理后问题仍然存在，或者“解决方案”要求上传日志，请按照收集 SDK 日志中的 Flutter 示例上传 SDK 日志。联系技术支持时，一并提供错误码、SDK 版本、运行平台、问题发生时间、最短复现步骤和返回的 logId。日志上传失败时，记录上传接口返回的错误码，并按该文档准备其余排查信息。
Flutter 在不同系统上使用对应的采集、渲染和系统音频能力。少数 1000～1019 错误码在 Android 上有平台特定含义。下表已经把这些差异写在对应行中，业务代码只需按当前运行平台处理。
| 错误码 | 错误说明 | 解决方案 |
|---|---|---|
0 | 操作成功。 | 无需处理。 |
1000 | SDK 的本地库未能加载，当前功能不可用。 | 确认 Flutter 包和当前平台的 TiRTC 原生依赖已完整集成，清理构建缓存并重新安装应用。 |
1001 | 当前平台操作失败，SDK 无法继续完成当前调用。 | 释放并重新创建相关对象后重试；如果仍然失败，请上传日志并提供错误发生前的调用步骤。 |
1002 | Android 上传入采集或渲染能力的参数不合法。 | 对照当前 Flutter 方法说明检查参数范围；不要绕过 Dart API 直接传递原生参数。 |
1003 | SDK 无法创建或访问日志目录。 | 检查应用存储空间和目录访问状态，确认应用数据目录可写，然后重新初始化 SDK。 |
1004 | Android 上的平台能力尚未完成初始化。 | 先等待 TiRtc.initialize(...) 成功，再创建或使用音视频输入和渲染对象。 |
1005 | SDK 尚未完成初始化。 | 先调用 TiRtc.initialize(...)，确认返回 0 后再创建或使用其他对象。 |
1006 | Android 上的采集或渲染对象已经释放。 | 不要继续使用该实例；重新创建对象，并避免在 dispose() 后仍发起异步调用。 |
1007 | SDK 关闭时仍有对象未释放；在 Android 视频渲染场景中，也可能表示视图已经绑定到其他对象。 | 关闭 SDK 前释放所有输入、输出和连接；绑定视图失败时，先解除旧绑定再重试。 |
1008 | 当前对象已经释放；在少数 Android 采集调用中，也可能表示对象正在使用。 | 先确认对象没有被 dispose()；对象仍有效时，停止采集或解除绑定，等待当前调用完成后重试。 |
1009 | Android 上的输入对象尚未启动。 | 先完成配置和绑定，再调用 start()；只有启动成功后才执行依赖该状态的操作。 |
1010 | 视频视图已经绑定到其他对象；在少数 Android 采集调用中，也可能表示连接尚未建立。 | 先解除旧视图绑定；如果当前操作涉及发送，等待连接状态进入 connected 后再试。 |
1011 | Android 上的输入或输出对象尚未绑定。 | 先调用对应的 attach(...)，确认返回 0 后再启动或处理媒体。 |
1012 | Android 上的当前操作不能从所在线程调用。 | 让 Flutter 组件保持挂载，并在界面生命周期有效时执行预览或视图绑定。 |
1013 | Android 上缺少当前操作需要的系统权限。 | 在宿主应用中申请并确认相机或麦克风等权限已经授予，再重试当前操作。 |
1014 | Android 上的相机不可用。 | 确认设备存在目标相机、相机未被其他应用占用且权限已授予；必要时切换前后摄像头。 |
1015 | Android 上的麦克风不可用。 | 确认麦克风权限已授予、设备麦克风可用且未被其他应用独占，然后重新创建音频输入。 |
1016 | Android 上的视频渲染目标不可用。 | 等待 Flutter 视频组件完成创建并保持挂载后重新绑定；页面销毁时及时释放对应对象。 |
1017 | Android 上的视频输出与渲染目标绑定失败。 | 先释放旧视图绑定并重新挂载视频组件；仍失败时重新创建视频输出。 |
1018 | Android 上的相机采集或编码链路启动失败。 | 检查相机权限和占用情况，降低分辨率、帧率或码率后重试；仍失败时上传日志。 |
1019 | Android 设备不支持所选编解码格式。 | 改用 Flutter API 支持的其他编解码格式，或更换支持该格式的设备。 |
1100 | OpenHarmony / HarmonyOS 上的参数不合法。 | 对照当前 Flutter 方法说明检查参数范围、对象关系和组件状态。 |
1101 | OpenHarmony / HarmonyOS 上当前操作关联的对象不可用。 | 检查对象是否已经释放，重新创建相关对象并按正确顺序调用。 |
1102 | OpenHarmony / HarmonyOS 上的视频渲染目标不可用。 | 等待视频组件完成创建并保持挂载后重新绑定；页面销毁时及时释放对应对象。 |
1103 | OpenHarmony / HarmonyOS 上的视频输出与渲染目标绑定失败。 | 先解除旧绑定并重新挂载视频组件；仍失败时重新创建视频输出。 |
1104 | OpenHarmony / HarmonyOS 上的对象已经绑定。 | 复用现有绑定，或先调用对应的解绑方法，成功后再绑定新对象。 |
1105 | OpenHarmony / HarmonyOS 上的对象正在使用。 | 先停止采集或播放并解除现有绑定，等待进行中的调用完成后再重试。 |
1106 | OpenHarmony / HarmonyOS 上的输入或输出对象尚未绑定。 | 先调用对应的 attach(...)，确认返回 0 后再启动或处理媒体。 |
1107 | OpenHarmony / HarmonyOS 上缺少当前操作需要的系统权限。 | 在宿主应用中申请并确认相机或麦克风等权限已经授予，再重试当前操作。 |
1108 | OpenHarmony / HarmonyOS 平台能力当前不可用。 | 确认设备和系统版本满足要求，重新创建相关对象；仍失败时上传日志。 |
6000 | 传入的参数、取值范围或对象关系不合法。 | 对照当前方法说明检查必填参数、数值范围、streamId、数据长度和对象绑定关系。 |
6001 | SDK 尚未初始化。 | 先调用 TiRtc.initialize(...)，确认返回 0 后再调用其他 API。 |
6004 | 当前运行环境不支持 SDK 需要的任务调度方式。 | 确认使用了适配当前平台和系统版本的 SDK；如果没有修改过相关运行配置，请上传日志。 |
6005 | SDK 组件版本不一致，完整性校验未通过。 | 确认 Flutter 包及各平台 TiRTC 依赖来自同一版本，清理缓存并重新构建、安装应用。 |
6006 | 目标对象已经停止。 | 无需重复停止；如需继续使用，按文档重新配置并启动对象。 |
6007 | 目标对象已经销毁。 | 重新创建对象，不要继续持有或调用已经销毁的实例。 |
6008 | 当前应用或设备的 TiRTC 授权无效。 | 核对使用的应用、设备和授权信息；确认无误后联系技术支持检查授权状态。 |
6009 | 当前传输操作等待超时。 | 检查客户端与设备端网络，确认远端在线；网络恢复后重试，连接已断开时重新连接。 |
6010 | 传输通道正忙，常见原因是发送过快或缓冲区已满。 | 降低发送频率或单次数据量，等待通道恢复后重试，避免无间隔地连续重发。 |
6011 | 连接因心跳或等待响应超时而关闭。 | 检查网络连通性和远端运行状态，获取仍然有效的 token 后重新连接。 |
6012 | 远端主动关闭了连接。 | 确认远端是否退出或重启；需要继续通信时，等待远端恢复后重新连接。 |
6013 | 连接因其他传输错误关闭。 | 检查网络和远端状态后重新连接；如果频繁出现，请上传双方日志。 |
6014 | 连接使用的 token 已过期。 | 从业务服务端重新获取 token，再发起连接；不要重复使用已过期的 token。 |
6015 | SDK 无法访问日志或诊断文件目录。 | 检查应用存储空间和目录可写状态，修复后重新初始化或重新执行日志操作。 |
6016 | 日志或媒体数据导出任务已经在进行。 | 等待当前任务结束后再启动下一次，不要同时发起重复导出。 |
6017 | 传输资源不足，无法继续创建连接或处理数据。 | 释放不再使用的连接和媒体对象，降低并发量，等待资源恢复后重试。 |
6018 | 云端服务返回错误。 | 稍后重试；如果持续失败，请确认服务状态并上传日志。 |
6019 | SDK 处理网络连接时发生内部错误。 | 断开并重新建立连接；仍然失败时上传日志，并提供发生时间和远端标识。 |
6020 | 当前连接方式缺少必需的密钥。 | 在建立连接或启动连接服务前补充文档要求的凭据；如果当前场景不需要配置密钥，请上传日志。 |
6021 | 收到的服务端响应无法识别。 | 检查自定义服务地址和网络代理是否正确，升级到最新 SDK 后重试；仍失败时上传日志。 |
6022 | SDK 已经初始化。 | 复用当前 SDK 实例，不要在同一生命周期内重复初始化或替换初始化参数。 |
6023 | 当前方法不能从所在线程调用。 | 按对应方法要求切换到主线程或对象所属线程后重试。 |
6024 | 当前操作没有获得所需权限。 | 在宿主应用中申请并确认相机、麦克风或存储等相关权限已经授予。 |
6025 | 当前对象已经绑定。 | 复用现有绑定，或先调用对应的 detach(...)，成功后再绑定新对象。 |
6026 | 当前对象正在使用，不能执行本次操作。 | 先停止采集或播放并解除现有绑定，等待进行中的调用完成后再重试。 |
6027 | 当前对象尚未启动。 | 先完成配置和绑定，再调用对应的启动方法。 |
6028 | 连接尚未建立。 | 等待连接状态进入 connected 后再发送、订阅或启动已绑定的输入。 |
6029 | 当前输入或输出对象尚未绑定。 | 先调用对应的 attach(...)，确认成功后再启动或处理媒体。 |
6030 | 当前对象尚未完成必要配置。 | 先设置当前功能要求的参数，确认配置成功后再启动。 |
6031 | 当前设备或媒体通道尚未打开。 | 先调用对应的打开或启动方法；如果已经调用过，请检查前一步的返回值。 |
6032 | 初始化缺少 AppId。 | 传入有效且非空的 AppId，再重新初始化 SDK。 |
6033 | 当前设备没有可用的视频编码能力。 | 尝试降低分辨率和帧率、改用其他编码格式，或更换支持该能力的设备。 |
6034 | 当前视频编码格式不受支持。 | 改用 SDK 和当前设备共同支持的视频编码格式。 |
6035 | 视频编码器初始化失败。 | 降低分辨率、帧率或码率，切换编码格式后重新创建视频输入；仍失败时上传日志。 |
6036 | 当前视频流的编码格式无法解码。 | 让远端改用受支持的编码格式，或切换当前设备可用的解码方式。 |
6037 | 当前设备没有可用的视频解码能力。 | 尝试切换软硬件解码偏好、降低视频规格，或更换支持该格式的设备。 |
6038 | 视频解码器初始化失败。 | 重新创建视频输出并重试；仍失败时切换解码偏好或降低远端视频规格。 |
6039 | 视频解码器无法使用当前码流配置。 | 确认远端发送完整、受支持的码流，重新订阅并请求关键帧；仍失败时检查发送端配置。 |
6040 | 视频解码过程中发生错误。 | 请求关键帧或重新创建视频输出；如果持续出现，请上传日志并检查远端码流。 |
6041 | 视频输出没有可用的渲染目标。 | 挂载并保持有效的视频视图或纹理后重新绑定，页面销毁时及时解绑。 |
6042 | 视频帧渲染失败。 | 确认渲染视图仍然有效并重新挂载视频组件；重新绑定或重新创建视频输出。 |
6043 | SDK 可用资源不足。 | 释放不再使用的对象，降低并发连接、分辨率或缓冲规模后重试。 |
6044 | 无法打开所需文件。 | 检查文件是否存在、路径是否正确以及应用是否有访问权限。 |
6045 | 读取文件失败。 | 确认文件完整、可读且存储设备状态正常，然后重试。 |
6046 | 写入文件失败。 | 确认目标目录可写且剩余空间充足，清理空间后重试。 |
6047 | HTTP 请求失败。 | 检查网络、自定义服务地址、代理和证书配置，网络恢复后重试。 |
6048 | 导出日志失败。 | 检查日志目录和可用存储空间，结束其他导出任务后重试。 |
6049 | 上传日志失败。 | 检查网络后重新上传；仍然失败时，记录本错误码，并按照收集 SDK 日志准备其余排查信息。 |
6050 | 上传文件到存储服务失败。 | 检查网络并重新发起上传；如果凭证已过期，请重新开始整个上传流程。 |
6051 | 无法打开麦克风输入。 | 确认麦克风权限已授予、麦克风未被其他应用占用，然后重新创建音频输入。 |
6052 | 麦克风采集过程中发生错误。 | 停止并重新创建音频输入，检查系统音频设备和路由；仍失败时上传日志。 |
6053 | 无法打开音频播放设备。 | 检查系统音频设备和音频会话是否可用，然后重新创建音频输出。 |
6054 | 音频播放过程中发生错误。 | 重新创建音频输出并检查系统音频会话和路由；仍失败时上传日志。 |
6055 | 音频处理模块初始化失败。 | 检查采样率、声道数和音频处理参数组合，改用受支持的配置后重试。 |
6056 | 音频处理过程中发生错误。 | 重新创建音频输入或输出；可先关闭可选音频处理能力以确认问题范围。 |
6057 | 视频编码过程中发生错误。 | 降低视频规格并重新创建视频输入；仍失败时切换编码格式或上传日志。 |
6058 | 视频预处理过程中发生错误。 | 重新创建视频输入并降低分辨率或帧率；仍失败时上传日志。 |
6059 | 无法打开摄像头。 | 确认相机权限已授予、摄像头未被占用，并检查所选前后摄像头是否存在。 |
6060 | 摄像头采集过程中发生错误。 | 停止并重新创建视频输入；检查相机是否被系统或其他应用中断。 |
6061 | 无法打开视频输出。 | 确认视频组件和解码配置有效，重新创建并绑定视频输出。 |
6062 | 无法创建本地音视频发送通道。 | 确认连接、输入对象和媒体参数有效，释放旧对象后重新创建并绑定。 |
6063 | 本地音视频发送通道启动失败。 | 等待连接成功并确认输入已经绑定，然后重新启动输入。 |
6064 | 下行视频或音频数据解码失败。 | 确认远端发送受支持且完整的媒体数据，重新订阅或重新创建输出。 |
6065 | 保存诊断用的原始媒体数据失败。 | 检查目标目录权限和剩余空间，停止其他导出任务后重试。 |
6066 | SDK 在处理当前操作时发生内部错误。 | 释放并重新创建相关对象后重试；如果仍然失败，请上传日志。 |
6067 | SDK 日志写入失败。 | 检查日志目录是否可写以及存储空间是否充足，修复后重新初始化。 |
6068 | 音频编码过程中发生错误。 | 检查音频参数，重新创建音频输入；仍失败时切换编码格式或上传日志。 |
6069 | 音频解码过程中发生错误。 | 确认远端音频格式受支持，重新订阅或重新创建音频输出。 |
6070 | 当前 SDK 或系统环境没有可用的 HTTP 客户端。 | 使用包含网络能力的正式 SDK 包并确认系统网络组件可用；仍失败时联系技术支持。 |
6071 | 当前环境不支持 HTTPS/TLS 请求。 | 升级系统或 SDK，或改用支持 TLS 的运行环境；不要绕过生产环境的安全连接要求。 |
6072 | 日志上传凭证已经过期。 | 重新调用日志上传接口，让 SDK 获取新的上传凭证。 |
6074 | 本地视频预览已经被其他对象占用。 | 先解除已有预览绑定，再把预览绑定到当前视频输入。 |
6075 | 当前连接还没有可用的远端标识。 | 等待连接完全建立后再绑定媒体；连接已断开时重新连接。 |
6076 | 接收的媒体数据已经积压，当前设备处理速度跟不上接收速度。 | 降低远端码率、分辨率或帧率，减少同时播放的流，并检查设备负载。 |
6077 | 接收媒体的播放或渲染目标尚未就绪。 | 确认视频组件或音频输出已经准备好并保持有效，等待目标就绪后再继续。 |
6078 | 连接对象无效或已经失效。 | 停止使用旧连接对象，重新创建并建立连接，再重新绑定输入输出。 |
6079 | 视频编码器暂时无法接收新的画面。 | 降低本地视频帧率或分辨率，停止并重新创建视频输入；不要立即连续重试。 |
6080 | 视频编码结果尚未就绪。 | 等待后重试；如果持续出现，请降低本地视频规格并重新创建视频输入。 |
6081 | 视频解码器暂时不能接收当前数据，或还在等待完整的码流参数。 | 重新订阅或请求关键帧；持续出现时重新创建视频输出并降低远端视频规格。 |
6082 | 视频解码结果尚未就绪。 | 等待后重试；持续出现时请求关键帧并重新创建视频输出。 |
6083 | 当前视频输入模式与创建对象时使用的模式不一致。 | 停止并重新创建视频输入；如果没有切换过输入模式，请上传日志。 |
6084 | 发起连接失败，连接请求没有正常进入执行阶段。 | 检查 remoteId、token、当前连接状态和网络；必要时重新创建连接对象。 |
6085 | 当前连接状态不允许执行断开操作。 | 等待正在进行的连接或断开流程结束，再根据最新状态决定是否重试。 |
6086 | HTTP 传输过程失败。 | 检查网络、代理、DNS 和证书配置，恢复后重新执行当前网络操作。 |
6087 | 日志上传服务返回的地址信息无效。 | 确认服务地址和网络代理正确，升级 SDK 后重试；仍然失败时，记录本错误码，并按照收集 SDK 日志准备其余排查信息。 |
6088 | 日志上传服务返回的凭证信息无效。 | 重新发起日志上传；持续失败时，记录本错误码，并按照收集 SDK 日志准备其余排查信息。 |
6089 | 传输服务返回了当前 SDK 无法识别的状态。 | 升级 SDK 并重新连接；仍失败时上传日志，提供发生时间和远端标识。 |
6090 | 传输服务报告了其他连接错误。 | 检查网络和远端状态后重新连接；如果频繁出现，请上传双方日志。 |
6091 | 当前操作所需的对象不可用。 | 检查对象是否已经释放以及调用顺序是否正确，重新创建相关对象后重试。 |
6092 | 音频处理模块的当前状态不允许执行该操作。 | 按“配置—绑定—启动”的顺序调用；需要改配置时先停止当前输入或输出。 |
6093 | 音频处理参数配置失败。 | 改用文档支持的采样率、声道数和处理级别组合后重试。 |
6094 | 音频数据处理失败。 | 重新创建音频对象；可先关闭可选音频处理能力，仍失败时上传日志。 |
6095 | 视频编码器的当前状态不允许执行该操作。 | 按正确顺序配置并启动编码；需要改参数时先停止并重新创建视频输入。 |
6096 | 视频编码器拒绝了当前画面。 | 降低本地视频分辨率或帧率并重新创建视频输入；不要立即连续重试。 |
6097 | 无法取得视频编码结果。 | 重新创建视频输入并降低编码负载；仍失败时上传日志。 |
6098 | 视频编码结果转换失败。 | 改用受支持的编码格式和视频参数，重新创建视频输入后重试。 |
6099 | 视频编码器无法执行当前控制请求。 | 减少运行中参数切换，停止后重新配置并创建编码输入。 |
6100 | 视频解码器的当前状态不允许执行该操作。 | 重新创建视频输出，等待其完成初始化后再送入媒体数据。 |
6101 | 视频解码器拒绝了当前输入数据。 | 确认码流格式正确并包含必要的关键帧，重新订阅或请求关键帧后重试。 |
6102 | 无法取得视频解码结果。 | 重新创建视频输出并降低解码负载；仍失败时上传日志。 |
6103 | 视频解码结果转换失败。 | 改用受支持的输出格式或解码方式，重新创建视频输出。 |
6104 | 视频解码输出释放失败。 | 重新创建视频输出；如果持续失败，请上传日志。 |
6105 | SDK 的网络连接能力尚未完成初始化。 | 先完成 SDK 初始化；初始化已经成功时，重新创建连接对象后再试。 |
6106 | 当前连接方式不受支持。 | 改用 SDK 支持或默认的连接方式，确认初始化和网络配置后重新连接。 |