Takma Algılamaya Genel Bakış

Takma Algılama; cihazın bu yeteneğini, özelliğin etkinlik durumunu ve sol/sağ takılma durumunu sunar. Yapılandırılabilir destek bildiren cihazlarda algılama SDK üzerinden etkinleştirilip devre dışı bırakılabilir.

Özelliklere Genel Bakış

📄️Takma Algılama Yeteneğini Görüntüleme

Cihazın bildirdiği takma algılama yeteneğini okuyun

📄️Takma Algılama Durumunu Görüntüleme

Cihazın bildirdiği etkinlik ve güncel takılma durumunu okuyun

📄️Takma Algılamayı Ayarlama

Yapılandırılabilir cihazda takma algılamayı etkinleştirin veya devre dışı bırakın

AI desteğiyle uygulayın

AI ile geliştirin

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

Resmî “AIBuds Takma Algılamasını Yönetme” becerisini kullanarak iş akışını uygulamanıza uyarlayın.

https://docs-aibuds.github.io/tr/skills/manage-aibuds-wear-detection adresini okuyup yönergeleri izleyin. Bu beceriyle “AIBuds Takma Algılamasını Yönetme” iş akışını iOS projesinde uygulayıp doğrulayın.

Resmî beceriyi görüntüle↗

Başlarken

1. Cihaza Bağlanın - Cihaz bağlanıp hazır olana kadar bekleyin.
2. Protokol Uyumluluğunu Denetleyin - DeviceWearDetectionAPI desteğini doğrulayın.
3. Yeteneği Okuyun - Algılamanın desteklenip desteklenmediğini ve yapılandırılabilir olup olmadığını belirlemek için wearDetectionCapability kullanın.
4. Güncel Durumu Okuyun - isWearDetectionEnabled ve wearStatus özelliklerini kullanın.
5. Desteklendiğinde Yapılandırın - setWearDetection(enabled:completion:) yöntemini yalnızca yapılandırılabilir cihazlarda çağırın.

Temel Kavramlar

Yetenek

WearDetectionCapability üç destek düzeyini birbirinden ayırır:

Değer	Anlamı
.none	Takma algılama desteklenmiyor.
.supportedNotConfigurable	Takma algılama destekleniyor ancak etkinlik durumu bu API üzerinden değiştirilemiyor.
.supportedAndConfigurable	Takma algılama destekleniyor; etkinleştirilebilir veya devre dışı bırakılabilir.

Durum

• isWearDetectionEnabled, algılamanın o anda etkin olup olmadığını bildirir.
• WearStatus; bilinmeyen, takılı değil, yalnızca sol, yalnızca sağ veya iki kulakta durumunu bildirir.
• Yetenek, etkinlik durumu ve takılma durumu ayrı değerlerdir; birini diğerinden çıkarsamayın.

Protokol Referansı

Takma Algılamaya DeviceWearDetectionAPI üzerinden erişilir:

Swift

Swift

guard let device = device as? DeviceWearDetectionAPI else {
    print("Device does not support DeviceWearDetectionAPI")
    return
}

Objective-C

Objective-C

id<AIBudsDeviceWearDetectionAPI> device = (id<AIBudsDeviceWearDetectionAPI>)self.device;
if (![device conformsToProtocol:@protocol(AIBudsDeviceWearDetectionAPI)]) {
    NSLog(@"Device does not support AIBudsDeviceWearDetectionAPI");
    return;
}

En İyi Uygulamalar

1. Yapılandırmadan Önce Yeteneği Denetleyin: Etkinlik durumu yalnızca .supportedAndConfigurable değerinde değiştirilebilir.
2. Mevcut Özellikleri Kullanın: SDK'da bulunmayan sorgu yöntemleri oluşturmak yerine güncel özellikleri okuyun.
3. Değişiklikleri İzleyin: Etkinlik ve takılma durumu değişiklikleri için DeviceDelegate callback'lerini kullanın.
4. Bilinmeyen Durumu Ayrı İşleyin: .unknown ile .notWearing değerlerini birbirinden ayırın.

Notlar

• Bir enum case'inin SDK'da bulunması, her cihazın bu yeteneği desteklediği anlamına gelmez.
• SDK, takılma durumu değiştiğinde otomatik oynatma davranışını garanti etmez; uygulama davranışını ürün gereksinimlerine göre belirleyin.
• SDK Demo'su yetenek ve etkinlik durumunu DeviceWearDetectionAPI üzerinden okur ve yapılandırmayı yalnızca yetenek yapılandırılabilir olduğunda gösterir.