Android API 说明

Android SDK com.tange.ai:tirtc 提供客户端 Kotlin / Java API，适用于用 Android 原生应用接入 TiRTC。如果你还没有完成 AAR 接入、工程配置或连接流程准备，先看 Android SDK 接入。

生命周期与调用顺序

典型客户端流程是：连接一个设备端，播放设备端音视频，并按需收发命令或发起语音对讲。主干从 TiRtc.initialize(...) 开始，以 disconnect() 和 dispose() 收尾。

1. 初始化：传入 AppId，启动 SDK 运行时。

   TiRtc.initialize(applicationContext, TiRtcInitOptions(appId = appId))

2. 创建连接：创建 TiRtcConn，并在连接前设置状态、命令和流消息 listener。

   val conn = TiRtcConn().apply {
       onStateChanged = TiRtcConnStateListener { state, errorCode ->
           handleConnStateChanged(state, errorCode)
       }
       onCommand = TiRtcConnCommandListener { commandId, data ->
           handleCommand(commandId, data)
       }
       onStreamMessage = TiRtcConnStreamMessageListener { streamId, timestampMs, data ->
           handleStreamMessage(streamId, timestampMs, data)
       }
   }

3. 准备播放：在发起连接前创建音频输出和视频输出，并指定要播放的 streamId。

   val audioOutput = TiRtcAudioOutput()
   audioOutput.attach(conn, audioStreamId)
   
   val videoOutput = TiRtcVideoOutput()
   videoOutput.attach(conn, videoStreamId)

4. 渲染视频：在主线程把视频输出挂到 Android 容器中，让视频输出有对应的显示位置。

   videoOutput.attachView(container)

5. 发起连接：传入目标设备的 device_id 和业务服务端签发的 token。

   conn.connect(remoteId, token)

6. 请求媒体：连接进入 CONNECTED 后，按需请求设备端发送音频流和视频流。

   conn.subscribeAudio(audioStreamId) // 连接成功后订阅音频
   conn.subscribeVideo(videoStreamId) // 连接成功后订阅视频

7. 命令交互：连接进入 CONNECTED 后，按需通过命令通道和设备端交换业务数据。

   conn.sendCommand(commandId, data) // 需要命令交互时调用
   // 收到设备端命令时，在 handleCommand(commandId, data) 中处理。

8. 语音对讲（按需）：应用获得 RECORD_AUDIO 权限后，创建音频输入，绑定到同一条连接，并启动采集发送。

   val talkbackInput = TiRtcAudioInput()
   talkbackInput.setOptions(talkbackOptions)
   talkbackInput.attach(conn, talkbackStreamId)
   talkbackInput.start()

9. 收尾释放：业务结束时先释放按需创建的输入对象，再按订阅、输出、连接的顺序收尾。

   talkbackInput.stop() // 创建了 talkbackInput 时调用
   talkbackInput.detach(conn)
   talkbackInput.dispose()
   
   conn.unsubscribeAudio(audioStreamId) // 停止播放时取消音频订阅
   conn.unsubscribeVideo(videoStreamId) // 停止播放时取消视频订阅
   
   audioOutput.detach()
   videoOutput.detach()
   videoOutput.detachView()
   audioOutput.dispose()
   videoOutput.dispose()
   
   conn.disconnect()
   conn.dispose()

TiRtcInitOptions

TiRtcInitOptions 是 TiRtc.initialize(...) 的参数对象。

初始化时必须传 appId，取值为你的 AppId。

class TiRtcInitOptions @JvmOverloads constructor(
    val appId: String = "", // 必填：你的 AppId
    val endpoint: String = "", // 切换自部署云端实例或测试、联调环境时设置，例如 "https://ep-tirtc.my-domain.com"；其他情况保持空字符串
    val consoleLogEnabled: Boolean = false, // true 时同时把 SDK 日志打印到控制台
)

TiRtc

TiRtc 提供初始化和错误码名称转换入口。

// 初始化 SDK。返回 0 表示成功，非 0 为错误码。
// context 可以传 Activity 或 Application；SDK 会使用 applicationContext。
// 重复调用成功时返回 0，不会替换已生效的配置。
fun initialize(context: Context, config: TiRtcInitOptions): Int

