Panduan Sertifikasi Tombol Audio

Persiapan Sertifikasi

• Siapkan perangkat pengujian.
  • Anda akan memerlukan 5 perangkat Android.
    • Perangkat ini harus mencakup:
      • Minimal satu Android T (13) dan satu Android V (15).
      • Minimal satu perangkat Samsung dan satu perangkat Pixel.
      • Misalnya:
        • 1 OnePlus (Android 10).
        • 3 Samsung (Android 11, 12, 13).
        • 1 Pixel (Android 15).
  • Satu perangkat tanpa Pengalihan audio:
    • iPhone, PC, laptop yang kompatibel dengan Bluetooth (BT), atau ponsel Android yang menonaktifkan tombol Audio.
      • Anda dapat menonaktifkan fitur Pengalihan audio dari setelan detail perangkat Bluetooth.
    • Kasus pengujian Multipoint (MP) 2.8 memerlukan perangkat tanpa Audio switch selain 5 ponsel pengujian.

• Gabung ke grup pengujian Pengalihan audio dengan akun pengujian Anda agar notifikasi debug ditampilkan di ponsel pengujian.

  • Tindakan ini juga memungkinkan Google mengumpulkan data pengujian melalui Google Analytics.

Klasik dengan A2DP+HFP

• Pastikan semua perangkat Android telah menginstal GmsCore versi 23.xx.xx atau yang lebih baru.

BLE dengan LE Audio

• Setidaknya dua ponsel referensi harus mendukung LE Audio.
  • Misalnya, satu ponsel Samsung dan satu ponsel Pixel yang mendukung LE Audio.
• Pastikan semua perangkat Android telah menginstal GmsCore versi 24.33.xx atau yang lebih baru.

Kriteria Sertifikasi

• Tingkat keberhasilan Pengalihan Target harus melebihi 95% dalam semua kasus pengujian.

• Dalam pengujian yang memerlukan peralihan, koneksi profil dan status aktif peralihan harus selesai dalam waktu 3 detik setelah memicu peristiwa audio dalam setidaknya 75% kasus.

Klasik dengan A2DP+HFP

Pengujian Mandiri harus dilakukan dalam kombinasi berikut:

• Ponsel A=Android S (12) + Ponsel B=Android T (13)
• Ponsel A=Android T (13) + Ponsel B=Android S (12)

BLE dengan LE Audio

Pengujian Mandiri harus dilakukan dalam kombinasi berikut:

• Ponsel A: BT Classic, Ponsel B: BT Classic
• Ponsel A: LE Audio, Ponsel B: BT Klasik
• Ponsel A: BT Classic, Ponsel B: LE Audio

Secara opsional, Penyedia yang mendukung koneksi Dual LE Audio harus menguji:

• Ponsel A: LE Audio, Ponsel B: LE Audio

Panduan Pengujian

Persiapan Perangkat yang Diuji (DUT)

• Verifikasi bahwa perangkat BT belum pernah disambungkan dengan ponsel yang login ke Akun Google pengujian.
  • Jika perangkat telah disambungkan ke Akun Google pengujian, lakukan hal berikut untuk menghapus penyambungan:
    • Di perangkat yang disambungkan:
      • Buka setelan Bluetooth.
      • Pilih "Lupakan Perangkat".
      • Aktifkan dan nonaktifkan Mode pesawat.
  • Pastikan "Simpan perangkat secara otomatis" AKTIF.
    • Tombol ini dinonaktifkan secara default.
    • Anda dapat menemukan opsi ini di Setelan > Google > Perangkat > Perangkat tersimpan (satu per DUT).
  • Setel perangkat Bluetooth ke Mode Penyambungan.
  • Menyambungkan perangkat Bluetooth awal (A).
  • Sambungkan perangkat Bluetooth berikutnya dengan perangkat lain (B, C, D, dll.).

Cakupan

• Semua Headset menjalankan pengujian dari berbagai tab di laporan Self-Test BT Classic atau BT LE Audio.
• Headset yang hanya mendukung mode SinglePoint (SP) menjalankan perintah berikut:
  • Tab Generic_test.
• Headset yang mendukung mode MP menjalankan hal berikut:
  • Tab Generic_test.
  • Tab Multipoint_only.
