<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>
description:
يحدد هذا الإعداد أنواع الأغراض التي يمكن أن يستجيب لها نشاط أو خدمة أو جهاز استقبال بث. يعلن فلتر الأهداف عن إمكانات المكون الرئيسي: ما يمكن أن يفعله النشاط أو الخدمة وأنواع عمليات البث التي يمكن للمستلم التعامل معها.

فهو يفتح المكوِّن لتلقي أغراض من النوع المُعلَن عنه مع استبعاد تلك التي لا تفيد المكون. يتم وصف معظم محتوى الفلتر من خلال عناصره الفرعية <action> و<category> و<data>.

للحصول على مناقشة أكثر تفصيلاً للفلاتر، يمكنك الاطّلاع على فلاتر الأهداف والأهداف وقسم فلاتر الأهداف في النظرة العامة على بيان التطبيق.

السمات:
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>