// 把错误码转成错误名称。
fun errorToString(code: Int): String

示例：

val code = TiRtc.initialize(
    applicationContext,
    TiRtcInitOptions(appId = "your-app-id"),
)
if (code != 0) {
    Log.e("tirtc", "initialize failed: ${TiRtc.errorToString(code)} ($code)")
}

TiRtcConn

TiRtcConn 表示客户端到远端设备的一条连接。创建对象不会立即发起连接；通常先设置 listener，再调用 connect(...)。连接建立后，可以通过它发送命令、发送流消息、发起媒体订阅和请求视频关键帧。

音频播放和视频显示由 TiRtcAudioOutput / TiRtcVideoOutput 负责，TiRtcConn 本身不播放也不显示媒体。

状态

• TiRtcConnState.IDLE：连接对象已创建，但还没有开始连接。
• TiRtcConnState.CONNECTING：连接请求已提交，正在等待结果。
• TiRtcConnState.CONNECTED：连接已经建立，可收发命令、流消息，发起媒体订阅和关键帧请求。
• TiRtcConnState.DISCONNECTED：连接失败、对端断开或调用 disconnect() 后进入该状态。

属性和 listener

// 当前连接状态。
val state: TiRtcConnState

// 连接状态变化时触发。errorCode 为 0 表示本次状态变化没有错误；非 0 为错误码。
// 设置后会通过 Android 主线程立即回调一次当前状态。
var onStateChanged: TiRtcConnStateListener?

// 收到设备端命令时触发。
var onCommand: TiRtcConnCommandListener?

// 收到设备端的流消息时触发。
var onStreamMessage: TiRtcConnStreamMessageListener?

相关类型：

fun interface TiRtcConnStateListener {
    fun onStateChanged(state: TiRtcConnState, errorCode: Int)
}

fun interface TiRtcConnCommandListener {
    fun onCommand(command: Long, data: ByteArray)
}

fun interface TiRtcConnStreamMessageListener {
    fun onStreamMessage(streamId: Int, timestampMs: Long, data: ByteArray)
}

方法

// 创建连接对象；构造函数本身不会发起连接。通常先设置 listener，再调用 connect。
TiRtcConn()

// 发起连接；初始化完成并拿到连接凭证后调用。
// remoteId 是连接目标；连接设备端时传目标设备的 device_id，例如 "PRODFENGXXXX"。
// token 是业务服务端为本次连接签发的 token，二者不能为空。
// 返回 0 只表示请求已提交，最终连接结果看 onStateChanged；非 0 为错误码。
fun connect(remoteId: String, token: String): Int

// 断开当前连接；业务结束、切换设备或重新连接前调用。对象仍可重新 connect。
fun disconnect(): Int

// 释放连接对象；确认不再使用这条连接后调用。调用后不要再使用这个实例。
fun dispose(): Int

// 在命令通道上发送自定义命令；连接进入 CONNECTED 后调用。
fun sendCommand(commandId: Long, data: ByteArray = byteArrayOf()): Int

// 发送流消息；连接进入 CONNECTED 后调用。
// streamId 按 stream_id 约定使用 0..15，两端需要提前约定消息语义。
fun sendStreamMessage(streamId: Int, timestampMs: Long, data: ByteArray): Int

// 请求远端开始发送指定 streamId 的音频流；连接进入 CONNECTED 后调用。
// streamId 按 stream_id 约定使用 0..15。
// 这个方法只请求远端发送音频，不会自动播放。
// 播放远端音频前，先调用 TiRtcAudioOutput.attach(...) 指定要播放的 connection 和 streamId；然后调用 connect(...) 建立连接。
// 连接成功后，再调用 subscribeAudio(...) 请求远端发送这路音频。
fun subscribeAudio(streamId: Int): Int

// 请求远端停止发送指定 streamId 的音频流；streamId 按 stream_id 约定使用 0..15。
// 不会停止已经创建的 TiRtcAudioOutput。停止播放时再调用 TiRtcAudioOutput.detach()。
fun unsubscribeAudio(streamId: Int): Int

