لا يتوافق نظام تشغيل Android TV مع الرموز المستوحاة من موضوع معيّن.
نظرة عامة
يستفيد كل من Google TV ونظام التشغيل Android من الرموز المتوفرة من خلال
AndroidManifest.xml بثلاث طرق:
رمز مشغّل التطبيقات (نسبة العرض إلى الارتفاع 1×1)
رمز مشغّل تطبيقات دائري (نسبة عرض إلى ارتفاع 1×1، ولكن دائرية)
شعار البانر (نسبة عرض إلى ارتفاع 16×9)
ويتم استخدامها في أماكن مختلفة لحالات الاستخدام المختلفة، مثل صف تطبيقاتك أو الإعدادات أو مستوى تقدُّم التثبيت.
إعلان بانر
شعار البانر هو شعار بنسبة عرض إلى ارتفاع تبلغ 16x9 ويُستخدم في نظام التشغيل Android TV لعرض مشغّل التطبيقات. ننصحك بأن توفّر تطبيقات التلفزيون إعلان بانر
تكيُّفيًا بنسبة عرض إلى ارتفاع 16:9 يتضمّن المواصفات التالية: ويمكنك أيضًا توفير موارد xhdpi بحجم 320 x 180px عند استخدام المستوى 25 من واجهة برمجة التطبيقات أو أقل.
الكثافة
الحد الأدنى للحجم
موقع المجلد (أقل من الدقة)
نسبة البكسل
mdpi
160 × 90 بكسل
mipmap-mdpi
1
دقة عالية
240 × 135 بكسل
mipmap-hdpi
1.5
xhdpi
320 × 180 بكسل
mipmap-xhdpi
2
xxhdpi
480 × 270 بكسل
mipmap-xxhdpi
3
xxxhdpi
640 × 360 بكسل
mipmap-xxxhdpi
4
رمز مشغّل التطبيقات
رمز مشغّل التطبيقات هو مورد بنسبة عرض إلى ارتفاع تبلغ 1x1 ويتم استخدامه في أماكن متعددة مثل الإعدادات وتكامل جلسات الوسائط (بطاقة اللعب الآن)
على Android TV. يمكن أيضًا استخدام رمز مشغّل التطبيقات في صف تطبيقاتك
على Google TV.
الكثافة
الحد الأدنى للحجم
موقع المجلد (أقل من الدقة)
نسبة البكسل
mdpi
80 × 80 بكسل
mipmap-mdpi
1
دقة عالية
120 × 120 بكسل
mipmap-hdpi
1.5
xhdpi
160 × 160 بكسل
mipmap-xhdpi
2
xxhdpi
240 × 240 بكسل
mipmap-xxhdpi
3
xxxhdpi
320 × 320 بكسل
mipmap-xxxhdpi
4
الرموز التكيُّفية
اعتبارًا من إصدار Android 8.0 (المستوى 26 من واجهة برمجة التطبيقات)، سنتيح استخدام رموز مشغّلات التطبيقات التكيُّفية، ما يتيح المزيد من المرونة والتأثيرات المرئية الشيقة في ما يتعلّق برموز التطبيقات. بالنسبة للمطورين، هذا يعني أن رمز التطبيق
يتكون من طبقتين: مقدمة وطبقة خلفية.
إعلان بانر تكيُّفي
يمكنك أيضًا توفير بانر تكيُّفي مع إعلانات بانر قديمة،
تشبه إعلانات بانر رموز مشغّل التطبيقات التي تتضمّن أيضًا طبقتين.
رمز مشغّل التطبيقات التكيُّفي
للتأكد من أن الأيقونة التكيُّفية تدعم الأشكال المختلفة، ويجب أن تستوفي التأثيرات
المرئية المتطلبات التالية:
قدم طبقتين لإصدار اللون من الرمز:
واحدة للمقدمة وواحدة للخلفية.
يتم تحديد الرموز التكيُّفية باستخدام طبقات المقدّمة والخلفية. تُظهر المنطقة الآمنة 72 × 72
في الصورة الأولى المكان الذي لا يتم فيه اقتطاع الأيقونة والطبقات الأمامية مطلقًا
من خلال قناع على شكل.
لا يلزم استخدام إصدار أحادي اللون من الرمز لأنّ Android TV
لا يتوافق مع الرموز المستوحاة من موضوع معيّن.
أمثلة
فيما يلي بعض الأمور التي يجب فعلها وما لا يجب مراعاتها عند تصميم أيقونة تطبيق تلفزيون.
أمثلة على البانر
check_circle
الإجراءات التي يُنصح بها
اتّبِع الإرشادات، مع إبقاء الشعار في منطقة آمنة.
cancel
الإجراءات غير المُوصى بها
تجنب استخدام عناصر نصية أو رسومية للإشارة إلى أي معلومات إضافية.
cancel
الإجراءات غير المُوصى بها
لا يُسمح باستخدام عناصر نصية أو رسومية يمكن أن تضلّل المستخدمين.
cancel
الإجراءات غير المُوصى بها
لا تسكب الشعار من المنطقة الآمنة.
cancel
الإجراءات غير المُوصى بها
تجنَّب إضافة أي حدود حول الشعار أثناء اقتصاصه وإنشاء عناصر مرئية غير مصقولة.
cancel
الإجراءات غير المُوصى بها
تجنُّب اقتصاص الشعار
warning
تنبيه
عند استخدام بانر، ننصحك بعرض الشعار الكامل والرمز والنص.
أمثلة على مشغّلات التطبيقات
check_circle
الإجراءات التي يُنصح بها
اتّبِع الإرشادات، مع إبقاء الشعار في منطقة آمنة.
cancel
الإجراءات غير المُوصى بها
لا تستخدِم عناصر نصية أو رسومية للإشارة إلى أيّ معلومات إضافية.
cancel
الإجراءات غير المُوصى بها
لا يُسمح باستخدام عناصر نصية أو رسومية يمكن أن تضلّل المستخدمين.
cancel
الإجراءات غير المُوصى بها
لا تسكب الشعار من المنطقة الآمنة.
cancel
الإجراءات غير المُوصى بها
تجنَّب إضافة أي حدود حول الشعار أثناء اقتصاصه وإنشاء عناصر مرئية غير مصقولة.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],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)"]]
