跳到主要内容

核心概念

在使用具体的设备或 AI 功能前,先通过本节理解 SDK 的基本工作方式。

关键概念

先发现设备,再创建设备对象

扫描会返回已发现设备的句柄。保存或连接前,需要先将其转换为可持久化的设备对象。

等待设备就绪

蓝牙链路建立并不代表设备已最终就绪。请在 SDK 完成设备握手后再发送功能指令。

检查能力协议

已连接设备只会提供其型号和固件支持的功能协议。调用功能前,请先转换为所需协议。

区分全局事件和设备事件

SDKDelegate 报告 SDK 全局事件;DeviceDelegate 报告与单个设备相关的事件。

只安装实际使用的模块

核心功能、设备通信、AI 服务商、日志、媒体和诊断能力分别通过 CocoaPods subspec 提供,也可以使用 All-in-One 一次安装。

将插件视为集成边界

AI 服务商插件和桥接插件负责将可选实现接入核心 SDK,无需让所有 App 安装每一种集成。

继续阅读

  • 通过 SDK 术语表查看蓝牙、设备、音频、AI、媒体、OTA 和架构术语的简明定义。
  • 通过架构了解模块关系、插件边界和设备生命周期。
  • 准备实现设备能力时,请前往核心功能