// 请求远端开始发送指定 streamId 的视频流；连接进入 CONNECTED 后调用。
// streamId 按 stream_id 约定使用 0..15。
// 这个方法只请求远端发送视频，不会自动显示。
// 显示远端视频前，先调用 TiRtcVideoOutput.attach(...) 指定要显示的 connection 和 streamId；然后调用 connect(...) 建立连接。
// 连接成功后，再调用 subscribeVideo(...) 请求远端发送这路视频。
fun subscribeVideo(streamId: Int): Int

// 请求远端停止发送指定 streamId 的视频流；streamId 按 stream_id 约定使用 0..15。
// 不会停止已经创建的 TiRtcVideoOutput。停止显示时再调用 TiRtcVideoOutput.detach()。
fun unsubscribeVideo(streamId: Int): Int

// 向远端请求指定视频流的关键帧；连接已建立且远端正在发送该视频流时调用。
// streamId 按 stream_id 约定使用 0..15。
fun requestKeyFrame(streamId: Int): Int

示例：

val conn = TiRtcConn().apply {
    onStateChanged = TiRtcConnStateListener { state, errorCode ->
        if (errorCode == 0) {
            Log.d("tirtc", "conn state=$state")
            return@TiRtcConnStateListener
        }
        Log.d("tirtc", "conn state=$state error=${TiRtc.errorToString(errorCode)} ($errorCode)")
    }
    onCommand = TiRtcConnCommandListener { commandId, data ->
        Log.d("tirtc", "command=$commandId bytes=${data.size}")
    }
}

val code = conn.connect(remoteId, token)
if (code != 0) {
    Log.e("tirtc", "connect failed: ${TiRtc.errorToString(code)} ($code)")
}

// 结束时：
conn.disconnect()
conn.dispose()

TiRtcAudioOutputOptions

TiRtcAudioOutputOptions 配置 TiRtcAudioOutput 的音频输出参数。只需要填写要覆盖默认值的字段。

class TiRtcAudioOutputOptions @JvmOverloads constructor(
    val agcLevel: Int = 0, // 自动增益等级：0 关闭，1 低，2 中，3 高
    val ansLevel: Int = 0, // 自动噪声抑制等级：0 关闭，1 低，2 中，3 高
    val bufferStrategy: TiRtcOutputBufferStrategy = TiRtcOutputBufferStrategy.AUTOMATIC, // 输出缓冲策略
    // 最大输出缓冲水位，单位为毫秒；仅 AUTOMATIC 有效。
    // null 表示由 SDK 自动决定。
    val maxBufferWatermarkMs: Int? = null,
)

相关枚举：

// 输出缓冲策略。
enum class TiRtcOutputBufferStrategy {
    AUTOMATIC, // SDK 根据当前平台和链路状态决定缓冲策略
    NO_BUFFER, // 不使用输出缓冲；不要同时设置 maxBufferWatermarkMs
}

TiRtcAudioOutput

TiRtcAudioOutput 用来播放某条远端音频流。 播放远端音频前，先创建 TiRtcAudioOutput，调用 attach(...) 指定要播放的 connection 和 streamId，再调用 connect(...) 建立连接；连接成功后，调用 TiRtcConn.subscribeAudio(...) 请求远端发送这路音频。 attach(...) 成功只表示播放对象已经知道要播放哪路音频。如果远端还没有发送这路音频，用户仍然听不到声音。 attach(...) 只选择这路音频由哪个 TiRtcAudioOutput 播放；subscribeAudio(...) 才会请求远端发送。

状态

• TiRtcAudioOutputState.IDLE：还没有选择要播放的远端音频流，或已经 detach()。
• TiRtcAudioOutputState.BUFFERING：已经选择要播放的远端音频流，正在等待可播放数据。
• TiRtcAudioOutputState.PLAYING：正在播放远端音频。
• TiRtcAudioOutputState.FAILED：播放路径发生错误。

属性和 listener

// 当前音频播放状态。
val state: TiRtcAudioOutputState

// 播放状态变化时触发；设置后会通过 Android 主线程立即回调一次当前状态。
var onStateChanged: TiRtcAudioOutputStateListener?

