Cores dinâmicas

O design do Material You foi lançado com o Android 12 e expandido com o Android 13.

Esta página se concentra nas atualizações da lógica do Material You para ajudar você a integrar com suporte a cores dinâmicas mais avançado.

Paletas tonais de cores dinâmicas

A partir do Android 12, as seguintes paletas tonais de cores dinâmicas são compatíveis:

• system_accent1_0
• system_accent2_0
• system_accent3_0
• system_neutral1_0
• system_neutral2_0)

Cada um deles consiste em um conjunto de 13 cores com vários valores de luminância definidos, conforme descrito em R.color, mas com valores de matiz e croma indefinidos que podem ser gerados dinamicamente pelo sistema Android durante a execução.

Estilos de tema para cores dinâmicas

No Android 13 e em versões mais recentes, há suporte para seis estilos de tema diferentes com variações no algoritmo de cores dinâmicas que atendem às necessidades dos desenvolvedores e às expectativas de contraste. Eles são listados para gerar as 65 cores dinâmicas usadas pelos apps:

• TONAL_SPOT é uma paleta de vibração média que usa uma cor system_accent3_0 análoga à cor system_accent1_0 (transferida da versão do Android 12 e ligeiramente ajustada).
• VIBRANT é uma paleta de alta vibração que combina de forma harmoniosa uma mudança sutil entre as cores.
• EXPRESSIVE é uma paleta de alta vibração que combina cores de destaque inesperadas e exclusivas.
• SPRITZ é uma paleta de baixa vibração que cria uma lavagem suave entre as cores.
• O RAINBOW usa tons cromáticos e superfícies neutras para criar uma experiência de cores mais sutil para os usuários.
  • NÃO É RECOMENDADO usar esse recurso com extração de cores baseada em plano de fundo. Em vez disso, use com temas de cores estáticas.
• O FRUIT_SALAD oferece cores em dois tons para dar mais expressão aos usuários.
  • NÃO É RECOMENDADO usar esse recurso com extração de cores baseada em plano de fundo. Em vez disso, use com temas de cores estáticas.

O tema do sistema é controlado pela mesma configuração do Android 12, que é Settings.Secure.THEME_CUSTOMIZATION_OVERLAY_PACKAGES. Para o Android 13, é necessária apenas uma chave no JSON que envia a cor de origem para gerar as 65 paletas de cores:

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

O estilo de tema padrão é TONAL_SPOT, mas você pode especificar um dos outros estilos de tema com uma chave adicional no JSON acima:

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

Como integrar cores dinâmicas

Para diretrizes sobre como integrar cores dinâmicas, consulte Como integrar o design do Material You.

Perguntas frequentes

O que a API de paleta tonal dinâmica inclui?

• Há cinco paletas tonais:

  • system_accent1
  • system_accent2
  • system_accent3
  • system_neutral1
  • system_neutral2

• Cada paleta tonal tem 13 valores de cores que terminam nos índices 0, 10, 50, 100, 200, 300, 400, 500, 600, 700, 800, 900 e 1000.

• A API resultante é uma combinação do nome da paleta tonal, terminando no índice. Por exemplo: R.color#system_accent1_10

Como uma paleta tonal dinâmica é gerada?

Uma paleta tonal dinâmica precisa ser gerada com base em uma única cor de origem, que deve ser derivada do papel de parede usando com.android.systemui.monet.ColorScheme#getSeedColors, que fornece várias cores de origem válidas. Se nenhuma das cores fornecidas atender ao requisito de cor de origem, a única cor de origem vai usar o valor 0xFF1B6EF3.