SDK शब्दावली

AIBuds SDK दस्तावेज़ों में प्रयुक्त शब्दों की संक्षिप्त परिभाषाएँ। क्षमताओं का उपयोग संबंधित गाइड में और SDK घटकों का संबंध आर्किटेक्चर पेज पर समझाया गया है।

Bluetooth और कनेक्टिविटी

BLEBluetooth Low Energy: डिवाइस खोजने, SDK नियंत्रण कनेक्शन बनाने और कमांड भेजने का वायरलेस मार्ग। समर्थित डिवाइस protocol को ABMate module लागू करता है।
RSSIReceived Signal Strength Indicator: BLE advertisement की प्राप्त शक्ति बताने वाला signed dBm मान। यह निकटता का संकेत है, दूरी या कनेक्शन गुणवत्ता की गारंटी नहीं।
Advertisement Data: Peripheral के BLE broadcast में शामिल metadata। Discovered-device handle इसे peripheral और RSSI के साथ उपलब्ध कराता है।
Core Bluetooth ObjectsCBCentralManager / CBPeripheral: Apple central manager scanning और connections संभालता है; peripheral एक remote BLE device दर्शाता है। SDK इन्हें अपने device abstractions में wrap करता है।
Classic Bluetooth: सामान्यतः audio profiles के लिए अलग Bluetooth मार्ग। इसकी connection state BLE control connection से स्वतंत्र है।
SCOSynchronous Connection-Oriented: समर्थित डिवाइस पर दो-तरफ़ा call या voice audio के लिए Classic Bluetooth voice link।
Beacon Data: सक्रिय connection के बिना broadcast होने वाला वैकल्पिक manufacturer data। इसे तभी उपयोग करें जब discovered device beacon payload दे।

डिवाइस संबंधी अवधारणाएँ

Discovered DeviceFoundDeviceConvertible: FoundDeviceConvertible के रूप में scan result। Save या connect करने से पहले इसे SDK से convert करें।
Storable DeviceDeviceConvertible: पहचान, connection state, saving, commands, delegates और capability checks के लिए स्थायी DeviceConvertible handle।
StoredDevicesMgr: App की saved device list का process-wide manager। Saved devices समर्थित auto-reconnection में भाग ले सकते हैं।
Device Ready: Connection और SDK handshake पूरा होने के बाद की lifecycle अवस्था। Feature command से पहले deviceDidReady की प्रतीक्षा करें या isConnectedAndReady जाँचें।
Capability Protocol: छोटा वैकल्पिक *API protocol, जिसे डिवाइस feature support होने पर ही लागू करता है। सभी models में समान capability मानने के बजाय आवश्यक protocol में cast करें।
Device State: डिवाइस द्वारा बताई गई working condition। यह केवल BLE link बताने वाली Core Bluetooth peripheral state से अलग है।
Work Mode / Work State: Work mode configured operating mode है; work state वर्तमान reported activity। दोनों delegate events से बदल सकने वाले device snapshots हैं।
Wear Detection: Wear detection support, enabled state और वर्तमान wear status बताने वाली device capability।
TWSTrue Wireless Stereo: Pair किए गए बाएँ और दाएँ wireless devices। SDK TWS पहचान और दूसरे device की connection अलग-अलग बताता है।
Auto Reconnect: App launch या Bluetooth restart के बाद saved device दोबारा मिलने पर reconnect करना है या नहीं, यह per-device behavior तय करता है। प्रारंभिक मान SDK configuration से आता है।

ऑडियो और वॉइस

VADVoice Activity Detection: Speech को silence या background noise से अलग करने वाली signal processing। AI audio integrations इसे incoming audio बाँटने या filter करने में उपयोग कर सकती हैं।
Standard Recording: Device audio-recording capability से शुरू और बंद होने वाली device-side recording। Command result स्वयं local audio file नहीं लौटाता।
AI Audio Recording: Device और AI service का संयुक्त workflow: device audio देता है और चुनी हुई service session events, transcript updates तथा final report बनाती है।
Recording Scene: AI audio capture शुरू करते समय दिया जाने वाला device recording context। Public values on-site और call recording scenes को अलग करते हैं।
PCMPulse-Code Modulation: Uncompressed digital audio samples। PCM सरलता से process होता है, पर compressed audio से अधिक bandwidth और storage लेता है।
Opus: समर्थित voice और streaming paths में उपयोग होने वाला compressed low-latency audio codec।
On-Device Voice Assistant: समर्थित wearable firmware पर OnDeviceVoiceAssistantAPI से उपलब्ध wake-up और command processing। Authorization के लिए registered bridge plugin और integration environment आवश्यक हो सकते हैं।

AI और स्पीच