// 音频输出对象发生错误时触发。
var onError: TiRtcAudioOutputErrorListener?

相关类型：

fun interface TiRtcAudioOutputStateListener {
    fun onStateChanged(state: TiRtcAudioOutputState)
}

fun interface TiRtcAudioOutputErrorListener {
    fun onError(code: Int)
}

方法

// 创建音频输出对象。
TiRtcAudioOutput()

// 配置音频输出参数；创建对象后、attach 前调用。
// 返回 0 表示成功，非 0 为错误码；已绑定后调用会返回错误码。
fun configure(options: TiRtcAudioOutputOptions): Int

// 设置当前输出实例的相对播放音量；可以在 attach 前或播放过程中调用。
// volumePercent 必须是 0..100 的整数：0 表示静音，100 表示恢复原始音量。
// 静音不会停止音频流，也不会修改 Android 系统媒体音量。
// 返回 0 表示成功，非 0 为错误码。
fun setVolume(volumePercent: Int): Int

// 指定这个输出对象要播放的远端音频流。通常在 connect 前调用；如果输出对象晚创建，也可以在连接建立后调用。
// 远端发送这路音频后，用户才会听到声音。
fun attach(connection: TiRtcConn, streamId: Int): Int

// 停止使用这个输出对象播放当前音频流；切换流或释放对象前调用。成功后状态回到 IDLE。
fun detach(): Int

// 释放音频输出对象；通常在 detach 后调用。调用后不要再使用这个实例。
fun dispose(): Int

示例：

val audioOutput = TiRtcAudioOutput().apply {
    onError = TiRtcAudioOutputErrorListener { code ->
        Log.e("tirtc", "audio output error: ${TiRtc.errorToString(code)} ($code)")
    }
}

val code = audioOutput.attach(conn, 10)
if (code != 0) {
    Log.e("tirtc", "audio attach failed: ${TiRtc.errorToString(code)} ($code)")
}

// 只调整当前 audioOutput，不修改系统媒体音量。
audioOutput.setVolume(0)   // 静音
audioOutput.setVolume(100) // 恢复原始音量

// 结束时：
audioOutput.detach()
audioOutput.dispose()

TiRtcVideoOutputOptions

TiRtcVideoOutputOptions 配置 TiRtcVideoOutput 的解码和缓冲参数。只需要填写要覆盖默认值的字段。

class TiRtcVideoOutputOptions @JvmOverloads constructor(
    // 解码偏好：0 自动，1 软件解码，2 硬件解码。
    // 这只是请求偏好，实际选择取决于设备、系统和视频编码格式。
    val decoderPreference: Int = 0,
    val bufferStrategy: TiRtcOutputBufferStrategy = TiRtcOutputBufferStrategy.AUTOMATIC, // 输出缓冲策略
    // 最大输出缓冲水位，单位为毫秒；仅 AUTOMATIC 有效。
    // null 表示由 SDK 自动决定。
    val maxBufferWatermarkMs: Int? = null,
)

相关枚举：

// 输出缓冲策略。
enum class TiRtcOutputBufferStrategy {
    AUTOMATIC, // SDK 根据当前平台和链路状态决定缓冲策略
    NO_BUFFER, // 不使用输出缓冲；不要同时设置 maxBufferWatermarkMs
}

TiRtcVideoOutput

TiRtcVideoOutput 用来显示某条远端视频流。 显示远端视频前，先创建 TiRtcVideoOutput，调用 attach(...) 指定要显示的 connection 和 streamId，并调用 attachView(...) 选择画面显示到哪个 ViewGroup，再调用 connect(...) 建立连接；连接成功后，调用 TiRtcConn.subscribeVideo(...) 请求远端发送这路视频。 attach(...) 成功只表示输出对象已经知道要显示哪路视频。如果远端还没有发送这路视频，容器不会出画面。 attach(...) 只选择这路视频由哪个 TiRtcVideoOutput 显示；subscribeVideo(...) 才会请求远端发送。

状态

