Ses Düzeyi Denetimine Genel Bakış

Ses Düzeyi Denetimi; cihazın ses ayarlama yeteneğini, güncel ses düzeyi bilgilerini ve desteklenen ses kanallarını doğrudan ayarlamaya veya adımlı değiştirmeye yönelik komutları sunar.

Özelliklere Genel Bakış

📄️Ses Düzeyi Yeteneğini ve Değerlerini Görüntüleme

Cihazın ses ayarlama yeteneğini ve güncel ses düzeyi bilgilerini okuyun

📄️Ses Düzeyini Ayarlama

Desteklenen cihaz ses kanallarını ayarlayın veya adımlı olarak değiştirin

AI desteğiyle uygulayın

AI ile geliştirin

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

Resmî “AIBuds Ses Düzeyini Yönetme” becerisini kullanarak iş akışını uygulamanıza uyarlayın.

https://docs-aibuds.github.io/tr/skills/manage-aibuds-volume adresini okuyup yönergeleri izleyin. Bu beceriyle “AIBuds Ses Düzeyini 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 - DeviceVolumeControlAPI desteğini doğrulayın.
3. Yeteneği Okuyun - Denetimleri göstermeden önce volumeSetCapability değerini kullanın.
4. Güncel Değerleri Okuyun - İsteğe bağlı volumesInfo durum bilgisini kullanın.
5. Desteklenen Bir Kanalı Ayarlayın - Bir DeviceVolumeType değeriyle 0-100 arasında bir düzey kullanın.

Temel Kavramlar

Yetenek

VolumeSetCapability; .none, .common veya .advanced değerini bildirir.

• .none, SDK üzerinden ses düzeyi ayarlamayı desteklemez.
• .common; sistem bildirim sesi, medya ve görüşme sırasındaki ses düzeyi denetimlerini destekler.
• .advanced, güncel durum bilgisine yerel oynatma ses düzeyini de ekler; ancak mevcut genel SDK bu değeri yazmak için bir API sunmaz.

Ses Kanalları

DeviceVolumeType şu anda sistem bildirim sesi, medya oynatma ve görüşme ses düzeylerini içerir. Her ayarlayıcı 0-100 arasında bir değer kabul eder.

Protokol Referansı

Ses Düzeyi Denetimine DeviceVolumeControlAPI üzerinden erişilir:

Swift

Swift

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

Objective-C

Objective-C

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

En İyi Uygulamalar

1. Yeteneği Denetleyin: .none için değer değiştirme denetimlerini göstermeyin.
2. Düzeyleri Doğrulayın: Doğrudan verilen değerleri 0-100 aralığında tutun.
3. Sürekli Denetimleri Seyreltin: Kaydırıcının her ara değeri için komut göndermeyin.
4. Değişiklikleri İzleyin: Kullanıcı arayüzünün cihazdaki güncellemeleri izlemesi gerekiyorsa didVolumesChanged kullanın.

Notlar

• volumesInfo isteğe bağlıdır; içindeki ayrı değerler de kullanılamayabilir.
• Mevcut SDK localPlaybackVolume değerini okuyabilir ancak ayrı olarak ayarlayamaz. Bu denetimi yalnızca genel bir yazma API'si sunulduktan sonra ekleyin.
• Durum bilgisi okunduktan sonra donanım denetimleri veya başka istemciler cihazın ses düzeyini değiştirebilir.