本指南介绍了如何为 Android TV 创建横幅（Banner）和启动器图标。
关键要点
以下是本页面的关键要点
- AndroidManifest.xml 中有两种 Android TV OS 应用图标类型
android:icon（标准，必填）android:banner（横幅，必填）
- 强烈建议使用自适应图标。
- 图标和横幅必须符合本指南中概述的设计原则。
- 请使用官方 Figma 模板来生成横幅和图标
- Android TV OS 不支持主题图标。
概览
Google TV 和 Android OS 通过 AndroidManifest.xml 提供的图标主要有以下三种用途
- 启动器图标（1x1 长宽比）
- 圆形启动器图标（1x1 长宽比，但为圆形）
- 横幅图标（16x9 长宽比）
这些图标用于不同的场景，例如“您的应用”行、设置或安装进度界面。
横幅（Banner）
横幅图标是 16x9 长宽比的标识，在 Android TV OS 中用于展示您的应用启动项。我们建议 TV 应用提供自适应 16:9 横幅，并符合以下规格。在使用 API 25 或更低级别时，您也可以提供大小为 320 x 180px 的 xhdpi 资源。
| 密度 | 最小尺寸 | 文件夹位置（位于 res 下） | 像素密度 |
|---|---|---|---|
| mdpi | 160x90 px | mipmap-mdpi | 1 |
| hdpi | 240x135 px | mipmap-hdpi | 1.5 |
| xhdpi | 320x180 px | mipmap-xhdpi | 2 |
| xxhdpi | 480x270 px | mipmap-xxhdpi | 3 |
| xxxhdpi | 640x360 px | mipmap-xxxhdpi | 4 |
启动器图标
启动器图标是 1x1 长宽比的资源，用于 Android TV 上的多个位置，如“设置”和媒体会话集成（正在播放卡片）。启动器图标也可以在 Google TV 的“您的应用”行中使用。
| 密度 | 最小尺寸 | 文件夹位置（位于 res 下） | 像素密度 |
|---|---|---|---|
| mdpi | 80x80 px | mipmap-mdpi | 1 |
| hdpi | 120x120 px | mipmap-hdpi | 1.5 |
| xhdpi | 160x160 px | mipmap-xhdpi | 2 |
| xxhdpi | 240x240 px | mipmap-xxhdpi | 3 |
| xxxhdpi | 320x320 px | mipmap-xxxhdpi | 4 |
自适应图标
从 Android 8.0（API 级别 26）发布起，系统开始支持自适应启动器图标，这使得应用图标在视觉效果上更具灵活性和趣味性。对于开发者而言，这意味着您的应用图标由两个图层组成：前景层和背景层。
自适应横幅
您可以像提供带有两层的启动器图标一样，在提供传统横幅的同时提供自适应横幅。
自适应启动器图标
为确保自适应图标支持不同的形状和视觉效果，设计必须满足以下要求：
为图标的彩色版本提供两个图层：一个用于前景，一个用于背景。
自适应图标通过前景和背景图层定义。第一张图中的 72 x 72 安全区显示了您的图标和前景层绝对不会被形状遮罩裁切的区域。
无需提供单色版本的图标，因为 Android TV 不支持主题图标。
示例
以下是设计 TV 应用图标时应遵循的一些建议（Do's）和注意事项（Don'ts）。
横幅示例
要
遵循指南，将标识保持在安全区域内
不要
避免使用文本或图形元素来指示任何额外信息。
不要
不要使用可能误导用户的文本或图形元素
不要
请勿让标识超出安全区域
不要
避免在标识周围添加任何边框，因为它们会被裁切并造成视觉上的粗糙感。
不要
避免裁切标识
注意
使用横幅时，建议显示完整的标识（图标 + 文本）。
启动器示例
要
遵循指南，将标识保持在安全区域内
不要
不要使用文本或图形元素来指示任何额外信息。
不要
不要使用可能误导用户的文本或图形元素
不要
请勿让标识超出安全区域
不要
避免在标识周围添加任何边框，因为它们会被裁切并造成视觉上的粗糙感。
不要
避免裁切标识
资源
- 官方 Figma 模板（用于横幅和图标）