• TiRtcVideoOutputState.IDLE：还没有选择要显示的远端视频流，或已经 detach()。
• TiRtcVideoOutputState.BUFFERING：已经选择要显示的远端视频流，正在等待可渲染数据或渲染容器准备。
• TiRtcVideoOutputState.RENDERING：正在渲染远端视频。
• TiRtcVideoOutputState.FAILED：视频输出路径发生错误。

属性和 listener

// 当前视频播放状态。
val state: TiRtcVideoOutputState

// 最近一次远端画面渲染尺寸。还没有画面或已经 detach 时可能为 null。
val renderSize: Size?

// 播放状态变化时触发；设置后会通过 Android 主线程立即回调一次当前状态。
var onStateChanged: TiRtcVideoOutputStateListener?

// 远端画面尺寸变化时触发。
var onRenderSizeChanged: TiRtcVideoOutputRenderSizeListener?

// 视频输出对象发生错误时触发。
var onError: TiRtcVideoOutputErrorListener?

相关类型：

fun interface TiRtcVideoOutputStateListener {
    fun onStateChanged(state: TiRtcVideoOutputState)
}

fun interface TiRtcVideoOutputRenderSizeListener {
    fun onRenderSizeChanged(size: Size)
}

fun interface TiRtcVideoOutputErrorListener {
    fun onError(code: Int)
}

方法

// 创建视频输出对象。
TiRtcVideoOutput()

// 设置视频输出参数；创建对象后、attach 前调用。
// 返回 0 表示成功，非 0 为错误码；需要修改参数时先 detach，再重新 setOptions 和 attach。
fun setOptions(options: TiRtcVideoOutputOptions): Int

// 指定这个输出对象要显示的远端视频流。通常在 connect 前调用；如果输出对象晚创建，也可以在连接建立后调用。
// 远端发送这路视频后，页面才会出画面。
fun attach(connection: TiRtcConn, streamId: Int): Int

// 停止使用这个输出对象显示当前视频流；切换流或释放对象前调用。成功后状态回到 IDLE，并清空 renderSize。
fun detach(): Int

// 指定远端视频显示到哪个 Android 容器；需要显示远端视频时调用。必须在主线程调用。
// SDK 会在容器内创建并管理自己的 TextureView。
fun attachView(container: ViewGroup): Int

// 停止把画面显示到当前容器，但不改变 attach(...) 选择的远端视频流；隐藏或销毁容器前调用。必须在主线程调用。
fun detachView(): Int

// 释放视频输出对象和相关系统资源；通常在 detach 和 detachView 后调用。调用后不要再使用这个实例。
// 如果还在使用 Android 容器，也需要在主线程调用。
fun dispose(): Int

示例：

val videoOutput = TiRtcVideoOutput().apply {
    onRenderSizeChanged = TiRtcVideoOutputRenderSizeListener { size ->
        Log.d("tirtc", "remote video size=${size.width}x${size.height}")
    }
}

videoOutput.attachView(container)

val code = videoOutput.attach(conn, 11)
if (code != 0) {
    Log.e("tirtc", "video attach failed: ${TiRtc.errorToString(code)} ($code)")
}

// 结束时：
videoOutput.detach()
videoOutput.detachView()
videoOutput.dispose()

TiRtcAudioInputOptions

TiRtcAudioInputOptions 配置 TiRtcAudioInput 的麦克风采集和本地音频发送参数。配置会在下一次采集启动时生效；运行中调用 setOptions(...) 会返回错误码。

class TiRtcAudioInputOptions @JvmOverloads constructor(
    var codec: TiRtcAudioCodec = TiRtcAudioCodec.G711A, // 本地音频传输编码
    var sampleRate: TiRtcAudioSampleRate = TiRtcAudioSampleRate.RATE_16K, // 麦克风采样率
    var channels: TiRtcAudioChannelCount = TiRtcAudioChannelCount.MONO, // 声道数；公开能力只支持单声道
    var aecMode: Int = 0, // 回声消除模式：0 关闭，1 开启
    var agcLevel: Int = 0, // 自动增益等级：0 关闭，1 低，2 中，3 高
    var ansLevel: Int = 0, // 自动噪声抑制等级：0 关闭，1 低，2 中，3 高
)

