如果你曾经尝试开发一款 iOS 应用，去和智能眼镜、耳机或其他 AI 可穿戴设备通过蓝牙通信，你一定知道背后有多少繁琐的工作：BLE 扫描、设备配对、音频路由、AI 服务商鉴权、离线语音指令、崩溃上报……清单可以一直列下去。这正是我们打造 AIBuds SDK 的初衷 —— 把所有这些复杂度封装成简洁、模块化的 API，让你在几分钟内就能集成到自己的 App 中。

为什么我们要做这个站点​

优秀的 SDK 配得上优秀的文档。很多时候，集成一款硬件 SDK 意味着要在分散的头文件、过时的示例代码和半年没更新的 README 之间反复跳转。我们希望 AIBuds 不一样。

这个站点就是我们的一份承诺。每一个 subspec、每一项权限、每一个你在集成过程中可能踩到的坑，都在这里有据可查 —— 中英双语，并提供可运行的 Swift 与 Objective-C 示例并排对照。

站点内容概览​

如果你是第一次来，下面是怎么用好这份文档的建议：

🚀 快速开始​

从 安装指南 开始 —— 我们覆盖了完整安装与自定义安装两种方式，逐一讲解每个 CocoaPods subspec，并列出你在使用本地 Wi-Fi 访问、Bonjour 发现等功能时所需的 Info.plist 权限和 entitlements。然后接着看 快速入门 —— 这是一段从 SDK 初始化 → 扫描 → 添加设备 → 连接 → 下发指令的完整上手之旅。

🔩 核心功能​

所有与蓝牙和设备管理相关的内容都在这里。你会了解到配对流程、连接状态管理、ANC 控制、通过设备热点进行文件传输，以及如何接入 RTSP 直播流管线。

🤖 AI 能力​

这里是最有意思的部分。聊天、同声传译、流式 ASR、TTS、对话总结 —— 我们目前支持两家 AI 服务商（星芒 StarBurst 和美乐创 MltCloud），模块化的插件体系意味着接入第三家也只是一个 subspec 的事。

🎙️ 语音助手与日志​

离线语音指令鉴权、XLFacility 日志后端、崩溃日志收集 —— 你把功能推向生产环境所需的稳定与可观测性，都在这里。

关于模块化设计​

我们尤其引以为豪的一点是：AIBuds SDK 从不强制你接受一个"大而全"的打包方案。每一项功能都是一个 CocoaPods subspec。只想做一个轻量级的设备配对 App？加一行 AIBudsSDK/ABMate 就够了。想要 AI 全家桶？用 AIBudsSDK/AllInOne。或者介于两者之间的任何组合都可以。

Core subspec 会作为依赖被自动引入，为其他模块提供稳定的基础能力。

加入社区​

这份文档完全开源，我们欢迎任何形式的贡献。发现错别字？示例过时了？希望我们补上某个功能？欢迎到 topstepsmart/AIBuds-SDK-iOS 提 issue 或 PR —— 我们会逐一审阅。

如果你用 AIBuds 做出了有意思的产品，请告诉我们！每次看到有新 App 基于 SDK 上线，我们都会由衷地激动。

感谢阅读，祝编码愉快。
—— AIBuds 团队