Динамический цвет

Дизайн Material You был запущен с выпуском Android 12 и расширен с выпуском Android 13.

На этой странице основное внимание уделяется обновлениям логики Material You, которые помогут вам интегрировать более богатую динамическую цветовую поддержку.

Динамичные цветовые тональные палитры

Начиная с Android 12 поддерживаются следующие динамические цветовые тональные палитры:

Каждый из них состоит из набора из 13 цветов с определенными различными значениями яркости, как описано в R.color , но с неопределенными значениями оттенка и цветности, которые могут динамически генерироваться системой Android во время выполнения.

Тематические стили для динамического цвета

Начиная с Android 13, поддерживаются шесть различных стилей тем с вариациями алгоритма динамического цвета, которые поддерживают потребности разработчиков и ожидания контраста. Они перечислены для генерации 65 динамических цветов, используемых приложениями:

  • TONAL_SPOT — это палитра средней яркости, в которой используется цвет system_accent3_0 , аналогичный цвету system_accent1_0 (перенесен из версии Android 12 и слегка скорректирован).
  • VIBRANT — это яркая палитра, гармонично сочетающая тонкие переходы между цветами.
  • EXPRESSIVE — это яркая палитра, сочетающая в себе неожиданные и уникальные акцентные цвета.
  • SPRITZ — это палитра с низкой интенсивностью, создающая мягкие переходы между цветами.
  • RAINBOW использует как хроматические акценты, так и нейтральные поверхности, чтобы создать для пользователей более утонченное цветовое восприятие.
    • НЕ РЕКОМЕНДУЕТСЯ использовать этот метод с извлечением цвета на основе обоев. Вместо этого его следует использовать со статическими цветовыми темами.
  • FRUIT_SALAD предлагает двухцветную цветовую гамму , чтобы дать пользователям больше самовыражения.
    • НЕ РЕКОМЕНДУЕТСЯ использовать этот метод с извлечением цвета на основе обоев. Вместо этого его следует использовать со статическими цветовыми темами.

Системная тема управляется той же настройкой, что и в Android 12, а именно Settings.Secure.THEME_CUSTOMIZATION_OVERLAY_PACKAGES . Для Android 13 требуется только один ключ в его JSON, который отправляет исходный цвет для генерации 65 цветовых палитр:

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

Стиль темы по умолчанию — TONAL_SPOT , но при желании можно указать один из других стилей темы с помощью дополнительного ключа в JSON выше:

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

Интеграция динамического цвета

Инструкции по интеграции динамического цвета см. в разделе Интеграция материалов, которые вы разрабатываете .

Часто задаваемые вопросы (FAQ)

Что включает в себя API динамической тональной палитры?

  • Существует пять тональных палитр:

  • Каждая тональная палитра имеет 13 цветовых значений, заканчивающихся индексами 0, 10, 50, 100, 200, 300, 400, 500, 600, 700, 800, 900 и 1000.

  • Результирующий API представляет собой комбинацию имени тональной палитры, заканчивающуюся индексом. Например: R.color#system_accent1_10

Как формируется динамическая тональная палитра?

Динамическая тональная палитра должна быть сгенерирована из одного исходного цвета, который должен быть получен из обоев с помощью com.android.systemui.monet.ColorScheme#getSeedColors , который предоставляет несколько допустимых исходных цветов. Если ни один из предоставленных цветов не соответствует требованиям исходного цвета, единственный исходный цвет должен использовать значение 0xFF1B6EF3 .