相关枚举：

// 本地音频传输编码。
enum class TiRtcAudioCodec {
    G711A,
    AAC,
    PCM,
    OPUS,
    AMR, // AMR-NB
}

// 麦克风采样率。
enum class TiRtcAudioSampleRate {
    RATE_8K,
    RATE_16K,
}

// 声道数。公开能力只支持单声道。
enum class TiRtcAudioChannelCount {
    MONO,
}

TiRtcAudioInput

TiRtcAudioInput 采集本地麦克风声音，并通过已建立的连接发送给远端设备。常见用途是语音对讲或语音回复。

应用需要自己申请 RECORD_AUDIO 权限；SDK 不会替应用弹出系统权限申请框。

状态

• TiRtcInputState.IDLE：输入对象已创建，但还没有开始采集。
• TiRtcInputState.RUNNING：正在采集并传输本地音频。
• TiRtcInputState.STOPPED：已停止采集；当前绑定仍可保留给后续 start() 复用。
• TiRtcInputState.FAILED：采集或传输路径发生错误。

属性和 listener

// 当前本地音频输入状态。
val state: TiRtcInputState

// 输入状态变化时触发；设置后会通过 Android 主线程立即回调一次当前状态。
var onStateChanged: TiRtcInputStateListener?

// 本地音频输入发生错误时触发。message 可能为空。
var onError: TiRtcInputErrorListener?

相关类型：

fun interface TiRtcInputStateListener {
    fun onStateChanged(state: TiRtcInputState)
}

fun interface TiRtcInputErrorListener {
    fun onError(code: Int, message: String?)
}

方法

// 创建本地音频输入对象。
TiRtcAudioInput()

// 设置下次采集使用的参数；创建对象后、start 前调用。
// 返回 0 表示成功，非 0 为错误码；正在采集时调用会返回错误码。
fun setOptions(options: TiRtcAudioInputOptions): Int

// 把本地麦克风音频通过指定连接和 streamId 发送给远端设备。
// 连接必须已进入 CONNECTED；在 start 前调用，streamId 使用 0..15。
// 重复相同绑定返回 0；更换连接或 streamId 前先 detach。
fun attach(connection: TiRtcConn, streamId: Int): Int

// 开始麦克风采集和传输；返回 0 表示成功，非 0 为错误码。
// 调用 start 前，应用必须确保已经获得系统麦克风权限；SDK 不负责申请该权限。
// 还没有 attach 时会返回错误码。
fun start(): Int

// 停止采集和传输，但保留当前绑定；已经停止时调用也返回 0。
fun stop(): Int

// 移除当前连接上的本地音频绑定；停止发送、切换连接或切换 streamId 前调用。
// 运行中先 stop 再 detach。
fun detach(connection: TiRtcConn): Int

// 释放本地音频输入对象并清理绑定；通常在 stop 和 detach 后调用。调用后不要再使用这个实例。
fun dispose(): Int

示例：

val input = TiRtcAudioInput().apply {
    onError = TiRtcInputErrorListener { code, message ->
        Log.e("tirtc", "audio input error: ${TiRtc.errorToString(code)} ($code) ${message.orEmpty()}")
    }
}

val attachCode = input.attach(conn, 14)
if (attachCode == 0) {
    input.start()
}

// 结束时：
input.stop()
input.detach(conn)
input.dispose()

TiRtcLogging

TiRtcLogging 用于上传当前 SDK 日志。排查问题时，把上传成功返回的 logId 提供给支持人员。

// 异步上传当前 SDK 日志。
// 返回 0 只表示上传任务已经开始，结果通过 callback 返回。
fun upload(callback: TiRtcLogUploadCallback): Int

相关类型：

fun interface TiRtcLogUploadCallback {
    fun onCompleted(code: Int, logId: String?)
}

示例：

TiRtcLogging.upload(
    TiRtcLogUploadCallback { code, logId ->
        if (code == 0 && !logId.isNullOrEmpty()) {
            Log.d("tirtc", "TiRTC logId=$logId")
        }
    },
)

错误码

