각각은 R.color에 설명된 것처럼 다양한 휘도 값이 정의되어 있지만 런타임에 Android 시스템에서 동적으로 생성될 수 있는 색조 및 크로마 값은 정의되어 있지 않은 13가지 색상 세트로 구성됩니다.
동적 색상 테마 스타일
Android 13부터 개발자 요구사항과 대비 기대치를 유지하는 동적 색상 알고리즘의 변형으로 6가지 다양한 테마 스타일이 지원됩니다. 앱에서 사용하는 65가지 동적 색상을 생성하기 위해 다음과 같이 나열되어 있습니다.
TONAL_SPOT은 system_accent1_0 색상과 유사한 system_accent3_0 색상을 사용하는 중간 생동감의 팔레트입니다(Android 12 출시에서 이전되어 약간 조정됨).
VIBRANT는 색상 간의 미세한 변화를 조화롭게 혼합하는 높은 생동감의 팔레트입니다.
EXPRESSIVE는 예기치 않은 색상과 고유한 강조 색상을 함께 결합하는 높은 생동감의 팔레트입니다.
SPRITZ는 색상 간에 소프트 워시를 생성하는 낮은 생동감의 팔레트입니다.
RAINBOW는 색채 강조와 중립적인 노출 영역을 모두 사용하여 사용자에게 좀 더 섬세한 색상 환경을 제공합니다.
이는 배경 색상에 맞출 때는 사용하지 않는 것이 좋으며 대신 정적 색상 테마와 함께 사용해야 합니다.
FRUIT_SALAD는 사용자가 더 풍부하게 표현할 수 있도록 투톤 색상을 제공합니다.
이는 배경 색상에 맞출 때는 사용하지 않는 것이 좋으며 대신 정적 색상 테마와 함께 사용해야 합니다.
시스템 테마는 Android 12와 동일한 설정(Settings.Secure.THEME_CUSTOMIZATION_OVERLAY_PACKAGES)에 기반합니다. Android 13의 경우 소스 색상을 전송하여 65가지 색상 팔레트를 생성하는 JSON에 키가 하나만 필요합니다.
동적 색조 팔레트는 여러 개의 유효한 소스 색상을 제공하는 com.android.systemui.monet.ColorScheme#getSeedColors를 사용하여 배경화면에서 파생되어야 하는 단일 소스 색상에서 생성되어야 합니다. 제공된 색상이 소스 색상 요구사항을 충족하지 않으면 단일 소스 색상은 0xFF1B6EF3 값을 사용해야 합니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-08-24(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-24(UTC)"],[],[],null,["# Dynamic color\n\nMaterial You design was launched with the Android 12\nrelease and expanded with Android 13.\n\nThis page focuses on updates to the Material You logic to help you integrate\nwith richer dynamic color support.\n\nDynamic color tonal palettes\n----------------------------\n\nStarting with Android 12, the following dynamic color\ntonal palettes are supported:\n\n- [`system_accent1_0`](https://developer.android.com/reference/android/R.color#system_accent1_0)\n- [`system_accent2_0`](https://developer.android.com/reference/android/R.color#system_accent2_0)\n- [`system_accent3_0`](https://developer.android.com/reference/android/R.color#system_accent3_0)\n- [`system_neutral1_0`](https://developer.android.com/reference/android/R.color#system_neutral1_0)\n- [`system_neutral2_0`](https://developer.android.com/reference/android/R.color#system_neutral2_0))\n\nEach of them comprise of a set of 13 colors with defined various luminance\nvalues as described at\n[`R.color`](https://developer.android.com/reference/android/R.color),\nbut with undefined hue and chroma values that can be dynamically generated by\nthe Android system at runtime.\n\nTheme styles for dynamic color\n------------------------------\n\nStarting with Android 13, six different theme styles\nare supported with variations on the dynamic color algorithm that maintain\ndeveloper needs and contrast expectations. These are listed for generating the\n65 dynamic color used by apps:\n\n- `TONAL_SPOT` is a mid-vibrancy palette that uses an `system_accent3_0` color analogous to the `system_accent1_0` color (carried over from the Android 12 release and slightly adjusted).\n- `VIBRANT` is a high-vibrancy palette that harmoniously blends subtle shift between colors.\n- `EXPRESSIVE` is a high-vibrancy palette that pairs unexpected and unique accents colors together.\n- `SPRITZ` is a low-vibrancy palette that creates a soft wash between colors.\n- `RAINBOW` uses both chromatic accents and neutral surfaces to create a more subtle color experience for users.\n - This is **NOT RECOMMENDED** to be used with wallpaper-based color extraction and should instead be used with static color themes.\n- `FRUIT_SALAD` provides *two tone colors* to give users more expression.\n - This is **NOT RECOMMENDED** to be used with wallpaper-based color extraction and should instead be used with static color themes.\n\nThe system theme is driven by the same setting as it was in Android 12,\nwhich is `Settings.Secure.THEME_CUSTOMIZATION_OVERLAY_PACKAGES`. For Android\n13, it requires only one key on its JSON that sends the\nsource color to generate the 65 color palettes: \n\n {\n \"android.theme.customization.system_palette\":\"746BC1\"\n }\n\nThe default theme style is `TONAL_SPOT`, but you can optionally specify one of\nthe other theme styles with an additional key with the JSON above: \n\n {\n \"android.theme.customization.system_palette\":\"746BC1\"\n \"android.theme.customization.theme_style\":\"EXPRESSIVE\"\n }\n\n| **Note:** You aren't required to expose ALL of the new theme styles in your UI, and can decide which to expose based on your user/brand needs. However, dynamic color palettes **MUST** be generated through one of these theme styles as CTS-tested by `SystemPaletteTest#testThemeStyles` and mandated by CDD.\n\nIntegrating dynamic color\n-------------------------\n\nFor guidelines on integrating dynamic color, see [Integrating Material You\nDesign](/docs/core/display/material).\n\nFrequently asked questions (FAQs)\n---------------------------------\n\n### What does the dynamic tonal palette API include?\n\n- There are five tonal palettes:\n\n - [`system_accent1`](https://developer.android.com/reference/android/R.color#system_accent1_0)\n - [`system_accent2`](https://developer.android.com/reference/android/R.color#system_accent2_0)\n - [`system_accent3`](https://developer.android.com/reference/android/R.color#system_accent3_0)\n - [`system_neutral1`](https://developer.android.com/reference/android/R.color#system_neutral1_0)\n - [`system_neutral2`](https://developer.android.com/reference/android/R.color#system_neutral2_0)\n- Each tonal palette has 13 color values ending in the indexes 0, 10, 50, 100,\n 200, 300, 400, 500, 600, 700, 800, 900, and 1000.\n\n- The resulting API is a combination of the tonal palette name, ending in the\n index. For example:\n [`R.color#system_accent1_10`](https://developer.android.com/reference/android/R.color#system_accent1_10)\n\n### How is a dynamic tonal pallet generated?\n\nA dynamic tonal palette must be generated from a single source color that should\nbe derived from wallpaper using\n`com.android.systemui.monet.ColorScheme#getSeedColors`, which provides multiple\nvalid source colors. If none of the provided colors meet the source color\nrequirement, the single source color should use the value `0xFF1B6EF3`."]]