• Headset MP yang dapat dialihkan ke mode SP menjalankan hal berikut:
  • Tab Generic_test dengan MP nonaktif.
  • Tab Generic_test dengan MP diaktifkan.
  • Tab Multipoint_only dengan MP aktif.

Menyelesaikan Istirahat Mandiri dan Laporan Uji Mandiri

• Buat salinan Laporan Pengujian Mandiri BT Classic atau BT LE Audio.
• Jalankan semua kasus pengujian setidaknya dua kali.

• Pengujian harus dijalankan dalam bentuk berikut:

Klasik dengan A2DP+HFP

• Perangkat B akan menjadi DUT utama.
  • Masukkan detail Perangkat B ke kolom "Ponsel" dan "OS" di bagian atas template.

Contoh kasus pengujian:

• Ponsel pengujian:

  • Perangkat 1: Samsung (Android 13)
  • Perangkat 2: Pixel (Android 12 atau 13) dan lainnya.

• Pengujian yang dijalankan:

  • Jalankan 1. Perangkat A=Samsung S10+ (12), Perangkat B=Pixel 7 pro (13) Kolom D: Ponsel=Pixel 7 pro, OS=Android 13
  • Jalankan 2. Perangkat A=Pixel 7 Pro (13), Perangkat B=Pixel 6(12) Kolom E: Ponsel=Pixel 6, OS=Android 12

Contoh pengujian yang telah selesai dalam template pengujian mandiri:

BLE dengan LE Audio

1. Perangkat A=Android V (15) + Perangkat B=Android T (13)
2. Perangkat A=Android T (13) + Perangkat B=Android V (15)
3. Perangkat A=Android T (13) + Perangkat B=Android S (12)
4. Perangkat A=Android T (15) + Perangkat B=Android V (15)
5. Perangkat B akan menjadi DUT utama.
   • Masukkan detail Perangkat B ke kolom "Ponsel" dan "OS" di bagian atas template.

Contoh kasus pengujian:

• Ponsel pengujian:

  • Perangkat 1: Samsung (Android 13)
  • Perangkat 2: Pixel (Android 15) dan lainnya.

• Pengujian yang dijalankan:

  • [LEA+BT]: Perangkat A= Pixel 8 (15), Perangkat B=Pixel 7 pro (13) kolom D: Ponsel=Pixel 7 pro, OS=Android 13
  • [BT+LEA]: Kolom Device A=Pixel 7 (13), Device B=Pixel 8 (Android 15) E: Phone=Pixel 8, OS=Android 15
  • [BT+BT]: Kolom Device A=Pixel 7 pro (13), Device B=Samsung S10+ (12) E: Phone=Samsung S10+, OS=Android 12
  • [LEA+LEA]: Perangkat A=Pixel 8 (15), Perangkat B=Pixel 8(15) kolom E: Ponsel=Pixel 8, OS=Android 15

Contoh pengujian yang telah selesai dalam template pengujian mandiri:

Peristiwa Audio:

• 4 jenis peristiwa audio yang diuji dan aplikasi pengujian yang direkomendasikan adalah:

  1. Panggilan:
     1. Aplikasi telepon bawaan.
  2. VoIP: Aplikasi VoIP apa pun akan berfungsi, seperti:
     1. Aplikasi pengujian Pengalihan audio.
     2. FB Messenger.
     3. Jalur.
     4. WhatsApp.
     5. Google Meet.
     6. Google Meet.
  3. Media: Pemutar audio apa pun akan berfungsi, seperti:
     1. Aplikasi pengujian Pengalihan audio.
     2. YouTube Music.
     3. Apple Music.
     4. Spotify.
     5. Google Podcasts.
  4. Game:
     1. Aplikasi pengujian Pengalihan audio.

Catatan: Lihat bagian Aplikasi pengujian peralihan audio untuk mengetahui detail selengkapnya.

Informasi Debug:

• Notifikasi diaktifkan setelah bergabung dengan grup fp-sass-partner-test. Berikut beberapa contohnya:

  • Notifikasi status terbaru:

  

  • Tidak ada notifikasi peralihan:

  

  Catatan: 'Status Terbaru' adalah status koneksi saat peristiwa audio terjadi, BUKAN peristiwa terbaru saat ini.
  • Notifikasi latensi peralihan:

  

Pengukuran Latensi

Catatan: "Pencari" berarti ponsel atau tablet yang Anda gunakan untuk terhubung dengan headset dalam pengujian, juga dikenal sebagai perangkat A, B, C, D, atau E dalam kasus pengujian.

