<intent-filter>

البنية:
<intent-filter android:icon="drawable resource"
               android:label="string resource"
               android:priority="integer" >
    ...
</intent-filter>
المحتوى المضمّن في:
<activity>
<activity-alias>
<service>
<receiver>
<provider>
يجب أن تتضمّن:
<action>
يمكن أن تحتوي على ما يلي:
<category>
<data>
<uri-relative-filter-group>
description:
تُحدِّد أنواع النوايا التي يمكن لمستقبل البث أو النشاط أو الخدمة الردّ عليها. يعلن فلتر الأهداف عن إمكانات المكوّن الرئيسي: ما يمكن أن يفعله النشاط أو الخدمة وأنواع البث التي يمكن لجهاز الاستقبال معالجتها.

ويفتح المكوّن لتلقّي النوايا من النوع المعلَن عنه مع فلترة تلك التي ليست مفيدة للمكوّن. يتم وصف معظم محتوى الفلتر من خلال عناصره الفرعية:

لمناقشة أكثر تفصيلاً عن الفلاتر، يُرجى الاطّلاع على Intents وIntent Filters وIntent filters في قسم النظرة العامة على بيان التطبيق.

السمات:
android:icon
رمز يمثّل النشاط الرئيسي أو الخدمة أو جهاز استقبال البث عندما يتم عرض هذا المكوّن للمستخدم على أنّه يمتلك القدرة الموضّحة في الفلتر

يتم ضبط هذه السمة كمرجع لمورد قابل للرسم يحتوي على تعريف الصورة. القيمة التلقائية هي الرمز الذي تم ضبطه بواسطة سمة icon للمكوّن الرئيسي. إذا لم يحدّد العنصر родительский رمزًا، يكون الرمز التلقائي هو الرمز الذي يحدّده العنصر <application>.

لمزيد من المعلومات عن رموز فلاتر الأهداف، اطّلِع على القسم الرموز والعلامات في النظرة العامة على بيان التطبيق.

android:label
تصنيف يسهل على المستخدم قراءته للمكوّن الرئيسي ويُستخدَم هذا التصنيف، بدلاً من التصنيف الذي يضبطه المكوّن الرئيسي، عند عرض المكوّن للمستخدم على أنّه يمتلك الإمكانية الموضّحة في الفلتر.

يتم ضبط التصنيف كإشارة إلى مورد سلسلة حتى تتمكّن من ترجمة السلسلة مثل سلاسل النصوص الأخرى في واجهة المستخدم. ومع ذلك، لتسهيل عملية تطوير التطبيق، يمكن أيضًا ضبطه كسلسلة غير مفسَّرة.

القيمة التلقائية هي التصنيف الذي يضبطه المكوّن الرئيسي. إذا لم يحدِّد العنصر الرئيسي تصنيفًا، يكون التصنيف التلقائي هو التصنيف الذي تم ضبطه من خلال سمة label لعنصر <application>.

لمزيد من المعلومات عن تصنيفات فلاتر الأهداف، اطّلِع على القسم الرموز والتصنيفات في النظرة العامة على بيان التطبيق.

android:priority
الأولوية الممنوحة للمكوِّن الرئيسي في ما يتعلّق بمعالجة النوايا من النوع الموضّح في الفلتر لهذه السمة معنى لكل من الأنشطة وأجهزة استقبال البث.
  • تقدّم هذه السمة معلومات عن مدى قدرة نشاط معيّن على الاستجابة لطلب يتطابق مع الفلتر، مقارنةً بالأنشطة الأخرى التي يمكنها أيضًا الاستجابة للطلب. عندما يمكن تنفيذ نية من خلال عدة أنشطة ذات أولويات مختلفة، لا يأخذ Android في الاعتبار سوى الأنشطة التي تتضمن قيم أولوية أعلى كأهداف محتملة للنية.
  • وتتحكّم هذه القيمة في ترتيب تنفيذ أجهزة استقبال البث لتلقّي رسائل البث، مع استدعاء تلك التي تحتوي على قيم أولوية أعلى قبل تلك التي تحتوي على قيم أقل. لا ينطبق الترتيب إلا على الرسائل المتزامنة. ويتم تجاهله للرسائل غير المتزامنة.

لا تستخدِم هذه السمة إلا إذا كنت بحاجة إلى فرض ترتيب محدّد لتلقّي البثّات أو إذا كنت تريد إجبار Android على تفضيل أحد الأنشطة على الأنشطة الأخرى.

القيمة عدد صحيح، مثل 100. تكون الأرقام الأعلى برمجةً لها أولوية أعلى. تكون القيمة التلقائية 0.

في بعض الحالات، يتم تجاهل الأولوية المطلوبة ويتم حصر القيمة ب0. يحدث ذلك في الحالات التالية:

لمزيد من المعلومات، يُرجى الاطّلاع على setPriority().

android:order

ترتيب معالجة الفلتر عند تطابق فلاتر متعددة

تختلف دالة order عن دالة priority من حيث أنّ priority تُطبَّق على مستوى التطبيقات، في حين أنّ order تزيل الغموض عن فلاتر المطابقة المتعدّدة في تطبيق واحد.

عندما يمكن أن تتطابق فلاتر متعدّدة، استخدِم نية موجّهة بدلاً من ذلك.

القيمة عدد صحيح، مثل 100. تتم مطابقة الأرقام الأعلى أولاً. تكون القيمة التلقائية 0.

تمّ تقديم هذه السمة في مستوى واجهة برمجة التطبيقات 28.

android:autoVerify
ما إذا كان نظام Android بحاجة إلى التحقّق من أنّ ملف روابط التنقل إلى مواد العرض الرقمية بتنسيق JSON من المضيف المُحدَّد يتطابق مع هذا التطبيق.

لمزيد من المعلومات، يُرجى الاطّلاع على مقالة التحقّق من روابط تطبيقات Android.

تكون القيمة التلقائية false.

تمّ تقديم هذه السمة في المستوى 23 من واجهة برمجة التطبيقات.

تمّت إتاحة هذه الميزة لأول مرة في:
المستوى 1 من واجهة برمجة التطبيقات
راجِع أيضًا:
<action>
<category>
<data>
<uri-relative-filter-group>