سیستم عامل Android TV از نمادهای موضوعی پشتیبانی نمی کند.
نمای کلی
Google TV و سیستم عامل Android به سه روش از نمادنگاری ارائه شده از طریق AndroidManifest.xml شما استفاده می کنند:
نماد راه‌انداز (نسبت تصویر 1x1)
نماد راه‌انداز گرد (نسبت تصویر 1x1، اما دایره‌ای)
لوگوی بنر (نسبت تصویر 16x9)
این موارد در مکان‌های مختلف برای موارد استفاده مختلف مانند ردیف برنامه‌های شما ، تنظیمات یا پیشرفت نصب استفاده می‌شوند.
بنر
لوگوی بنر یک آرم با نسبت ابعاد 16×9 است که در سیستم عامل Android TV برای نمایش راه‌انداز برنامه شما استفاده می‌شود. توصیه می کنیم برنامه های تلویزیونی یک بنر تطبیقی 16:9 با مشخصات زیر ارائه دهند. همچنین می توانید منابع xhdpi را با اندازه 320 x 180px هنگام استفاده از API سطح 25 یا پایین تر ارائه دهید.
تراکم
حداقل اندازه
مکان پوشه (تحت پاسخ)
نسبت پیکسل
mdpi
160x90 پیکسل
mipmap-mdpi
1
hdpi
240x135 پیکسل
mipmap-hdpi
1.5
xhdpi
320x180 پیکسل
mipmap-xhdpi
2
xxhdpi
480x270 پیکسل
mipmap-xxhdpi
3
xxxhdpi
640x360 پیکسل
mipmap-xxxhdpi
4
نماد راه‌انداز
نماد راه‌انداز یک منبع نسبت ابعاد 1×1 است که در مکان‌های متعددی مانند تنظیمات و ادغام‌های جلسه رسانه (در حال حاضر کارت بازی) در Android TV استفاده می‌شود. نماد راه‌انداز همچنین می‌تواند در ردیف برنامه‌های شما در Google TV استفاده شود.
تراکم
حداقل اندازه
مکان پوشه (تحت پاسخ)
نسبت پیکسل
mdpi
80x80 پیکسل
mipmap-mdpi
1
hdpi
120x120 پیکسل
mipmap-hdpi
1.5
xhdpi
160x160 پیکسل
mipmap-xhdpi
2
xxhdpi
240x240 پیکسل
mipmap-xxhdpi
3
xxxhdpi
320x320 پیکسل
mipmap-xxxhdpi
4
نمادهای تطبیقی
از زمان انتشار اندروید 8.0 (سطح API 26)، از آیکون‌های راه‌انداز تطبیقی پشتیبانی می‌شود، که باعث می‌شود انعطاف‌پذیری بیشتر و جلوه‌های بصری جالبی در مورد نمادهای برنامه‌ها به میان آید. برای توسعه دهندگان، این بدان معناست که نماد برنامه شما از دو لایه تشکیل شده است: یک لایه پیش زمینه و یک لایه پس زمینه.
بنر تطبیقی
همچنین می‌توانید یک بنر تطبیقی به همراه بنرهای قدیمی، مشابه بنرهای نماد راه‌انداز که دارای دو لایه هستند نیز تهیه کنید.
نماد راه‌انداز تطبیقی
برای اطمینان از اینکه نماد تطبیقی شما از اشکال مختلف و جلوه‌های بصری پشتیبانی می‌کند، طرح باید شرایط زیر را برآورده کند:
دو لایه برای نسخه رنگی نماد ارائه دهید: یکی برای پیش زمینه و دیگری برای پس زمینه.
آیکون های تطبیقی با استفاده از لایه های پیش زمینه و پس زمینه تعریف می شوند. منطقه امن ۷۲×۷۲ در تصویر اول نشان می‌دهد که آیکون و لایه‌های پیش‌زمینه شما هرگز با یک ماسک بریده نمی‌شوند.
نسخه تک رنگ نماد مورد نیاز نیست زیرا Android TV از نمادهای مضمون پشتیبانی نمی کند.
نمونه ها
در زیر بایدها و نبایدهایی را که باید هنگام طراحی نماد برنامه تلویزیون در نظر بگیرید آورده شده است.
نمونه بنرها
check_circle
انجام دهید
دستورالعمل ها را دنبال کنید، آرم را در منطقه امن نگه دارید
cancel
نکن
از استفاده از عناصر متنی یا گرافیکی برای نشان دادن هرگونه اطلاعات اضافی خودداری کنید.
cancel
نکن
از متن یا عناصر گرافیکی که می تواند کاربران را گمراه کند استفاده نکنید
cancel
نکن
لوگو را از ناحیه امن بیرون نریزید
cancel
نکن
از افزودن هر گونه حاشیه در اطراف لوگو اجتناب کنید زیرا آنها برش داده می شوند و جلوه های بصری صیقلی ایجاد می کنند.
cancel
نکن
از برش دادن لوگو خودداری کنید
warning
احتیاط
هنگام استفاده از یک بنر، توصیه می شود لوگو، نماد + متن کامل خود را نشان دهید.
نمونه های لانچر
check_circle
انجام دهید
دستورالعمل ها را دنبال کنید، آرم را در منطقه امن نگه دارید
cancel
نکن
از متن یا عناصر گرافیکی برای نشان دادن اطلاعات اضافی استفاده نکنید.
cancel
نکن
از متن یا عناصر گرافیکی که می تواند کاربران را گمراه کند استفاده نکنید
cancel
نکن
لوگو را از ناحیه امن بیرون نریزید
cancel
نکن
از افزودن هر گونه حاشیه در اطراف لوگو اجتناب کنید زیرا آنها برش داده می شوند و جلوه های بصری صیقلی ایجاد می کنند.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# TV app icon design guidelines\n\nThis guide describes creating banners and launcher icons for Android TV.\n\nKey takeaways\n-------------\n\nThe following are the key takeaways from this page:\n\n- There are two icon types for Android TV OS apps in AndroidManifest.xml:\n - `android:icon` (standard, mandatory)\n - `android:banner` (banner, mandatory)\n- Adaptive icons are highly recommended.\n- Both the icon and banner must comply with the design guidelines outlined in this guide.\n- Use the [official figma template](https://www.figma.com/community/file/1283953738855070149) for generating the banner \\& icons\n- Android TV OS doesn't support themed icons.\n\n| **Note:** `android:roundIcon` is deprecated and shouldn't be used in favor of adaptive icons.\n\nOverview\n--------\n\nGoogle TV and Android OS make use of iconography provided through your\n`AndroidManifest.xml` in three ways:\n\n- Launcher icon (1x1 aspect ratio)\n- Round launcher icon (1x1 aspect ratio, but circular)\n- Banner logo (16x9 aspect ratio)\n\nThese are used in different places for different use cases, such as the\n**Your apps** row, Settings, or installation progress.\n\nBanner\n------\n\nThe Banner logo is a 16x9 aspect ratio logo that is used in Android TV OS to\nshow your app launcher. We recommend that TV apps provide an adaptive\n16:9 banner with the following specifications. You can also provide\nxhdpi resources with size of `320 x 180px` when using API level 25 or lower. \n\n| Density | Min Size | Folder location (under res) | Pixel Ratio |\n|---------|------------|-----------------------------|-------------|\n| mdpi | 160x90 px | mipmap-mdpi | 1 |\n| hdpi | 240x135 px | mipmap-hdpi | 1.5 |\n| xhdpi | 320x180 px | mipmap-xhdpi | 2 |\n| xxhdpi | 480x270 px | mipmap-xxhdpi | 3 |\n| xxxhdpi | 640x360 px | mipmap-xxxhdpi | 4 |\n\n| **Note:** Text must be included in the image. If your app is available in more than one language, you must provide separate versions of the banner with text for each supported language.\n\nLauncher icon\n-------------\n\nThe Launcher icon is a 1x1 aspect ratio resource that is used in multiple\nplaces such as Settings and Media session integrations (Now playing card)\non Android TV. The launcher icon can also be used in **Your apps** row\non Google TV. \n\n| Density | Min Size | Folder location (under res) | Pixel Ratio |\n|---------|------------|-----------------------------|-------------|\n| mdpi | 80x80 px | mipmap-mdpi | 1 |\n| hdpi | 120x120 px | mipmap-hdpi | 1.5 |\n| xhdpi | 160x160 px | mipmap-xhdpi | 2 |\n| xxhdpi | 240x240 px | mipmap-xxhdpi | 3 |\n| xxxhdpi | 320x320 px | mipmap-xxxhdpi | 4 |\n\nAdaptive icons\n--------------\n\nAs of the Android 8.0 release (API level 26), there is support for\nadaptive launcher icons, which allows for more flexibility and interesting\nvisual effects when it comes to app icons. For developers, that means that\nyour app icon is made up of two layers: a foreground and a background layer.\n\n### Adaptive banner\n\nYou can also provide an adaptive banner along with a legacy banners,\nsimilar to launcher icon banners that also have two layers. \n\n### Adaptive launcher icon\n\nTo ensure that your adaptive icon supports different shapes, and visual\neffects the design must meet the following requirements:\n\nProvide two layers for the color version of the icon:\none for the foreground, and one for the background. \n\nAdaptive icons are defined using foreground and background layers. The 72 x 72\nsafe zone in the first image shows where your icon and foreground layers are\nnever be clipped by a shaped mask.\n\nA monochrome version of the icon is not required as Android TV\ndoes not support themed icons.\n| **Note:** Android or Google TV don't support themed icons.\n\nExamples\n--------\n\nBelow are some do's and don'ts to consider when designing a TV app icon.\n\n### Banner examples\n\ncheck_circle\n\n### Do\n\nFollow the guidelines, keep the logo in safe area \ncancel\n\n### Don't\n\nAvoid using text or graphic elements to indicate any additional information. \ncancel\n\n### Don't\n\nDon't use text or graphic elements that can mislead users \ncancel\n\n### Don't\n\nDo not spill the logo out of safe area \ncancel\n\n### Don't\n\nAvoid adding any border around the logo as they get cropped and create unpolished visuals. \ncancel\n\n### Don't\n\nAvoid cropping the logo \nwarning\n\n### Caution\n\nWhen using a banner its recommend you show your full logo, icon + text.\n\n### Launcher examples\n\ncheck_circle\n\n### Do\n\nFollow the guidelines, keep the logo in safe area \ncancel\n\n### Don't\n\nDon't use text or graphic elements to indicate any additional information. \ncancel\n\n### Don't\n\nDon't use text or graphic elements that can mislead users \ncancel\n\n### Don't\n\nDo not spill the logo out of safe area \ncancel\n\n### Don't\n\nAvoid adding any border around the logo as they get cropped and create unpolished visuals. \ncancel\n\n### Don't\n\nAvoid cropping the logo\n\nResources\n---------\n\n- [Official figma template](https://www.figma.com/community/file/1283953738855070149) for banner \\& icons\n\nRelated reading\n---------------\n\n- [Adaptive icons mobile](/develop/ui/views/launch/icon_design_adaptive)\n- [Using the adaptive icons](/codelabs/basic-android-kotlin-compose-training-change-app-icon#2)\n- [Designing adaptive icons](https://codelabs.developers.google.com/design-android-launcher#0)"]]
