Warna dinamis

Material You design diluncurkan dengan rilis Android 12 dan diperluas dengan Android 13.

Halaman ini berfokus pada pembaruan pada logika Material You untuk membantu Anda berintegrasi dengan dukungan warna dinamis yang lebih kaya.

Palet nada warna dinamis

Mulai Android 12, palet rona warna dinamis berikut didukung:

• system_accent1_0
• system_accent2_0
• system_accent3_0
• system_neutral1_0
• system_neutral2_0 )

Masing-masing terdiri dari kumpulan 13 warna dengan berbagai nilai pencahayaan yang ditentukan seperti yang dijelaskan di R.color , namun dengan nilai rona dan kroma yang tidak ditentukan yang dapat dihasilkan secara dinamis oleh sistem Android saat runtime.

Gaya tema untuk warna dinamis

Dimulai dengan Android 13, enam gaya tema berbeda didukung dengan variasi algoritma warna dinamis yang memenuhi kebutuhan pengembang dan ekspektasi kontras. Berikut ini adalah daftar untuk menghasilkan 65 warna dinamis yang digunakan oleh aplikasi:

• TONAL_SPOT adalah palet dengan kecerahan sedang yang menggunakan warna system_accent3_0 yang analog dengan warna system_accent1_0 (dibawa dari rilis Android 12 dan sedikit disesuaikan).
• VIBRANT adalah palet dengan semangat tinggi yang secara harmonis memadukan perubahan halus antar warna.
• EXPRESSIVE adalah palet dengan semangat tinggi yang memadukan warna aksen unik dan tak terduga.
• SPRITZ adalah palet dengan kecerahan rendah yang menciptakan sapuan lembut antar warna.
• RAINBOW menggunakan aksen kromatik dan permukaan netral untuk menciptakan pengalaman warna yang lebih halus bagi pengguna.
  • Ini TIDAK DIANJURKAN untuk digunakan dengan ekstraksi warna berbasis wallpaper dan sebaiknya digunakan dengan tema warna statis.
• FRUIT_SALAD menyediakan dua warna nada untuk memberikan lebih banyak ekspresi kepada pengguna.
  • Ini TIDAK DIANJURKAN untuk digunakan dengan ekstraksi warna berbasis wallpaper dan sebaiknya digunakan dengan tema warna statis.

Tema sistem didorong oleh pengaturan yang sama seperti di Android 12, yaitu Settings.Secure.THEME_CUSTOMIZATION_OVERLAY_PACKAGES . Untuk Android 13, hanya memerlukan satu kunci pada JSON-nya yang mengirimkan warna sumber untuk menghasilkan 65 palet warna:

{
    "android.theme.customization.system_palette":"746BC1"
}

Gaya tema default adalah TONAL_SPOT , namun Anda dapat menentukan salah satu gaya tema lainnya dengan kunci tambahan menggunakan JSON di atas:

{
    "android.theme.customization.system_palette":"746BC1"
    "android.theme.customization.theme_style":"EXPRESSIVE"
}

Catatan: Anda tidak diharuskan untuk mengekspos SEMUA gaya tema baru di UI Anda, dan dapat memutuskan mana yang akan diekspos berdasarkan kebutuhan pengguna/merek Anda. Namun, palet warna dinamis HARUS dihasilkan melalui salah satu gaya tema ini sebagaimana diuji CTS oleh SystemPaletteTest#testThemeStyles dan diamanatkan oleh CDD.

Mengintegrasikan warna dinamis

Untuk panduan tentang pengintegrasian warna dinamis, lihat Mengintegrasikan Material yang Anda Desain .

Pertanyaan yang sering diajukan (FAQ)

Apa yang termasuk dalam API palet warna dinamis?

• Ada lima palet warna:

  • system_accent1
  • system_accent2
  • system_accent3
  • system_neutral1
  • system_neutral2

• Setiap palet tonal memiliki 13 nilai warna yang diakhiri dengan indeks 0, 10, 50, 100, 200, 300, 400, 500, 600, 700, 800, 900, dan 1000.

• API yang dihasilkan adalah kombinasi nama palet warna, yang diakhiri dengan indeks. Misalnya: R.color#system_accent1_10

Bagaimana palet warna dinamis dihasilkan?

Palet warna dinamis harus dihasilkan dari satu warna sumber yang berasal dari wallpaper menggunakan com.android.systemui.monet.ColorScheme#getSeedColors , yang menyediakan beberapa warna sumber yang valid. Jika tidak ada warna yang disediakan memenuhi persyaratan warna sumber, warna sumber tunggal harus menggunakan nilai 0xFF1B6EF3 .