跳到主要内容

SDK 术语表

本页简要定义 AIBuds SDK 文档中使用的术语。功能指南说明如何使用各项能力；架构页面说明 SDK 各部分如何协作。

蓝牙与连接​

BLEBluetooth Low Energy

用于发现设备、建立 SDK 控制连接和交换设备指令的无线链路。ABMate 模块提供受支持的设备协议实现。

RSSIReceived Signal Strength Indicator

描述 BLE 广播接收强度的有符号 dBm 值。它只能用于判断相对接近程度，不能作为距离测量或连接质量保证。

Advertisement Data

外设 BLE 广播中包含的元数据。已发现设备句柄会同时提供广播快照、外设对象和 RSSI。

Core Bluetooth ObjectsCBCentralManager / CBPeripheral

Apple 的 Central Manager 负责协调扫描和连接；Peripheral 表示一个远程 BLE 设备。SDK 将这些对象封装到自身设备抽象中。

Classic Bluetooth

通常用于音频 Profile 的独立蓝牙链路，其连接状态与 BLE 控制连接相互独立。

SCOSynchronous Connection-Oriented

在受支持设备上用于双向通话或语音音频的经典蓝牙语音链路。

Beacon Data

无需活动设备连接即可广播的可选厂商数据。仅当已发现设备提供 Beacon 载荷时使用。

设备概念​

Discovered DeviceFoundDeviceConvertible

由 FoundDeviceConvertible 表示的扫描结果。保存或连接前需要通过 SDK 完成转换。

Storable DeviceDeviceConvertible

持久化的 DeviceConvertible 句柄，用于设备身份、连接状态、保存、指令、Delegate 和能力检查。

StoredDevicesMgr

管理应用持久化设备列表的进程级对象。已保存设备可以参与 SDK 支持的自动重连流程。

Device Ready

设备连接并完成 SDK 连接后握手时到达的生命周期节点。发送功能指令前，应等待 deviceDidReady 或检查 isConnectedAndReady。

Capability Protocol

仅在设备支持对应功能时实现的小型可选 *API 协议。应将设备转换为对应协议，而不是假设所有型号都具备全部能力。

Device State

由设备上报的工作状态。它不同于 Core Bluetooth 的 Peripheral 状态，后者只描述 BLE 链路。

Work Mode / Work State

工作模式是设备配置的运行模式；工作状态是设备当前上报的活动状态。两者都是设备快照，可能通过 Delegate 事件发生变化。

Wear Detection

用于报告设备是否支持佩戴检测、是否已启用以及当前佩戴状态的设备能力。

TWSTrue Wireless Stereo

描述成对的左右无线设备。SDK 分别提供设备是否属于 TWS，以及其配对设备当前是否已连接的信息。

Auto Reconnect

控制持久化设备在应用启动或蓝牙重启后重新被发现时是否自动连接的单设备行为。初始值来自 SDK 配置。

音频与语音​

VADVoice Activity Detection

用于区分语音、静音和背景噪声的信号处理技术。AI 音频集成可利用它对输入音频进行分段或控制其传入。

Standard Recording

通过设备录音能力启动和停止的设备端录音。命令执行结果本身不会返回本地音频文件。

AI Audio Recording

由设备与 AI 服务协同完成的流程：设备提供音频，选定的服务商生成会话事件、转写更新和最终报告。

Recording Scene

启动 AI 音频采集时传入的设备录音上下文。公开枚举值用于区分现场录音和通话录音场景。

PCMPulse-Code Modulation

未压缩的数字音频采样。PCM 易于处理，但比压缩音频占用更多带宽和存储空间。

Opus

一种低延迟压缩音频编解码格式，用于 SDK 支持的语音和流媒体链路。

On-Device Voice Assistant

支持的穿戴设备固件通过 OnDeviceVoiceAssistantAPI 提供唤醒和命令处理能力。鉴权仍可能依赖已注册的桥接插件及其集成环境。

AI 与语音技术​

ASRAutomatic Speech Recognition

将语音音频转换为文本。SDK 针对支持的输入同时提供基于会话的流式识别和服务 API。

Streaming ASR

在音频持续输入时逐步返回转写更新，而不是等待全部音频处理完成后才返回最终结果。

TTSText to Speech

将文本转换为音频文件。TTSResultModel 提供相对路径 audioFile、音频格式 audioFormat 和解析后的完整路径 audioFilePath。

AI Summary

根据原始文本或转写内容生成精简结果。支持的服务商可以逐步返回总结内容。

Text Translation

在配置的语言之间翻译输入文本，与持续运行的语音会话流程相互独立。

Simultaneous Interpretation

将输入音频、流式识别、翻译以及受支持的目标语言音频输出组合起来的实时会话。

AI Chat

