SDK 用語集

AIBuds SDK のドキュメントで使用する用語を簡潔にまとめています。各機能の使い方は機能ガイド、SDK 全体の構成はアーキテクチャを参照してください。

Bluetooth と接続

BLEBluetooth Low Energy

デバイスの検索、SDK の制御接続、コマンド交換に使用する無線経路です。対応デバイスのプロトコル実装は ABMate モジュールが提供します。

RSSIReceived Signal Strength Indicator

BLE advertising の受信強度を示す符号付き dBm 値です。近接の目安であり、距離や接続品質を保証する値ではありません。

Advertisement Data

peripheral の BLE broadcast に含まれるメタデータです。検出デバイスのハンドルから、peripheral と RSSI とともに取得できます。

Core Bluetooth ObjectsCBCentralManager / CBPeripheral

Apple の central manager は検索と接続を管理し、peripheral は個々のリモート BLE デバイスを表します。SDK はこれらを独自のデバイス抽象で包みます。

Classic Bluetooth

主に音声 profile で使用する別系統の Bluetooth 接続です。接続状態は BLE の制御接続とは独立しています。

SCOSynchronous Connection-Oriented

対応デバイスで通話や双方向音声に使用する Classic Bluetooth の音声リンクです。

Beacon Data

デバイス接続なしで broadcast される任意の manufacturer data です。検出デバイスが beacon payload を公開している場合だけ使用します。

デバイスの概念

Discovered DeviceFoundDeviceConvertible

検索結果を表す FoundDeviceConvertible です。保存や接続の前に SDK で変換します。

Storable DeviceDeviceConvertible

識別、接続状態、保存、コマンド、delegate、機能確認に使用する永続的な DeviceConvertible ハンドルです。

StoredDevicesMgr

アプリに保存したデバイス一覧をプロセス全体で管理します。保存済みデバイスは、対応する自動再接続の対象になります。

Device Ready

接続後の SDK handshake が完了したライフサイクル状態です。機能コマンドは deviceDidReady を待つか、isConnectedAndReady を確認してから送信します。

Capability Protocol

デバイスが対応機能だけに実装する小さな任意の *API プロトコルです。全機種が同じ機能を持つと仮定せず、必要なプロトコルへ cast します。

Device State

デバイスが通知する動作状態です。BLE リンクだけを表す Core Bluetooth の peripheral state とは異なります。

Work Mode / Work State

Work mode は設定済みの動作モード、work state は現在通知されている動作状況です。どちらも delegate event で変化する可能性がある snapshot として扱います。

Wear Detection

装着検出への対応、設定の有効状態、現在の装着状態を通知するデバイス機能です。

TWSTrue Wireless Stereo

左右で pair になった無線デバイスを表します。SDK は TWS デバイスかどうかと、相方が接続中かどうかを個別に公開します。

Auto Reconnect

アプリ起動後や Bluetooth 再起動後に保存済みデバイスを再検出したとき、自動再接続するかをデバイス単位で制御します。初期値は SDK configuration から取得します。

音声

VADVoice Activity Detection

発話と無音または背景雑音を区別する信号処理です。AI 音声連携では、入力音声の区切りや通過判定に使用できます。

Standard Recording

デバイスの録音機能から開始・停止するデバイス側録音です。コマンド結果からローカル音声ファイルが直接返るわけではありません。

AI Audio Recording

デバイスと AI サービスを連携する処理です。デバイスが音声を供給し、選択したサービスが session event、文字起こし更新、最終 report を生成します。

Recording Scene

AI 音声収録の開始時に渡す録音 context です。公開値では現場録音と通話録音を区別します。

PCMPulse-Code Modulation

非圧縮のデジタル音声 sample です。処理しやすい一方、圧縮音声より帯域と保存容量を多く使用します。

Opus

対応する音声処理や streaming 経路で使用する、低遅延の圧縮音声 codec です。

On-Device Voice Assistant

対応 wearable firmware で OnDeviceVoiceAssistantAPI を通じて利用できる起動語とコマンド処理です。認証には登録済み bridge plugin とその連携環境が必要な場合があります。

AI と音声処理

ASRAutomatic Speech Recognition

音声をテキストへ変換します。SDK は session ベースの streaming recognition と、対応入力向けの service API を提供します。

Streaming ASR

最終結果を待たず、音声の受信中に文字起こしを逐次更新する認識方式です。

TTSText to Speech

テキストを音声ファイルへ変換します。TTSResultModel から相対 audioFile、audioFormat、解決済みの audioFilePath を取得できます。

AI Summary

元のテキストや文字起こしから要約を生成します。対応サービスは結果を逐次返す場合があります。

Text Translation

指定した言語間で入力テキストを翻訳します。継続的な音声 session の処理とは別の機能です。

Simultaneous Interpretation

入力音声、streaming recognition、翻訳、対応する対象言語の音声出力を組み合わせる live session です。

AI Chat

