SDK Sözlüğü

AIBuds SDK belgelerinde kullanılan terimlerin kısa açıklamaları. Özelliklerin kullanımı ilgili kılavuzlarda, SDK bileşenlerinin ilişkisi ise Mimari sayfasında açıklanır.

Bluetooth ve Bağlantı

BLEBluetooth Low Energy

Cihaz bulma, SDK kontrol bağlantısı kurma ve komut alışverişi için kullanılan kablosuz yol. Desteklenen cihaz protokolünü ABMate modülü uygular.

RSSIReceived Signal Strength Indicator

Bir BLE ilanının alınan gücünü gösteren işaretli dBm değeri. Yakınlık için ipucudur; mesafe ölçümü veya bağlantı kalitesi garantisi değildir.

Advertisement Data

Bir peripheral'ın BLE yayınındaki metadata. Bulunan cihaz handle'ı bu anlık görüntüyü peripheral ve RSSI ile birlikte sunar.

Core Bluetooth ObjectsCBCentralManager / CBPeripheral

Apple central manager tarama ve bağlantıları yönetir; peripheral tek bir uzak BLE cihazını temsil eder. SDK bu nesneleri cihaz soyutlamalarıyla kapsar.

Classic Bluetooth

Genellikle ses profilleri için kullanılan ayrı Bluetooth yolu. Bağlantı durumu BLE kontrol bağlantısından bağımsızdır.

SCOSynchronous Connection-Oriented

Desteklenen cihazlarda çift yönlü arama veya konuşma sesi için kullanılan Classic Bluetooth ses bağlantısı.

Beacon Data

Etkin bağlantı olmadan yayınlanan isteğe bağlı manufacturer data. Yalnızca bulunan cihaz beacon payload sunuyorsa kullanın.

Cihaz Kavramları

Discovered DeviceFoundDeviceConvertible

FoundDeviceConvertible ile temsil edilen tarama sonucu. Kaydetmeden veya bağlanmadan önce SDK üzerinden dönüştürün.

Storable DeviceDeviceConvertible

Kimlik, bağlantı durumu, kayıt, komutlar, delegate ve özellik kontrolleri için kullanılan kalıcı DeviceConvertible handle'ı.

StoredDevicesMgr

Uygulamanın kalıcı cihaz listesini süreç genelinde yöneten nesne. Kaydedilen cihazlar desteklenen otomatik yeniden bağlantıya katılabilir.

Device Ready

Bağlantı ve SDK handshake tamamlandıktan sonraki lifecycle noktası. Özellik komutlarından önce deviceDidReady olayını bekleyin veya isConnectedAndReady değerini denetleyin.

Capability Protocol

Yalnızca cihaz ilgili özelliği desteklediğinde uygulanan küçük ve isteğe bağlı *API protokolü. Her modelin aynı yeteneklere sahip olduğunu varsaymak yerine gerekli protokole cast edin.

Device State

Cihazın bildirdiği çalışma durumu. Yalnızca BLE bağlantısını anlatan Core Bluetooth peripheral state değerinden farklıdır.

Work Mode / Work State

Work mode yapılandırılmış çalışma modu, work state ise bildirilen güncel etkinliktir. Her ikisini de delegate event ile değişebilen cihaz snapshot'ları olarak değerlendirin.

Wear Detection

Takma algılama desteğini, etkinlik durumunu ve mevcut takılma durumunu bildiren cihaz özelliği.

TWSTrue Wireless Stereo

Eşleştirilmiş sol ve sağ kablosuz cihazları tanımlar. SDK, TWS kimliğini ve eş cihazın bağlantısını ayrı ayrı sunar.

Auto Reconnect

Uygulama açılışı veya Bluetooth yeniden başlatması sonrası yeniden bulunan kayıtlı cihazın bağlanıp bağlanmayacağını cihaz bazında belirler. İlk değer SDK configuration'dan gelir.

Ses ve Konuşma

VADVoice Activity Detection

Konuşmayı sessizlikten veya arka plan gürültüsünden ayıran sinyal işleme. AI ses entegrasyonları giriş sesini bölmek veya filtrelemek için kullanabilir.

