Sesuaikan media

Media termasuk dalam rangkaian aplikasi sistem (misalnya, Dialer dan Peluncur Aplikasi). Aplikasi ini berbagi gaya dan aset umum yang ditentukan pada tingkat berbeda dalam struktur AOSP.

• framework/base . Semua gaya dasar Android ditentukan di sini.
• packages/services/Car/car_product/overlay . Berisi overlay waktu build yang memodifikasi framework/resource dasar standar untuk menghasilkan tampilan dan nuansa AOSP Android Automotive OS. OEM dapat memilih untuk mengecualikan overlay ini dan menggunakan overlay mereka sendiri.
• packages/apps/Car/libs/car-ui-lib . Pustaka ini mendefinisikan komponen dan sumber daya AAOS yang umum untuk aplikasi sistem dan aplikasi terpisah yang dirancang untuk penyesuaian. Untuk detailnya, lihat Panduan Integrasi Perpustakaan UI Mobil .
• packages/apps/Car/libs/car_app_common . Warna dan gaya umum yang digunakan bersama di antara aplikasi sistem Otomotif. OEM dapat menggunakan overlay untuk menyesuaikan elemen ini (mirip dengan car_product/overlay yang dijelaskan di atas).
• packages/apps/Car/libs/car_media_common . Berisi elemen yang dibagikan antara Media dan UI media lainnya. Misalnya, widget Media layar Beranda.

• packages/apps/Car/Media. Semua aplikasi sistem menggunakan temanya sendiri, yang dikembangkan dari Theme.CarUi , sebagaimana didefinisikan dalam car-ui-lib .

Android Automotive AOSP menyediakan dua media presentasi.

• UI Media. Memungkinkan pengguna untuk masuk, menelusuri konten, dan menggunakan kontrol pemutaran terperinci.
• Widget media layar beranda. Memungkinkan penggunaan fitur kontrol pemutaran media inti ke layar Beranda.

Antarmuka pengguna media

Gambar ini menjelaskan struktur Media UI:

Gambar 1. Antarmuka pengguna media.

Untuk detail tentang pedoman UX dan UI serta struktur spasial berbagai komponen Media, lihat Model spasial .

Tampilan Bar Aplikasi: Bilah Alat

Toolbar Media UI adalah komponen yang digunakan bersama dengan aplikasi sistem lain, seperti Dialer dan Radio. Untuk mempelajari cara menyesuaikan toolbar, lihat Panduan Integrasi Perpustakaan UI Mobil .

Ukuran karya seni maksimum media

Untuk memberi tahu aplikasi media tentang ukuran maksimum karya seni yang akan diambil, Anda dapat menghamparkan media_items_bitmap_max_size_px di sistem Anda. Untuk melakukannya, kirim EXTRA_MEDIA_ART_SIZE_HINT_PIXELS sebagai petunjuk root. Hasilnya, Anda akan menghemat bandwidth saat mendownload gambar. Untuk mempelajari lebih lanjut, lihat MediaConstants di developer.android.com.

Jelajahi fragmen

Telusuri terutama terdiri dari Car UI RecyclerView , yang menangani posisi bilah gulir, panah, dan margin serta dapat menelusuri item dari berbagai jenis, seperti header, item kisi, item kisi ikon, item daftar, dan item daftar ikon.

Kontrol pemutaran yang diperkecil

Saat fragmen penelusuran ditampilkan, dan saat item media dipilih, tampilan kontrol pemutaran yang diperkecil ditampilkan. Gambar berikut mengilustrasikan struktur pandangan ini:

Gambar 2. Kontrol pemutaran yang diperkecil.

Telusuri daftar

Pengembang dapat menggunakan serangkaian petunjuk gaya (lihat Menerapkan Gaya Konten ) untuk menyesuaikan presentasi konten penelusuran media. OEM harus mematuhi gaya ini, menyesuaikan presentasi dengan sistem desain mereka.

Jenis item yang didukung dan tata letaknya masing-masing terletak sebagai berikut:

• LIST_ITEM ( media_browse_list_item.xml ). Biasa digunakan untuk episode dalam podcast, seperti item playlist, dan favorit.
• ICON_LIST_ITEM ( media_browse_list_icons_item.xml ). Digunakan untuk kategori atau pilihan menu, di mana gambar yang disertakan dengan item media bukanlah sampul album sebenarnya, melainkan sebuah ikon.
• GRID_ITEM ( media_browse_grid_item.xml ). Biasa digunakan untuk item yang dapat diputar, seperti lagu atau playlist.
• ICON_GRID_ITEM ( media_browse_grid_icons_item.xml ). Digunakan untuk kategori, mirip dengan ICON_LIST_ITEM .
• HEADER ( media_browse_header_item.xml ). Digunakan untuk mengatur item media menjadi beberapa bagian.

Layar pemutaran

Untuk menampilkan layar ini, perluas kontrol pemutaran yang diperkecil:

• Sedang memutar media item media (termasuk judul dan subjudul).
• Kontrol pemutaran lengkap.
• Antrean pemutaran (digunakan untuk menampilkan item yang baru saja diputar atau item berikutnya yang akan diputar).

