核心概念
在使用具体的设备或 AI 功能前,先通过本节理解 SDK 的基本工作方式。
关键概念
- 先发现设备,再创建设备对象
扫描会返回已发现设备的句柄。保存或连接前,需要先将其转换为可持久化的设备对象。
- 等待设备就绪
蓝牙链路建立并不代表设备已最终就绪。请在 SDK 完成设备握手后再发送功能指令。
- 检查能力协议
已连接设备只会提供其型号和固件支持的功能协议。调用功能前,请先转换为所需协议。
- 区分全局事件和设备事件
SDKDelegate报告 SDK 全局事件;DeviceDelegate报告与单个设备相关的事件。- 只安装实际使用的模块
核心功能、设备通信、AI 服务商、日志、媒体和诊断能力分别通过 CocoaPods subspec 提供,也可以使用 All-in-One 一次安装。
- 将插件视为集成边界
AI 服务商插件和桥接插件负责将可选实现接入核心 SDK,无需让所有 App 安装每一种集成。