Standard Recording

Cihaz ses kaydı özelliği üzerinden başlatılıp durdurulan cihaz tarafı kayıt. Komut sonucu doğrudan yerel bir ses dosyası döndürmez.

AI Audio Recording

Cihaz ile AI hizmetinin birlikte yürüttüğü akış: cihaz sesi sağlar, seçilen hizmet session event, transcript güncellemeleri ve son report üretir.

Recording Scene

AI ses yakalama başlatılırken verilen cihaz kayıt context'i. Genel değerler ortam ve arama kaydı sahnelerini ayırır.

PCMPulse-Code Modulation

Sıkıştırılmamış dijital ses sample'ları. PCM kolay işlenir ancak sıkıştırılmış sese göre daha fazla bant genişliği ve depolama kullanır.

Opus

Desteklenen konuşma ve streaming yollarında kullanılan düşük gecikmeli sıkıştırılmış ses codec'i.

On-Device Voice Assistant

Desteklenen wearable firmware'de OnDeviceVoiceAssistantAPI ile sunulan uyandırma ve komut işleme. Yetkilendirme için kayıtlı bridge plugin ve entegrasyon ortamı gerekebilir.

AI ve Konuşma İşleme

ASRAutomatic Speech Recognition

Konuşma sesini metne dönüştürür. SDK, session tabanlı streaming recognition ve desteklenen girişlere yönelik service API'ler sunar.

Streaming ASR

Tek bir son sonucu beklemek yerine ses gelirken transcript'i aşamalı olarak güncelleyen tanıma yöntemi.

TTSText to Speech

Metni ses dosyasına dönüştürür. TTSResultModel, göreli audioFile, audioFormat ve çözümlenmiş audioFilePath değerlerini sağlar.

AI Summary

Kaynak metin veya transcript'ten özet sonuç üretir. Desteklenen hizmetler sonucu aşamalı iletebilir.

Text Translation

Verilen metni yapılandırılmış diller arasında çevirir. Kesintisiz konuşma session akışlarından ayrı bir özelliktir.

Simultaneous Interpretation

Gelen ses, streaming recognition, çeviri ve desteklenen hedef dil ses çıkışını birleştiren canlı session.

AI Chat

Transcript, chat, intent, ses, lifecycle, error ve son report event'leri üretebilen AI hizmeti destekli konuşma session'ı.

AI Intent

Chat etkileşiminden çıkarılan yapılandırılmış action data. Serbest metinden ayrıdır ve yalnızca seçilen hizmet gönderdiğinde anlam taşır.

AI Service ProviderAIServiceVendor / AIBudsAIServiceVendor

AI hizmet çağrıları için seçilen kayıtlı hizmet. Genel enum API adında Vendor korunur; geliştirici belgelerinde service provider kullanılır. Modül kurma, kayıt, başlatma ve seçim ayrı adımlardır.

StarBurst AI.starBurst / AIBudsAIServiceVendorStarBurst

ByteDance tarafından sağlanan AI hizmeti. Uygulama, seçimden önce AIBudsStarBurst modülündeki StarBurstSDK ile kaydeder.

MltCloud AI.mltcloud / AIBudsAIServiceVendorMltcloud

Meilc tarafından sağlanan AI hizmeti. Uygulama, seçimden önce AIBudsMagicHelper modülündeki MagicHelperSDK ile kaydeder.

Authorized Services

Yetkilendirme handshake'ini tamamlayan desteklenen hizmetleri bildiren cihaz bitmask'i. Kurulu tüm AI modüllerinin genel listesi değildir.

AI Dashboard

Geliştirme veya sorun giderme sırasında AI session, event, report ve error kayıtlarını incelemek için isteğe bağlı yerel tanılama arayüzü.

Ses Ayarı

EQEqualizer

Frekans bandı gain değerlerini uygulayan cihaz ayarı. Custom EQ sınırları henüz eksiksiz bir genel sözleşme olmadığından cihazın bildirdiği ayarları tercih edin.

