Müzik Denetimine Genel Bakış

Müzik Denetimi, bağlı AIBuds cihazı üzerinden oynatma ve oynatma ses düzeyi komutları gönderir.

Özelliklere Genel Bakış

📄️Müzik Oynatmayı Denetleme

Oynatmayı, parça geçişini, sessize almayı ve oynatma sesini denetleyin

Başlarken

1. Cihaza Bağlanın - Cihaz bağlanıp hazır olana kadar bekleyin.
2. Protokol Uyumluluğunu Denetleyin - DeviceMusicControlAPI desteğini doğrulayın.
3. Bir Komut Seçin - Oynatın, duraklatın, sonraki ya da önceki parçaya geçin veya oynatma ses düzeyini ayarlayın.
4. Completion Sonucunu İşleyin - Uygulama arayüzünü yalnızca komut başarı bildirdikten sonra güncelleyin.

Temel Kavramlar

Oynatma Komutları

• playMusic oynatmayı başlatır veya sürdürür.
• pauseMusic oynatmayı duraklatır.
• playNextMusic ve playPreviousMusic oynatma kuyruğunda ileri veya geri gider.
• Genel protokol bir durdurma komutu tanımlamaz.

Oynatma Ses Düzeyi Komutları

• musicVolumeUp ve musicVolumeDown, cihazın tanımladığı bir adım kadar değişiklik yapar.
• mute ve unmute, oynatma sesinin kapatılmasını denetler.
• setMusicVolume, 0-100 arasında doğrudan bir değer kabul eder.

Protokol Referansı

Müzik Denetimine DeviceMusicControlAPI üzerinden erişilir:

Swift

Swift

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

Objective-C

Objective-C

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

En İyi Uygulamalar

1. Protokol Uyumluluğunu Denetleyin: SDK ayrı bir Boolean destek sorgusu sunmaz.
2. Her Completion Sonucunu İşleyin: Komut başarısız olduğunda success değerini denetleyin ve error bilgisini bildirin.
3. Kaydırıcıları Seyreltin: Her ara ses düzeyi değerini göndermekten kaçının.
4. Oynatma Değişikliklerini İzleyin: Arayüzün cihaz bildirimlerini izlemesi gerekiyorsa didMediaPlayStatusChanged kullanın.

Notlar

• SDK bu protokol üzerinden etkin oynatıcıyı, parça meta verilerini veya oynatma kuyruğunu sunmaz.
• Komut başarısı, kalıcı bir oynatma durumunu değil komutun yürütüldüğünü doğrular.
• Her ikisi de ses düzeyi işlemleri içerse de Ses Düzeyi Denetimi ile Müzik Denetimi ayrı protokollerdir.