AI サービスを利用する対話 session です。文字起こし、chat、intent、音声、lifecycle、error、最終 report の event を通知できます。

AI Intent

対話から抽出される構造化 action data です。自由形式のテキストとは別で、選択したサービスが出力した場合だけ意味を持ちます。

AI Service ProviderAIServiceVendor / AIBudsAIServiceVendor

AI サービス呼び出しに使用する登録済みサービスです。公開 enum の API 名には Vendor が残りますが、開発者向け文書では service provider と表記します。モジュールの導入、登録、初期化、選択はそれぞれ別の手順です。

StarBurst AI.starBurst / AIBudsAIServiceVendorStarBurst

ByteDance が提供する AI サービスです。AI サービス呼び出しに選択する前に、AIBudsStarBurst モジュールの StarBurstSDK で登録します。

MltCloud AI.mltcloud / AIBudsAIServiceVendorMltcloud

Meilc が提供する AI サービスです。AI サービス呼び出しに選択する前に、AIBudsMagicHelper モジュールの MagicHelperSDK で登録します。

Authorized Services

対応サービスのうち認証 handshake が完了したものをデバイスが通知する bitmask です。導入済みの全 AI モジュールを示す一覧ではありません。

AI Dashboard

開発時や問題調査時に AI session、event、report、error を確認する任意のローカル診断画面です。

サウンド調整

EQEqualizer

周波数 band ごとの gain を適用するデバイス設定です。custom EQ の制約はまだ完全な公開契約ではないため、デバイスが通知する設定を優先します。

Preset EQ

factory tuning profile など、デバイスが提供する equalizer 設定です。利用可能な preset は機種と firmware によって異なります。

ANCActive Noise Cancellation

周囲の音を低減するデバイス処理です。公開 mode では normal と transparency の動作も区別します。

Transparency Mode

周囲の音を抑制せず wearable に取り込む ANC mode です。

ANC Fade

ANC の動作を段階的に切り替えるための設定です。聞こえ方はデバイス実装によって決まります。

Volume Domains

system prompt、media、call、読み取り可能な local playback state それぞれの独立した音量値です。変更 UI を提供する前にデバイス機能を確認します。

VolumeSetCapability

現在のデバイスが対応する音量設定操作を示す bitmask です。

画像、Streaming、Storage

Remote Shutter

ホストアプリの camera 起動、撮影、終了をデバイスから要求する機能です。camera 操作はアプリが実行し、その結果をデバイスへ通知します。

Capture Mode

CaptureMode の .camera は高解像度写真をデバイスへ保存し、.ai は 320×240 JPEG をアプリへ送信します。

RTSPReal-Time Streaming Protocol

hotspot と streaming の処理が成功した後、対応デバイスの live camera stream を再生するための session URL です。

JPEG Live Streaming

圧縮済み JPEG 画像を callback で受け取る stream です。各 callback が返すのは画像であり、未 decode の raw video frame ではありません。

RTMPReal-Time Messaging Protocol

live stream を対応 endpoint へ中継する任意の配信経路です。lifecycle はデバイス session や local player とは別に管理します。

Media File Import

DeviceMediaFileImportAPI が提供するデバイスからアプリへの hotspot 処理です。metadata の取得、選択ファイルの download、任意のローカル video stabilization を実行できます。

MediaCountInfoModel

更新要求の成功後にデバイスが通知する、対応 media category ごとの現在の件数です。

StorageInfoModel

デバイスが通知する現在の使用済み容量と空き容量です。公開 model では megabyte 単位で表します。

OTA アップデート

OTAOver-the-Air Update

ホストアプリが用意した互換性のあるローカル firmware package から、デバイスの main firmware を更新します。

Camera OTA

対応 camera module 専用の firmware 更新処理です。hotspot 接続、ローカル HTTP 配信、転送、書き込み、完了確認を行います。

OTA Battery Limit

main firmware 更新の開始に必要なデバイスの最低 battery percentage です。通知値が 0 の場合、battery threshold はありません。

SDK アーキテクチャ

SDKDelegate / DeviceDelegate

SDKDelegate は SDK 全体の検索とデバイス event、DeviceDelegate は個別デバイスの event を受け取ります。

All-in-One

対応 SDK 一式をまとめて導入・初期化するための構成です。modular integration では dependency と plugin をより細かく制御できます。

Bridge Plugin

サービス固有の認証や機能を公開 plugin boundary を通じて core SDK へ接続する任意の adapter です。

ConnectParams

user identity、pairing data、Classic Bluetooth の設定、任意の AI 認証 parameter など、接続ごとに指定する値です。

LogService

プロセス全体で有効な LogService backend です。設定した 1 つの出力先が log を処理し、対応する永続出力先では export と cleanup も利用できます。

SDKConfiguration

log level、scan timeout、自動再接続、既知デバイスの検索 filter など、確認済み SDK 動作の初期化時 default 値です。