Preset EQ

Fabrika tuning profile gibi cihazın sağladığı equalizer ayarı. Kullanılabilir preset'ler cihaz ve firmware'e göre değişir.

ANCActive Noise Cancellation

Ortam sesini azaltan cihaz işlemesi. Genel mode ayrıca normal ve transparency davranışlarını ayırır.

Transparency Mode

Ortam sesini bastırmak yerine wearable üzerinden geçiren ANC mode'u.

ANC Fade

ANC davranışını kademeli değiştiren geçiş ayarı. Duyulabilir etkiyi cihaz belirler.

Volume Domains

System prompt, media, call ve okunabilir local playback state için bağımsız ses düzeyleri. Yazılabilir kontrol sunmadan önce cihaz yeteneğini denetleyin.

VolumeSetCapability

Geçerli cihazın desteklediği ses düzeyi ayarlama işlemlerini belirten bitmask.

Görüntü, Streaming ve Depolama

Remote Shutter

Cihazdan host app'e camera açma, çekim veya çıkış isteği. Camera işlemini uygulama yürütür ve sonucu cihaza bildirir.

Capture Mode

CaptureMode içinde .camera yüksek çözünürlüklü fotoğrafı cihazda saklar, .ai ise 320×240 JPEG'i uygulamaya gönderir.

RTSPReal-Time Streaming Protocol

Hotspot ve streaming akışı başarıyla tamamlandıktan sonra desteklenen cihazın canlı camera stream'ini oynatmak için kullanılan session URL'si.

JPEG Live Streaming

Tam sıkıştırılmış JPEG görüntülerini callback ile veren stream. Her callback, decode edilmemiş raw video frame değil bir görüntü iletir.

RTMPReal-Time Messaging Protocol

Live stream'i uyumlu endpoint'e aktaran isteğe bağlı yayın yolu. Lifecycle'ı cihaz session'ı ve local player'dan ayrıdır.

Media File Import

DeviceMediaFileImportAPI ile sunulan cihazdan uygulamaya hotspot akışı. Metadata alır, seçilen dosyaları indirir ve isteğe bağlı yerel video stabilization çalıştırır.

MediaCountInfoModel

Başarılı yenileme isteğinden sonra cihazın bildirdiği desteklenen media category sayıları.

StorageInfoModel

Cihazın bildirdiği güncel kullanılan ve boş depolama değerleri. Genel modelde megabyte cinsindedir.

OTA Güncellemeleri

OTAOver-the-Air Update

Host app'in sağladığı uyumlu yerel firmware package ile cihazın main firmware'ini günceller.

Camera OTA

Desteklenen camera module için ayrı firmware akışı; hotspot bağlantısı, yerel HTTP aktarımı, transfer, flashing ve tamamlanmayı içerir.

OTA Battery Limit

Main firmware güncellemesinin başlayabilmesi için gereken minimum battery percentage. 0, battery threshold olmadığını belirtir.

SDK Mimarisi

SDKDelegate / DeviceDelegate

SDKDelegate SDK genelindeki tarama ve cihaz event'lerini, DeviceDelegate tek cihazın event'lerini alır.

All-in-One

Desteklenen SDK paketinin tamamı için toplu kurulum ve kolay initializer. Modular integration, host app'e dependency ve plugin üzerinde daha ayrıntılı kontrol verir.

Bridge Plugin

Hizmete özgü kimlik doğrulama veya servisleri genel plugin sınırı üzerinden core SDK'ya bağlayan isteğe bağlı adapter.

ConnectParams

User identity, pairing data, Classic Bluetooth tercihi ve isteğe bağlı AI authorization parameter gibi bağlantıya özel değerler.

LogService

Süreç genelinde etkin LogService backend'i. Yapılandırılmış tek hedef çıktıyı işler; desteklenen kalıcı hedefler export ve cleanup da sunar.

SDKConfiguration

Log level, scan timeout, auto reconnect ve bilinen cihaz discovery filtering gibi doğrulanmış SDK davranışlarının başlatma varsayılanları.