Android SDK 1.0.0 接入总览

SDK Version: 1.0.0
Platform: Android

本手册面向没有 xTalk 源码仓库权限的客户。只要取得正式 Release AAR 与交付清单，即可按本文档完成从权限申请、扫描连接、认证初始化到业务收发和资源清理的完整接入。

完整调用链

Customer App
  → BLE Connection
  → Radio Transport
  → Device Auth
  → Device Init
  → Data / Text / File / Voice / Device capabilities
  → Disconnect and listener cleanup

模块	负责什么	不负责什么	前置状态	成功输出状态
BLE Connection	Android 权限辅助、扫描、连接、GATT/AT/RF 通道、设备与业务回调	不代表设备已认证或无线参数已写入	蓝牙开启且运行时权限已授予	`awaitBleReady() == true`
Radio Transport	把 BLE/UART 抽象成统一 AT、RF、事件和无线设置接口	不自行建立 BLE 链路，也不决定业务协议	对应物理通道已打开	`isOpenOrConnected() == true`
Device Auth	选择 BLE AT 编码、Challenge 验证、读取并应用 DID；也支持客户 UART	不写频率、速率和工作模式	BLE/GATT 就绪或 UART 已打开	`Result.ok == true` 且取得 DID
Device Init	认证后应用 BLE 默认参数或 UART 厂家/默认参数	不扫描、不连接、不认证	Auth 成功且 DID 可用	BLE `isReadyForSend() == true` 或 UART `Result.ok == true`
Data & Device	二进制/RF、文本、文件、语音、图片转码、密钥、频率/速率、版本和电量	不替客户定义业务协议、文件保存路径或 UI	按接口要求完成连接、Auth、Init	各接口返回成功且回调完成

重要：ConnectResult.CONNECT_OK 表示连接请求已受理，不等于认证完成；业务发送必须等到 XTalkBleClient.isReadyForSend() 返回 true。

最短接入路线

按环境要求与 SDK 引入加入正式 AAR、依赖与权限。
按BLE 连接 SDK初始化、扫描、连接并等待 GATT 就绪。
构造RadioTransport。
按设备认证 SDK完成 Challenge 和 DID。
按设备初始化 SDK写入获准的无线参数。
按数据与设备能力接入业务功能。
直接复制完整接入示例建立一个生命周期所有者。

文档导航

SDK 产品清单

产品	主要用途	典型入口
BLE	扫描、连接和 BLE AT/RF 通道	`XTalkBleClient`
Channel Presence	扫描 16 个正式信道并判断可达/好友	`ChannelPresenceScanSdk`
Device Auth	Challenge 认证与 DID	`DeviceAuthenticator`
Device Init	认证后的无线默认参数	`DeviceInitializer`
Mesh	文本、语音、好友、地图、路由和 ACK	`MeshSdk`
Low Latency PTT	独立低时延半双工语音	`LowLatencyPttSdk`
OTA	TurMass 与 BT5632F 固件升级	`XTalkTurMassOtaManager` / `XTalkBluetoothFotaManager`
Radio Transport	BLE/UART 统一 AT/RF 接口	`RadioTransport`
STT	本地 WAV 离线转文字	`XTalkStt`
UART	Android TTY 连接和 RF/AT 传输	`XTalkUartClient` / `UartRadioTransport`

应用发布版本与 SDK 版本相互独立。本套页面只描述 SDK 1.0.0 的正式客户接口；诊断能力不属于客户 API。

完整调用链​

最短接入路线​

文档导航​

SDK 产品清单​

完整调用链

最短接入路线

文档导航

SDK 产品清单