由 AI 服务商支持的对话会话，可产生转写、对话、意图、语音、生命周期、错误和最终报告事件。

AI Intent

从对话交互中提取的结构化操作数据。它与自由文本相互独立，只有选定的服务商返回该数据时才有意义。

AI Service ProviderAIServiceVendor / AIBudsAIServiceVendor

执行 AI 服务调用时选用的已注册服务商。公开枚举的 API 名称仍保留 Vendor，面向开发者的文档统一使用“AI 服务商”。安装服务商模块、注册、初始化和选择服务商是彼此独立的步骤。

StarBurst AI（星芒 AI）.starBurst / AIBudsAIServiceVendorStarBurst

由字节跳动支持的 AI 服务商。App 需先使用 AIBudsStarBurst 模块中的 StarBurstSDK 完成注册，再将其选为 AI 服务调用所使用的服务商。

MltCloud AI（骆方案 AI）.mltcloud / AIBudsAIServiceVendorMltcloud

由美乐创提供的 AI 服务商。App 需先使用 AIBudsMagicHelper 模块中的 MagicHelperSDK 完成注册，再将其选为 AI 服务调用所使用的服务商。

Authorized Services

由设备报告的位掩码，表示哪些受支持服务已完成鉴权握手；它并不是所有已安装 AI 模块的通用列表。

AI Dashboard

可选的本地诊断界面，用于在受控的开发或故障排查环境中检查 AI 会话、事件、报告和错误。

声音调校​

EQEqualizer

对各频段应用增益的设备设置。自定义 EQ 的约束目前尚未形成完整的公开契约，因此应优先使用设备报告的设置。

Preset EQ

由设备提供的均衡器设置，例如出厂调音配置。可用预设因设备和固件而异。

ANCActive Noise Cancellation

用于降低环境声音的设备端处理能力。公开模式还区分普通模式和通透模式。

Transparency Mode

一种允许穿戴设备传入环境声音而不是抑制环境声音的 ANC 模式。

ANC Fade

用于逐步改变 ANC 行为的过渡设置，其实际听感由设备定义。

Volume Domains

系统提示音、媒体和通话分别使用独立的设备音量值，本地播放音量目前仅可读取。提供可写控制前应先检查设备能力。

VolumeSetCapability

描述当前设备支持哪些音量设置操作的位掩码。

影像、直播与存储​

Remote Shutter

由设备发起，请求宿主 App 进入相机、执行拍摄或退出相机。相机操作由 App 负责执行，并将结果状态报告给设备。

Capture Mode

CaptureMode 使用 .camera 将高分辨率照片保存在设备中，使用 .ai 将 320×240 JPEG 图片推送到应用。

RTSPReal-Time Streaming Protocol

热点连接和直播流程成功后，用于播放受支持设备实时摄像头画面的会话 URL。

JPEG Live Streaming

基于回调返回完整 JPEG 压缩图片的直播方式。每次回调提供一张图片，而不是未经解码的原始视频帧。

RTMPReal-Time Messaging Protocol

用于将直播转发到兼容端点的可选发布链路。它的生命周期独立于设备会话和本地播放器。

Media File Import

DeviceMediaFileImportAPI 提供的设备到应用热点传输流程。它可获取元数据、下载选定文件，并可选择执行本地视频防抖处理。

MediaCountInfoModel

成功刷新后，由设备报告的各类受支持媒体的当前数量。

StorageInfoModel

由设备报告的当前已用和可用存储空间，公开模型以 MB 为单位表示。

OTA 更新​

OTAOver-the-Air Update

使用宿主 App 提供的兼容本地固件包更新设备主固件。

Camera OTA

针对受支持摄像头模块的独立固件更新流程，包括热点连接、本地 HTTP 分发、传输、烧录和最终完成阶段。

OTA Battery Limit

启动主固件更新所需的最低设备电量百分比。报告值为 0 表示没有电量阈值。

SDK 架构​

SDKDelegate / DeviceDelegate

SDKDelegate 接收 SDK 范围内的扫描和设备事件；DeviceDelegate 接收与单个设备相关的事件。

All-in-One

安装完整 SDK 组件集合并便捷初始化的聚合方案。模块化集成则让宿主 App 能够更精细地控制依赖和插件。

Bridge Plugin

通过公开插件边界将特定服务商的鉴权或服务接入核心 SDK 的可选适配器。

ConnectParams

每次连接使用的参数，例如用户身份、配对数据、经典蓝牙偏好和可选 AI 鉴权参数。

LogService

当前进程范围内生效的 LogService 后端。配置的单个目标负责日志输出；支持持久化的目标还提供导出和清理能力。

SDKConfiguration

初始化时配置的 SDK 默认行为，例如日志级别、扫描超时、自动重连和已知设备发现过滤。