Komponen layar Pemutaran diidentifikasi dalam gambar di bawah ini.

Gambar 3. Layar pemutaran.

Layar Pemutaran tidak berbagi toolbar dengan aplikasi lainnya. Sebaliknya, layar ini mengelola elemen di bagian atas layar secara individual.

Atribusi pemformatan audio

Saat aplikasi menyetel KEY_CONTENT_FORMAT_TINTABLE_LARGE_ICON_URI atau KEY_CONTENT_FORMAT_TINTABLE_SMALL_ICON_URI di tambahan item media yang sedang diputar. OEM harus merender vektor drawable yang sesuai seperti yang ditunjukkan oleh URI.

Ikon Format Konten versi besar harus digunakan pada tampilan pemutaran utama. Pada tampilan sekunder, seperti bilah pemutaran yang lebih kecil, OEM dapat menggunakan versi ikon Format Konten yang lebih kecil. ContentFormatView merender ikon optimal berdasarkan atribut logoSize nya.

Tautan pemutaran

Saat aplikasi menyetel KEY_SUBTITLE_LINK_MEDIA_ID atau KEY_DESCRIPTION_LINK_MEDIA_ID , OEM harus merender subjudul atau deskripsi dengan cara yang menunjukkan bahwa subjudul atau deskripsi tersebut dapat disadap, lalu membuka tampilan Telusuri untuk menampilkan item media tertaut saat pengguna mengetuk.

Kontrol pemutaran

Layar Pemutaran mencakup serangkaian kontrol pemutaran yang diperluas, yang disusun dalam baris kontrol . Baris sekunder (ditampilkan di bawah sebagai baris di atas) hanya ditampilkan jika ruang pada baris pertama tidak cukup untuk menampilkan semua tindakan yang dikembalikan oleh aplikasi media dari PlaybackStateCompat#getActions() .

Gambar 4. Kontrol pemutaran.

OEM dapat menyesuaikan ikon tindakan standar, namun mereka harus menampilkan ikon tindakan khusus seperti yang disediakan oleh aplikasi media.

Widget media layar beranda

Widget ini diimplementasikan sebagai sebuah fragmen di car-media-common . Fragmen ini mencakup versi layar Pemutaran yang diperkecil seperti dijelaskan di atas. Semua aturan dan kemampuan penyesuaian yang sama berlaku.

Gambar 5. Widget media layar beranda.

Tombol Pemilih Aplikasi yang ditampilkan di atas menggunakan fungsi peralihan yang dijelaskan dalam Alur Pengguna Peralihan Sumber Media .

Untuk menggunakan ikon Sumber Media saat ini untuk tombol Pemilih Aplikasi, overlay tanda use_media_source_logo_for_app_selector yang ditentukan dalam platform/packages/apps/Car/libs/car-media-common/res/values/bools.xml dan setel ke true . Dengan perubahan ini, ikon Sumber Media di sisi berlawanan dari toolbar aplikasi akan disembunyikan. Penyesuaian ini juga berlaku untuk aplikasi Media Center dan aplikasi Radio referensi.

Gambar 6. Tombol Pemilihan Aplikasi Media.

Tata letak tombol Putar, Jeda, dan Berhenti

Tata letak tombol Putar/Jeda/Berhenti dapat disesuaikan untuk tampilan "Sedang diputar" dan kontrol pemutaran yang diperkecil. Kedua tata letak didefinisikan dalam packages/apps/Car/libs/car-media-common/res/layout/ .

Untuk menyesuaikan tata letak tombol, terapkan overlay waktu pembuatan ke play_pause_stop_button_layout.xml minimized_play_pause_stop_button_layout.xml .

Sorot item saat ini dalam antrean putar

Status item antrean pemutaran saat ini disetel selected , sehingga dapat dikustomisasi menggunakan sumber daya status seperti daftar status warna (lihat Sumber daya daftar status warna ) dan sumber daya dapat digambar dari daftar status (lihat Sumber daya dapat digambar ). Untuk menerapkan perubahan gaya yang diperlukan, Anda dapat mengganti tata letak item antreanpackages/apps/Car/Media/res/layout/queue_list_item.xml , atau yang terpisah

Anda juga dapat menampilkan ikon di samping item antrean putar saat ini:

• Hamparkan tanda Boolean show_icon_for_now_playing_queue_list_item yang ditentukan dalam package/apps/Car/Media/res/layout/queue_list_item.xml , atau yang terpisah

  Untuk menyembunyikan pengatur waktu pemutaran, setel show_time_for_now_playing_queue_list_item ke false .

• Gunakan sumber daya dapat digambar untuk keadaan, misalnya, latar depan atau latar belakang tampilan akar item (lihat paket/apps/Car/Media/res/layout/queue_list_item.xml , atau tampilan terpisah dalam hierarki tampilan item.

Catatan: Secara desain, penyorotan item dalam daftar penelusuran tidak didukung.

Gambar 7. Item yang disorot saat ini dalam antrean pemutaran.