欢迎来到 AIBuds 文档站

大家好 👋 —— 欢迎来到 AIBuds SDK 官方文档站！

如果你曾经尝试开发一款 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 团队