下表列出 Android SDK 公开方法和回调可能返回的全部错误码。0 表示成功；收到非 0 错误码时，找到对应行并按“解决方案”处理。

如果按表处理后问题仍然存在，或者“解决方案”要求上传日志，请按照收集 SDK 日志中的 Android 示例上传 SDK 日志。联系技术支持时，一并提供错误码、SDK 版本、问题发生时间、最短复现步骤和返回的 logId。日志上传失败时，记录上传接口返回的错误码，并按该文档准备其余排查信息。

错误码	错误说明	解决方案
0	操作成功。	无需处理。
1000	SDK 的本地库未能加载，当前功能不可用。	确认应用已经完整集成 TiRTC AAR，并为当前设备 ABI 打包了对应的本地库；清理构建缓存、重新安装应用后再试。
1001	Android 平台操作失败，SDK 无法继续完成当前调用。	释放并重新创建相关对象后重试；如果仍然失败，请上传日志并提供错误发生前的调用步骤。
1002	传入的参数、取值范围或对象关系不合法。	对照当前方法说明检查必填参数、数值范围、streamId 和对象绑定关系。
1003	SDK 无法创建或访问日志目录。	检查应用存储空间和目录访问状态，确认应用数据目录可写，然后重新初始化 SDK。
1004	SDK 尚未完成初始化。	先调用 TiRtc.initialize(...)，确认返回 0 后再创建或使用其他对象。
1005	仍有连接、输入或输出对象未释放，SDK 不能关闭。	按输入、输出、连接的顺序停止并释放所有对象，再调用 TiRtc.shutdown()。
1006	当前对象已经释放。	不要继续使用该实例；重新创建对象，并修正 dispose() 之后仍发起调用的生命周期逻辑。
1007	当前视图已经绑定到其他视频输出或预览对象。	先从原对象解绑视图，再绑定到新对象；不要让同一个视图同时承载多个输出。
1008	当前对象正在使用，不能执行配置、切换绑定或释放等操作。	先停止正在进行的采集或播放并解除绑定，等待当前调用完成后再重试。
1009	当前输入或服务尚未启动。	先完成配置和绑定，再调用对应的 start()；只有启动成功后才执行依赖该状态的操作。
1010	连接尚未建立。	等待连接状态进入 CONNECTED 后再发送数据、订阅或启动已绑定的输入。
1011	当前输入或输出对象尚未绑定。	先调用对应的 attach(...)，确认返回 0 后再启动或执行后续操作。
1012	当前方法不能从所在线程调用。	把视图绑定、预览等界面相关操作切换到 Android 主线程执行。
1013	应用缺少当前操作需要的系统权限。	在宿主应用中申请并确认相机或麦克风等权限已经授予，再重试当前操作。
1014	相机不可用。	确认设备存在目标相机、相机未被其他应用占用且权限已授予；必要时切换前后摄像头。
1015	麦克风不可用。	确认麦克风权限已授予、设备麦克风可用且未被其他应用独占，然后重新创建音频输入。
1016	视频渲染所需的 Surface 不可用。	等待视图完成创建并处于有效状态后重新绑定；页面销毁时及时解绑。
1017	视频输出与渲染视图绑定失败。	确认在主线程使用有效视图，先解绑旧视图再重试；仍失败时重新创建视频输出。
1018	相机采集或编码链路启动失败。	检查相机权限和占用情况，降低分辨率、帧率或码率后重试；仍失败时上传日志。
1019	当前设备不支持所选编解码格式。	改用文档列出的其他编解码格式，或更换支持该格式的设备。
6000	传入的参数、取值范围或对象关系不合法。	对照当前方法说明检查必填参数、数值范围、streamId、数据长度和对象绑定关系。
6001	SDK 尚未初始化。	先调用 TiRtc.initialize(...)，确认返回 0 后再调用其他 API。
6004	当前运行环境不支持 SDK 需要的任务调度方式。	确认使用了适配当前平台和系统版本的 SDK；如果没有修改过相关运行配置，请上传日志。
6005	SDK 组件版本不一致，完整性校验未通过。	确认所有 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 支持或默认的连接方式，确认初始化和网络配置后重新连接。