Menggunakan aplikasi pengujian pengontrol media

Aplikasi media yang berinteraksi melalui suara dengan Asisten Google di ponsel Android, mobil, TV, dan headphone didukung oleh API sesi media Android dan menggunakan tindakan media. Siklus proses tindakan media mungkin sulit diikuti. Permainan sederhana dari penelusuran memiliki banyak langkah perantara di mana sesuatu bisa salah, seperti yang ditunjukkan dalam rentang waktu yang disederhanakan:

Pengujian Pengontrol Media (MCT) memungkinkan Anda menguji seluk-beluk pemutaran media di Android dan membantu memverifikasi penerapan sesi media.

MCT menampilkan informasi tentang MediaController aplikasi Anda, seperti PlaybackState dan metadata, serta dapat digunakan untuk menguji kontrol media antar-aplikasi. MCT juga mencakup pengujian verifikasi framework yang memungkinkan Anda mengotomatiskan uji mutu.

Untuk menggunakan MCT, aplikasi Anda harus memiliki layanan browser media dan Anda harus mengizinkan MCT untuk menghubungkannya. Lihat Membuat layanan browser media untuk informasi selengkapnya.

Memulai MCT

Saat meluncurkan MCT, Anda akan melihat dua daftar:

• Active MediaSessions - Daftar ini awalnya kosong saat Anda meluncurkan MCT dan Anda akan melihat pesan "Tidak ditemukan aplikasi media. Notifikasi Izin pemroses diperlukan untuk memindai sesi media yang aktif." Klik Setelan untuk buka layar izin dan aktifkan izin akses untuk MCT.
• Implementasi MediaBrowserService - Daftar ini menampilkan aplikasi yang telah mengimplementasikan layanan browser media. Jika telah mengimplementasikan layanan browser media, aplikasi Anda akan muncul dalam daftar ini, tetapi Anda hanya dapat menggunakan MCT jika Anda telah mengonfigurasi aplikasi untuk menerima semua menghubungkan atau telah memasukkan MCT ke daftar yang diizinkan. Lihat Mengontrol koneksi klien dengan onGetRoot() untuk informasi selengkapnya.

Menguji aplikasi ponsel secara manual

Jika Anda mengizinkan MCT terhubung ke layanan browser media aplikasi, aplikasi Anda akan muncul dalam daftar implementasi daftar layanan browser media. Temukan di sana dan klik Kontrol untuk memulai aplikasi Anda di latar belakang.

Jika tidak, Anda harus terlebih dahulu memulai aplikasi sendiri di latar belakang, lalu mengklik Kontrol kapan muncul di daftar sesi media aktif.

Bersiap dan bermain pengujian

Saat MCT mulai mengontrol aplikasi Anda, MCT akan menampilkan sesi aplikasi saat ini metadata: media yang saat ini dipilih dan tindakan yang disertakan dalam sesi tersebut siap untuk ditangani.

Bagian atas halaman kontrol MCT berisi menu drop-down tempat Anda dapat memilih Penelusuran, URI, ID Media, atau Tidak ada, beserta kolom teks untuk menentukan data input yang terkait dengan Penelusuran, URI, atau ID Media jika pilih salah satu opsi tersebut.

Tombol Prepare dan Play tepat di bawah kolom teks melakukan panggilan yang sesuai (onPrepare(), onPrepareFromSearch(), onPrepareFromUri(), onPrepareFromMediaId(), onPlay(), onPlayFromSearch(), onPlayFromUri(), onPlayFromMediaId()) bergantung pada tindakan yang Anda pilih.

Menguji fokus audio

Aplikasi media yang berperilaku baik harus dapat menangani audio fokus. Anda dapat menguji fokus audio dengan menjalankan aplikasi audio lain bersama aplikasi Anda. Halaman kontrol MCT menyertakan yang meminta dan melepaskan fokus audio.

Untuk menguji fokus audio, ikuti langkah-langkah berikut:

1. Gunakan menu drop-down Fokus Audio untuk memilih salah satu dari tiga petunjuk durasi AUDIOFOCUS_GAIN, AUDIOFOCUS_GAIN_TRANSIENT, atau AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK.
2. Tekan tombol untuk meminta fokus.
3. Tekan tombol lagi untuk melepaskan fokus.

Menguji kontrol transpor

Usap ke kiri untuk menampilkan tampilan UI MCT. Tampilan ini memiliki tombol transpor pengontrol media standar dan menampilkan gambar dan data program. Tombol transport yang dinonaktifkan dilingkari oranye. Yang lainnya aktif.