• Ada dua jenis latensi peralihan:
  1. Menghubungkan profil Bluetooth ke Seeker yang terputus.
     • Hal ini mencakup semua kasus SinglePoint, dan beberapa kasus MP yang target Pencarinya (perangkat B) terputus.
  2. Mengalihkan Seeker yang terhubung aktif.
     • Hal ini mencakup beberapa kasus MP yang target Pencarinya (perangkat B) sudah terhubung.
• Ada dua cara untuk mengambil info latensi:
  1. Semua latensi dapat di-dump dengan perintah adb.
     • Lihat bagian latensi dump untuk mengetahui detailnya.
     • Perintah ini dapat memberikan dan merekam latensi setelah menyelesaikan setidaknya satu kasus pengujian.
  2. Menggunakan aplikasi pengujian pengalihan audio.
     • Aplikasi yang berjalan di Seeker target akan menampilkan latensi setelah beralih.
     • Jika tidak ada peralihan, aplikasi akan menampilkan alasan 'tidak ada peralihan'.

Aplikasi Pengujian Pengalihan Audio:

• Menggunakan aplikasi untuk memicu peristiwa audio VoIP/Media/Game selama pengujian mandiri akan menyederhanakan penyiapan pengujian dan mengurangi latensi peristiwa Seeker.
  • Versi terbaru dapat didownload di sini.
  • Uji VoIP LE Audio memerlukan kebijakan yang diaktifkan secara manual: > adb root > adb shell settings put global hidden_api_policy 1 > adb reboot

Catatan: Anda memerlukan Akun Google untuk meminta akses ke link download. Pemberian akses adalah proses manual dan dapat memerlukan waktu beberapa hari.

• Penginstalan Aplikasi:
  • Salin APK ke ponsel pengujian Anda dan buka.
  • Atau, gunakan adb install audio_test_app.apk.

Peringatan: Izinkan semua izin saat membuka aplikasi untuk pertama kalinya.

• Jika Anda melihat dialog yang meminta akses notifikasi:
  1. klik "Oke"
  2. Pilih "FP SASS test" di daftar aplikasi
  3. Izinkan akses notifikasi.

Ringkasan Aplikasi:

• Target penyedia

  • Tombol ini akan menampilkan daftar perangkat Bluetooth yang disambungkan saat diklik. Pilih salah satu yang ingin Anda uji.
  • Tombol Hubungkan dan Lepaskan sambungan berfungsi seperti tombol di detail perangkat setelan Bluetooth.

• Status saat ini

  • Kolom ini menampilkan status koneksi terakhir yang diterima Seeker dari Provider menggunakan iklan BLE atau aliran peristiwa.
  • Notifikasi debug peralihan audio juga ditampilkan di sini.

• Jenis pencari

  • Opsi ini digunakan untuk mengalihkan perangkat di antara aliran audio.

Jenis audio

Klasik dengan A2DP+HFP

• VoIP
  • Memilih mode ini akan mengubah mode audio menjadi AudioManager.MODE_IN_COMMUNICATION dan memanggil AudioManager.startBluetoothSco, lalu memutar audio dengan USAGE_VOICE_COMMUNICATION.
  • Jenis aliran adalah STREAM_VOICE_CALL.
  • Status koneksi penyedia akan berubah menjadi CONNECTED_HFP dalam waktu 5 detik.
• Media
  • Memilih mode ini akan memutar audio yang mendukung AVRCP. Jenis penggunaan audio adalah: USAGE_MEDIA.
  • Status koneksi penyedia akan berubah menjadi CONNECTED_A2DP_WITH_AVRCP dalam waktu 5 detik.
  • Status koneksi dapat berubah sebentar menjadi CONNECTED_A2DP_ONLY saat dimulai atau dihentikan.

• Game

  • Memilih mode ini akan memutar audio yang tidak mendukung AVRCP. Jenis penggunaan audio adalah: USAGE_GAME.
  • Status koneksi penyedia akan berubah menjadi CONNECTED_A2DP_ONLY dalam waktu 5 detik.
  Catatan: Ponsel Samsung akan menyetel status koneksi ke CONNECTED_A2DP_WITH_AVRCP, bukan CONNECTED_A2DP_ONLY. Lihat bagian Masalah Umum untuk mengetahui detail selengkapnya.

