- 構文:
<intent-filter android:icon="drawable resource" android:label="string resource" android:priority="integer" > . . . </intent-filter>
- 上位の要素:
<activity>
<activity-alias>
<service>
<receiver>
<provider>
- 必須の下位の要素:
<action>
- 格納可能な下位の要素:
<category>
<data>
- 説明:
- アクティビティ、サービス、またはブロードキャスト レシーバが応答できるインテントのタイプを指定します。インテント フィルタは、その親コンポーネントの機能(アクティビティまたはサービスが実行できることと、レシーバが処理できるブロードキャストのタイプ)を宣言します。また、アドバタイズされたタイプのインテントを受け取るコンポーネントを開く一方で、そのコンポーネントにとって意味を持たないインテントを除外します。
フィルタのほとんどの内容は、その
<action>
サブ要素、<category>
サブ要素、<data>
サブ要素で記述します。フィルタについて詳しくは、インテントとインテント フィルタに関する別のドキュメントと、概要ページのインテント フィルタに関するセクションをご覧ください。
- 属性:
android:icon
- 親であるアクティビティ、サービス、ブロードキャスト レシーバを表すアイコン。該当のコンポーネントが、フィルタで記述されている機能を持つコンポーネントとしてユーザーに提示される際に表示されます。
この属性は、画像の定義を含むドローアブル リソースへの参照として設定する必要があります。デフォルト値は、親コンポーネントの
icon
属性で設定されているアイコンです。親がアイコンを指定していない場合のデフォルト値は、<application>
要素で設定されているアイコンです。インテント フィルタのアイコンについて詳しくは、概要ページのアイコンとラベルをご覧ください。
android:label
- 親コンポーネントのユーザー可読形式のラベル。このラベルは、該当のコンポーネントが、フィルタで記述されている機能を持つコンポーネントとしてユーザーに提示される際に、親コンポーネントによって設定されているラベルの代わりに使用されます。
ラベルは文字列リソースへの参照として設定する必要があります。そうすることで、ユーザー インターフェースの他の文字列と同じようにローカライズできるようになります。ただし、アプリの開発時は、簡便性を考慮して RAW 文字列として設定することもできます。
デフォルト値は、親コンポーネントによって設定されているラベルです。親がラベルを指定していない場合のデフォルト値は、
<application>
要素のlabel
属性で設定されているラベルです。インテント フィルタのラベルについて詳しくは、概要ページのアイコンとラベルをご覧ください。
android:priority
- フィルタで記述されているタイプのインテントの処理に関して親コンポーネントに付与される優先度。この属性は、アクティビティとブロードキャスト レシーバの両方にとって次のような意味を持ちます。
- フィルタと一致するインテントに対するアクティビティの応答能力に関する情報を提供します。これは、インテントに応答できる他のアクティビティとの比較に基づく応答能力です。優先度の異なる複数のアクティビティがインテントを処理できる場合、Android は高い優先度の値を持つアクティビティのみをインテントの潜在的ターゲットと見なします。
ブロードキャスト メッセージを受信する際のブロードキャスト レシーバの実行順序を制御します。優先度の値が高いレシーバは、値が低いレシーバよりも前に呼び出されます(この順序は同期メッセージにのみ適用され、非同期メッセージでは無視されます)。
この属性の使用は、ブロードキャストの受信順序を指定する実際上の必要がある場合や、あるアクティビティを他のアクティビティより優先するよう Android に指示したい場合に限定してください。
この値は必ず整数(「
100
」など)で指定します。値が大きいほど優先度が高くなります。デフォルト値は 0 です。状況によっては、リクエストした優先度が無視され、値が
0
に制限されることがあります。これは以下の場合に発生します。- 非特権アプリが 0 より大きい優先度をリクエストしている場合
- 特権アプリが
ACTION_VIEW
、ACTION_SEND
、ACTION_SENDTO
、またはACTION_SEND_MULTIPLE
に対して 0 より大きい優先度をリクエストしている場合
setPriority()
も参照してください。 android:order
- 複数のフィルタが一致するときのフィルタの処理順序。
order
はpriority
と次の点で異なります。priority
は複数のアプリ間で適用されますが、order
は 1 つのアプリ内の複数の一致するフィルタの処理順序を明確にします。複数のフィルタが一致する可能性がある場合は、代わりに有向インテントを使用してください。
この値は必ず整数(「
100
」など)で指定します。値が大きいものが先に処理されます。 デフォルト値は0
です。この属性は API レベル 28 で導入されました。
android:autoVerify
- 指定されたホストの Digital Asset Links JSON ファイルが、このアプリと一致していることを Android が検証するかどうか。
デフォルト値は
false
です。この属性は API レベル 23 で導入されました。
- 導入時の API レベル:
- API レベル 1
- 関連項目:
<action>
<category>
<data>
このページのコンテンツやコードサンプルは、コンテンツ ライセンスに記載のライセンスに従います。Java および OpenJDK は Oracle および関連会社の商標または登録商標です。
最終更新日 2022-10-05 UTC。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"必要な情報がない"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"複雑すぎる / 手順が多すぎる"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"最新ではない"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻訳に関する問題"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"サンプル / コードに問題がある"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"その他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"わかりやすい"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"問題の解決に役立った"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"その他"
}]