Uji pemutar Anda menggunakan tombol transport. Status tombol transport harus berubah seperti yang diharapkan. Misalnya, saat Anda menekan tombol PLAY, seharusnya mati, dan tombol PAUSE dan STOP menjadi aktif.

Geser ke kiri lagi untuk tampilan yang menampilkan tindakan opsional. Setiap tindakan memiliki kontrol yang menunjukkan apakah itu aktif atau tidak. Jika aktif, Anda dapat melakukan tindakan dengan mengkliknya.

Jika terhubung dari daftar aplikasi yang memiliki layanan browser media, Anda dapat geser ke kiri dua kali lagi untuk melihat tampilan yang memungkinkan Anda menelusuri konten aplikasi ke atas dan ke bawah hierarki, atau mencari di hierarki konten.

Menguji aplikasi video secara manual

Gunakan mode layar terpisah untuk menguji pengontrol aplikasi video. Pertama, buka aplikasi video di satu jendela, lalu buka MCT dalam mode layar terpisah.

Menjalankan uji verifikasi

Framework pengujian verifikasi menawarkan pengujian sekali klik yang dapat Anda jalankan memastikan bahwa aplikasi media Anda merespons permintaan pemutaran dengan benar.

Menguji aplikasi telepon

Untuk mengakses pengujian verifikasi, klik tombol Uji di samping media .

Status MCT

Tampilan berikutnya menunjukkan informasi mendetail tentang MediaController MCT, misalnya PlaybackState, metadata, dan antrean. Ada dua tombol pada kanan atas {i>toolbar<i}. Tombol di sebelah kiri beralih antara perintah parsable dan log yang diformat. Tombol di sebelah kanan akan menyegarkan tampilan untuk menampilkan informasi terbaru.

Memilih pengujian

Dengan menggeser ke kiri, Anda akan melihat tampilan pengujian verifikasi, tempat Anda dapat melihat daftar pengujian yang tersedia yang dapat di-scroll. Jika pengujian menggunakan kueri, seperti putar dari tes pencarian yang ditunjukkan pada Gambar 7, ada bidang teks untuk memasukkan {i>string<i} kueri.

MCT mencakup pengujian untuk tindakan media berikut, dan pengujian lainnya ditambahkan terus-menerus ke proyek:

• Putar
• Putar dari Penelusuran
• ID Putar Dari Media
• URI Putar Dari
• Jeda
• Berhenti
• Lewati Ke Berikutnya
• Lewati Ke Sebelumnya
• Langsung ke Antrean Item
• Cari Ke

Hasil uji

Area hasil di bagian bawah tampilan pada awalnya kosong. Fungsi ini akan menampilkan hasil saat Anda menjalankan pengujian. Misalnya, untuk menjalankan pengujian putar dari penelusuran, masukkan kueri penelusuran ke kolom teks, lalu klik Run Test. Hal berikut screenshot menunjukkan hasil pengujian yang berhasil.

Menguji aplikasi Android TV

Saat meluncurkan MCT di Android TV, Anda akan melihat daftar aplikasi media yang terinstal. Perhatikan bahwa aplikasi hanya akan muncul dalam daftar ini jika mengimplementasikan browser media layanan.

Memilih aplikasi akan membawa Anda ke layar pengujian, yang menampilkan daftar pengujian verifikasi di sebelah kanan.

Saat Anda menjalankan pengujian, sisi kiri layar menampilkan informasi tentang MediaController yang dipilih. Untuk mengetahui detail selengkapnya, periksa log MCT di Logcat.

Pengujian yang memerlukan kueri ditandai dengan ikon keyboard. Mengklik salah satu pengujian ini akan membuka isian input untuk kueri. Klik Enter untuk menjalankan pengujian.

Untuk mempermudah input teks, Anda juga dapat menggunakan perintah adb:

adb shell input text your-query

Anda dapat menggunakan "%s" untuk menambahkan spasi di antara kata. Misalnya, perintah ini menambahkan teks “{i>hello world<i}” ke kolom input.

adb shell input text hello%sworld

Membuat pengujian

Anda dapat mengirimkan permintaan pull dengan lebih banyak pengujian yang menurut Anda berguna. Untuk mempelajari cara membuat pengujian baru, kunjungi Wiki GitHub MT serta melihat uji verifikasi petunjuk baru.

Tinjau petunjuk kontribusi.

Referensi lainnya

MCT ini dimaksudkan untuk digunakan bersama aplikasi yang mengimplementasikan API media. Lihat Pemutar Musik Android Universal untuk contoh aplikasi semacam itu.

Anda selalu dapat melakukan perbaikan bug dan peningkatan. Lihat petunjuk kontribusi.