BLE dengan LE Audio

• VoIP

  • Memilih mode ini akan mengubah mode audio menjadi AudioManager.MODE_IN_COMMUNICATION dan memutar audio dengan USAGE_VOICE_COMMUNICATION.
  Catatan: Untuk versi Android yang lebih lama dari Tiramisu (Android 13), aplikasi pengujian memanggil AudioManager.startBluetoothSco untuk memulai koneksi audio SCO Bluetooth. Jika tidak, aplikasi pengujian akan memanggil AudioManager.setCommunicationDevice untuk memilih perangkat audio yang digunakan untuk komunikasi.
  • Jenis aliran adalah STREAM_VOICE_CALL.
  • Status koneksi penyedia akan berubah menjadi CONNECTED_LE_AUDIO_CALL dalam waktu 5 detik.

• Media

  • Memilih mode ini akan memutar audio dengan jenis streaming sebagai STREAM_MUSIC. Jenis penggunaan audio adalah: USAGE_MEDIA.
  • Status koneksi penyedia akan berubah menjadi CONNECTED_LE_AUDIO_MEDIA_WITH_CONTROL dalam waktu 5 detik.
  • Status koneksi dapat beralih sebentar ke CONNECTED_LE_AUDIO_MEDIA_WITHOUT_CONTROL saat dimulai atau dihentikan.

• Game

  • Memilih mode ini akan memutar audio yang tidak dapat dikontrol langsung oleh pengguna. Jenis penggunaan audio adalah: USAGE_GAME.
  • Status koneksi penyedia akan berubah menjadi CONNECTED_LE_AUDIO_MEDIA_WITHOUT_CONTROL dalam waktu 5 detik.

• Tombol Putar dan Berhenti

  • Tombol PUTAR dan HENTIKAN memulai atau menghentikan audio.

• Hasil penukaran

  • Kolom ini menampilkan latensi aktif Connect dan Switch. Dialog ini juga menampilkan alasan penolakan peralihan jika peristiwa audio dipicu tetapi peralihan tidak terjadi.
  • Latensi diukur dalam milidetik (ms).
  • Secara umum, latensi diukur dari awal pemicu peralihan Audio hingga penerimaan peristiwa peralihan multipoint atau profil BT yang terhubung.
  • Pengalihan yang dipicu penyedia mengukur latensi dari awal audio.

Latensi Dump

• Perintah berikut memungkinkan pengguna merekam pengukuran latensi saat menjalankan pengujian manual: adb shell dumpsys activity service com.google.android.gms/.nearby.discovery.service.DiscoveryService
  • Pengukuran latensi ditampilkan di bagian NearbyDeviceManager's SwitchHistory:

            NearbyDeviceManager
              Nearby Sass device count: 1
                Sass device - address:XX:XX:XX:XX:XX:XX, name:Googler's Pixel Buds, accountKey:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX, modelId:6edaf7
                  SwitchHistory
                    15:30:21:166 - 15:30:25:201, latency 3035ms, Succeed, SASS_TRIGGERED_CONNECT, SASS switch, A2DP
                    15:34:58:568 - 15:34:58:568, latency 0ms, Succeed, SWITCH_ACTIVE_TO_SELF, SASS switch, HFP
                    15:36:26:615 - 15:36:31:603, latency 1988ms, Succeed, SASS_TRIGGERED_CONNECT, SASS switch, A2DP
                    15:37:56:108 - 15:37:56:250, latency 142ms, Succeed, SWITCH_ACTIVE_TO_SELF, SASS switch, A2DP"

• Setiap peralihan yang tidak dapat diukur oleh GmsCore (misalnya, peralihan aktif untuk HFP) akan dicatat sebagai latensi 0 md.

Referensi pola log:

Masalah Umum:

Berikut adalah bug umum yang disebabkan oleh Seeker:

1. Pengalihan audio game yang salah.
   • Ponsel Samsung akan menyetel status koneksi ke CONNECTED_A2DP_WITH_AVRCP, bukan CONNECTED_A2DP_ONLY saat bermain game.
   • Beberapa game (seperti Candy Crush) dapat memutar ulang musik latar belakang dan memicu peristiwa audio baru tanpa input pengguna. Ponsel yang terhubung dapat terus-menerus mengalihkan audio di setiap ponsel yang membuka game.