Ana içeriğe geç

Çevrimdışı Sesli Asistan Kimlik Doğrulaması

İsteğe bağlı AIBudsVoiceAssistant modülü, desteklenen aygıtı çevrimdışı sesli asistan için doğrular. Bu kimlik doğrulama köprüsü, Sesli Asistan altında asistanın kapalı, temel veya gelişmiş çalışma modunu seçmekten farklıdır.

Animated workflow

On-device assistant authentication

Core triggers the registered plugin only when a connected supported device requires authentication.

Device + Core

Connect Device

Complete the normal supported-device connection flow.

AIBuds Core

Detect Requirement

Core determines whether assistant authentication is required.

Voice Assistant

Start Plugin

Pass device identity to the registered voice assistant bridge.

Plugin ↔ device

Exchange Opaque Data

Relay encrypted authentication data without host parsing.

bridge traffic
Host app

Receive Final Result

Deliver success or error through the SDK/device delegate.

Successful bridge transport is intermediate progress. The delegate authentication result is the terminal host-app signal.

Kimlik Doğrulama Akışı​

Core aygıt uygulaması kimlik doğrulamanın ne zaman gerektiğine karar verir. Kayıtlı OnDeviceVoiceAssistantBridgePlugin, OnDeviceVoiceAssistantDevice üzerinden ayrıştırılmayan köprü verilerini aktarır. Ana uygulama nihai sonucu gözlemler; köprü yüklerini ayrıştırmamalı, saklamamalı veya değiştirmemelidir.

AI desteğiyle uygulayın

AI ile geliştirin

Bu iş akışını AI ile uygulayın

Resmî “AIBuds Cihaz Üstü Sesli Asistanını Yönetme” becerisini kullanarak iş akışını uygulamanıza uyarlayın.

https://docs-aibuds.github.io/tr/skills/manage-aibuds-on-device-voice-assistant adresini okuyup yönergeleri izleyin. Bu beceriyle “AIBuds Cihaz Üstü Sesli Asistanını Yönetme” iş akışını iOS projesinde uygulayıp doğrulayın.
Resmî beceriyi görüntüle

Kayıt Sahipliği​

AIBudsAllInOneSDK.initialize, OnDeviceVoiceAssistantPlugin.shared öğesini kaydeder. Modüler entegrasyon AIBudsVoiceAssistant içermeli ve aygıt bağlanmadan önce bu köprüyü kaydetmelidir. Kaydı Core başlatmayla aynı uygulama düzeyi sahibinde tutun.

Uygulamaya açık elle “şimdi doğrula” özellik API'si yoktur. SDK gerekli olduğuna karar verdiğinde kimlik doğrulama, desteklenen aygıt bağlantı akışı tarafından tetiklenir.

Nihai Sonucu İzleyin​

SDK veya aygıt delegesi geri çağrısını uygulayın:

Swift
func device(
    _ device: DeviceConvertible,
    didReceiveOnDeviceVoiceAssistantAuthResult isSuccess: Bool,
    error: NSError?
) {
    // Update product state on the main queue.
}

Bu geri çağrı ana uygulama için nihai sinyaldir. Köprü verisinin başarıyla gönderilmesi yalnızca aktarım ilerlemesidir; kimlik doğrulama başarısı değildir.

Sıralama ve Yeniden Deneme​

Başka bir AI kimlik doğrulama köprüsü de gerektiren aygıtlarda SDK, çevrimdışı sesli asistan doğrulamasını önceki sonucun ardından sıralayabilir. Arayüz kodundan rakip bir doğrulama denemesi başlatmayın.

Mevcut genel sözleşme elle yeniden deneme API'si, zaman aşımı, kalıcı doğrulama süresi veya eksiksiz hata kodu kurtarma tablosu tanımlamaz. Hata durumunda tanılama için hatayı koruyun, ürün politikası doğrulama gerektiriyorsa asistan modlarını kullanılamaz tutun ve sonraki denemeyi belgelenmiş yeniden bağlantı ya da gelecekteki SDK yeniden deneme sözleşmesine bırakın.

Güvenlik Sınırı​

  • Köprü verisini ayrıştırılmayan kimlik bilgisi malzemesi olarak ele alın.
  • Üretimde yük baytlarını, aygıt kimliğini veya türetilmiş sırları asla günlüğe yazmayın.
  • Köprü paketlerini önbelleğe almayın veya yeniden oynatmayın.
  • Eklenti ile şifreleme bağımlılığını eşleşen SDK sürümlerinde tutun.
  • Kullanıcıya yalnızca işlem yapılabilir hata durumunu gösterin; ayrıntılı hataları korumalı tanılama verilerinde saklayın.

Doğrulama Kontrol Listesi​

  • Köprü eklentisi aygıt bağlantısından önce kaydediliyor.
  • All-in-One ve modüler kayıt yolları karıştırılmıyor.
  • Arayüz nihai delege geri çağrısını bekliyor.
  • Ana uygulama köprü paketlerini ayrıştırmıyor veya saklamıyor.
  • Hata, kimlik doğrulama gerektiren asistan modunu sessizce etkinleştirmiyor.
  • Bağlantı kesme ve yeniden bağlanma davranışı desteklenen her aygıt ailesinde test ediliyor.