ASRAutomatic Speech Recognition: Speech audio को text में बदलता है। SDK session-based streaming recognition और समर्थित inputs के service APIs देता है।
Streaming ASR: अंतिम result की प्रतीक्षा किए बिना audio आते समय transcript को क्रमिक रूप से update करने वाली recognition।
TTSText to Speech: Text को audio file में बदलता है। TTSResultModel relative audioFile, audioFormat और resolved audioFilePath देता है।
AI Summary: Source text या transcript से संक्षिप्त result बनाता है। समर्थित services result क्रमिक रूप से दे सकती हैं।
Text Translation: दिए गए text को configured languages के बीच translate करता है। यह continuous speech-session workflows से अलग है।
Simultaneous Interpretation: Incoming audio, streaming recognition, translation और समर्थित target-language audio output को जोड़ने वाला live session।
AI Chat: AI service आधारित conversational session, जो transcript, chat, intent, voice, lifecycle, error और final-report events दे सकता है।
AI Intent: Chat interaction से निकला structured action data। यह free-form text से अलग है और चुनी service द्वारा दिए जाने पर ही अर्थपूर्ण है।
AI Service ProviderAIServiceVendor / AIBudsAIServiceVendor: AI service calls के लिए चुनी गई registered service। Public enum के API नाम में Vendor रहता है, जबकि दस्तावेज़ service provider कहते हैं। Module install, registration, initialization और selection अलग चरण हैं।
StarBurst AI.starBurst / AIBudsAIServiceVendorStarBurst: ByteDance की AI service। App इसे चुनने से पहले AIBudsStarBurst module के StarBurstSDK से register करता है।
MltCloud AI.mltcloud / AIBudsAIServiceVendorMltcloud: Meilc की AI service। App इसे चुनने से पहले AIBudsMagicHelper module के MagicHelperSDK से register करता है।
Authorized Services: Authorization handshake पूरा कर चुकी supported services बताने वाला device-reported bitmask। यह installed AI modules की सामान्य list नहीं है।
AI Dashboard: Development या troubleshooting में AI sessions, events, reports और errors देखने का वैकल्पिक local diagnostic interface।

ध्वनि समायोजन

EQEqualizer: Frequency-band gains लागू करने वाली device setting। Custom EQ constraints अभी पूर्ण public contract नहीं हैं, इसलिए device-reported settings को प्राथमिकता दें।
Preset EQ: Factory tuning profile जैसी device-provided equalizer setting। उपलब्ध presets device और firmware पर निर्भर हैं।
ANCActive Noise Cancellation: Ambient sound कम करने वाली device processing। Public mode normal और transparency behavior भी अलग करता है।
Transparency Mode: Ambient sound दबाने के बजाय wearable से सुनाने वाला ANC mode।
ANC Fade: ANC behavior को धीरे बदलने की supported transition setting। सुनाई देने वाला प्रभाव device-defined है।
Volume Domains: System prompts, media, calls और readable local playback state के अलग device volume values। Writable control देने से पहले device capability जाँचें।
VolumeSetCapability: वर्तमान device द्वारा समर्थित volume-setting operations बताने वाला bitmask।

इमेजिंग, स्ट्रीमिंग और स्टोरेज

Remote Shutter: Device द्वारा host app को camera खोलने, capture करने या बंद करने का request। Camera operation app करता है और result state device को बताता है।
Capture Mode: CaptureMode में .camera high-resolution photo device पर रखता है और .ai 320×240 JPEG app को भेजता है।
RTSPReal-Time Streaming Protocol: Hotspot और streaming workflow सफल होने के बाद supported device का live camera stream चलाने वाला session URL।
JPEG Live Streaming: पूर्ण compressed JPEG images का callback-based stream। हर callback image देता है, undecoded raw video frame नहीं।
RTMPReal-Time Messaging Protocol: Live stream को compatible endpoint तक relay करने का optional publishing path। इसका lifecycle device session और local player से अलग है।
Media File Import: DeviceMediaFileImportAPI द्वारा दिया device-to-app hotspot workflow। यह metadata लाता, selected files download करता और optional local video stabilization चला सकता है।
MediaCountInfoModel: सफल refresh request के बाद device द्वारा बताई गई supported media categories की वर्तमान counts।
StorageInfoModel: Device द्वारा बताई गई used और free storage values। Public model इन्हें megabytes में व्यक्त करता है।

OTA अपडेट

OTAOver-the-Air Update: Host app द्वारा दिए compatible local firmware package से device का main firmware update करता है।
Camera OTA: Supported camera module का अलग firmware workflow, जिसमें hotspot connection, local HTTP delivery, transfer, flashing और completion शामिल हैं।
OTA Battery Limit: Main firmware update शुरू करने के लिए न्यूनतम device battery percentage। 0 का अर्थ कोई battery threshold नहीं।

SDK आर्किटेक्चर

SDKDelegate / DeviceDelegate: SDKDelegate SDK-wide scanning और device events लेता है; DeviceDelegate एक device से जुड़े events लेता है।
All-in-One: पूरे supported SDK suite की aggregate installation और convenience initializer। Modular integration host app को dependency और plugin पर अधिक नियंत्रण देता है।
Bridge Plugin: Provider-specific authentication या services को public plugin boundary से core SDK से जोड़ने वाला optional adapter।
ConnectParams: User identity, pairing data, Classic Bluetooth preference और optional AI authorization parameters जैसे per-connection values।
LogService: Process-wide active LogService backend। एक configured destination output संभालता है; supported persisted destinations export और cleanup भी देते हैं।
SDKConfiguration: Log level, scan timeout, auto reconnect और known-device discovery filtering जैसे confirmed SDK behavior के initialization defaults।

Bluetooth और कनेक्टिविटी​

डिवाइस संबंधी अवधारणाएँ​

ऑडियो और वॉइस​

AI और स्पीच​

ध्वनि समायोजन​

इमेजिंग, स्ट्रीमिंग और स्टोरेज​

OTA अपडेट​

SDK आर्किटेक्चर​

Bluetooth और कनेक्टिविटी

डिवाइस संबंधी अवधारणाएँ

ऑडियो और वॉइस

AI और स्पीच

ध्वनि समायोजन

इमेजिंग, स्ट्रीमिंग और स्टोरेज

OTA अपडेट

SDK आर्किटेक्चर