Kendi AI Hizmetinizi Kullanma

Kendi AI hizmetinizi kullanmak ayrı bir aygıt iş akışı oluşturmaz. Aygıt bağlantısı, AI istek olayları, aygıtın seçtiği SCO veya Opus ses yolu, oturum koordinasyonu ve temizleme ilgili AIBuds özellik belgesindeki akışı izlemeye devam eder.

Entegrasyondaki fark kimlik doğrulama ve AI işlemedir: ana uygulama kendi hizmetinde kimlik doğrular, sonucu aygıta bildirir ve SDK'nın sunduğu AI hizmeti yerine kendi AI uygulamasını kullanır.

Animated workflow

Self-owned AI authorization handoff

Authenticate the app's AI service, report the result to the device, and then continue the standard device-driven AI flow.

01App ↔ device

D

Connect the Device

Establish the normal AIBuds device connection and wait until the required feature APIs are ready.

02Host app ↔ own AI

H

Authenticate Your AI Service

The host app completes authentication using its own service integration.

03App → device

S

Report the Result

Send true when the service is ready, or false when authentication fails or the service is unavailable.

04Device + app

%

Continue the Standard Flow

The device can continue eligible AI requests and the documented SCO or Opus audio flow after a successful report.

standard AIBuds flow

05Host app ↔ own AI

✓

Process with Your AI

Handle the AI request with the app's own service while preserving the normal device-facing lifecycle.

↳The report synchronizes authorization state with the device. It does not authenticate the AI service or carry credentials.

Değişen Kısım

Ana uygulama, kendi AI hizmetinin kimlik doğrulamasını ve AI'ya özgü istek işlemeyi üstlenir. Her kimlik doğrulama denemesinden sonra güncel sonucu reportSelfAiServiceAuthResult üzerinden bildirir.

Değişmeden Kalan Kısım

AIBuds aygıt iş akışını değiştirmeniz gerekmez. AI Sohbeti, AI Ses Kaydı, Akışlı ASR, Eşzamanlı Çeviri veya uyguladığınız özellik için belgelenmiş aygıt olaylarını, istenen ses kanalını, özellik yaşam döngüsünü, durdurma işlemini ve temizlemeyi kullanmaya devam edin.

Örneğin aygıt Opus girişi istediğinde, ses akışını ancak uygulamanın AI hizmeti yetkilendirildikten ve başarılı sonuç bildirildikten sonra gönderebilir. Aygıt SCO istediğinde uygulama belgelenmiş SCO kayıt yolunu hazırlamayı sürdürür. Kendi AI hizmetinizi kullanmak ses kanalını hangi tarafın seçtiğini değiştirmez.

AI desteğiyle uygulayın

AI ile geliştirin

Kendi AI hizmetinizi AI ile bağlayın

Resmî beceri yalnızca AIBuds cihaz akışını ve entegrasyon sınırını yönlendirir. AI istemcisi, kimlik bilgileri ve hizmet mantığı uygulamaya ait kalır.

https://docs-aibuds.github.io/tr/skills/integrate-aibuds-sdk adresini AIBuds entegrasyon sınırı rehberi olarak okuyup izleyin. Bu iOS projesindeki mevcut uygulamaya ait AI hizmetini belgelenen AIBuds cihaz akışına bağlayın. Mevcut AI istemcisini, kimlik bilgisi sınırını, mimariyi ve ürün davranışını koruyun; AIBuds AI sağlayıcısıyla değiştirmeyin veya SDK'ya kimlik bilgisi göndermeyin. Açık API üzerinden yalnızca yetkilendirme sonucunu bildirin. Hizmet ayrıntıları eksikse uygulamadan önce gerekli soruları sorun.

Entegrasyon becerisini görüntüle↗

Kimlik Doğrulama Sonucunu Bildirme

Swift

Swift

func selfAIAuthenticationDidFinish(isAuthenticated: Bool) {
    guard let serviceAuthAPI = device as? DeviceServiceAuthAPI else { return }

    // Report only the result. Authentication is completed by the host app.
    serviceAuthAPI.reportSelfAiServiceAuthResult(isAuthenticated) {
        reportSucceeded,
        error in

        guard reportSucceeded else {
            print(error?.localizedDescription ?? "Failed to report authorization")
            return
        }

        // A true result allows the device to continue eligible AI flows.
        // A false result keeps the device informed that the service is unavailable.
    }
}

Objective-C

Objective-C

- (void)selfAIAuthenticationDidFinish:(BOOL)isAuthenticated {
    if (![self.device conformsToProtocol:@protocol(AIBudsDeviceServiceAuthAPI)]) {
        return;
    }

    id<AIBudsDeviceServiceAuthAPI> serviceAuthAPI = (id<AIBudsDeviceServiceAuthAPI>)self.device;

    // Report only the result. Authentication is completed by the host app.
    [serviceAuthAPI reportSelfAiServiceAuthResult:isAuthenticated
                                       completion:^(BOOL reportSucceeded, NSError *error) {
                                           if (!reportSucceeded) {
                                               NSLog(@"%@", error.localizedDescription);
                                               return;
                                           }

                                           // A true result allows the device to continue eligible
                                           // AI flows. A false result keeps the device informed
                                           // that the service is unavailable.
                                       }];
}

API sözleşmesinin tamamı için reportSelfAiServiceAuthResult ve Kendi AI Yetkilendirme Sonucunu Bildirme sayfasına bakın.

:::note Tamamlanma anlamı Tamamlanma işleyicisi Boolean sonucun aygıta iletilip iletilmediğini bildirir; ana uygulamanın AI hizmetinde başarıyla kimlik doğruladığını göstermez. Bu API üzerinden belirteç, API anahtarı veya başka kimlik bilgileri göndermeyin. :::

Entegrasyon Kontrol Listesi

• Uygulamanın kendi AI hizmetinde ana uygulama içinde kimlik doğrulayın.
• Yalnızca hizmet AI isteklerini almaya hazır olduğunda true bildirin.
• Kimlik doğrulama başarısız olduğunda veya hizmet kullanılamadığında false bildirin.
• Seçilen AI özelliği için belgelenmiş aygıt olayı, SCO veya Opus, oturum ve temizleme akışını sürdürün.
• Kimlik bilgilerini uygulamanın güvenli hizmet entegrasyonunda tutun; aygıta yalnızca Boolean sonucu bildirin.