IntentFilter 클래스

정의

[Android.Runtime.Register("android/content/IntentFilter", DoNotGenerateAcw=true)]
public class IntentFilter : Java.Lang.Object, Android.OS.IParcelable, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("android/content/IntentFilter", DoNotGenerateAcw=true)>]
type IntentFilter = class
    inherit Object
    interface IParcelable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

상속

Object

Object

IntentFilter

특성

RegisterAttribute

구현

IParcelable IJavaObject IJavaPeerable IDisposable

설명

일치시킬 의도 값에 대한 구조적 설명입니다. IntentFilter는 의도의 작업, 범주 및 데이터(형식, 체계 및/또는 경로를 통해)와 일치할 수 있습니다. 또한 일치하는 여러 필터를 정렬하는 데 사용되는 "우선 순위" 값도 포함됩니다.

IntentFilter 개체는 태그를 사용하여 android.R.styleable#AndroidManifestIntentFilter intent-filter 패키지 파일의 android.R.styleable#AndroidManifest AndroidManifest.xml 일부로 XML에서 만들어지는 경우가 많습니다.

필터링 <할 수 있는 세 가지 의도 특성은 em>action</em>, <em>data</em> 및 <em>categories</em>입니다. 이러한 각 특성에 대해 가능한 여러 일치 값(각각을 통해#addAction, ,#addDataType, #addDataScheme#addDataSchemeSpecificPart, #addDataAuthority#addDataPath및#addCategory)을 제공할 수 있습니다. 작업의 경우 데이터 특성이 지정되지 않은 경우 필터는 데이터가 없는 의도만 일치합니다.

데이터 특성 자체는 형식, 체계, 권한 및 경로의 세 가지 특성으로 나뉩니다. 지정된 모든 항목은 의도의 내용과 일치해야 합니다. 체계를 지정하지만 형식이 없는 경우 형식이 없는 의도(예: mailto:)만 일치합니다. 콘텐츠: URI는 항상 콘텐츠 공급자가 제공하는 MIME 형식을 가지고 있기 때문에 일치하지 않습니다. 구성표가 없는 형식을 지정하는 것은 URI 필드가 없는 의도 또는 콘텐츠가 있는 의도 또는 파일: URI와 일치합니다. 둘 다 지정하지 않으면 데이터나 형식이 없는 의도만 일치합니다. 기관을 지정하려면 연결된 구성표도 하나 이상 지정해야 합니다. 경로를 지정하려면 하나 이상의 기관 및 연결된 하나 이상의 체계를 모두 지정해야 합니다.

<div class="special reference"><h3>Developer Guides</h3>

의도를 만들고 해결하는 방법에 대한 자세한 내용은 의도 및 의도 필터 개발자 가이드를 참조하세요.

</div>

<h3>필터 규칙</h3>

일치 항목은 다음 규칙을 기반으로 합니다. IntentFilter가 의도와 일치하려면 세 가지 조건을 유지해야 <합니다. 즉, 강력한>작업</강력> 범주</강력한>범주</강력한> 항목이 일치해야 하며><, 데이터(강력한 데이터 형식</강력한> 데이터 체계+authority+path</strong>(지정된 경우 모두<>)가 일치해야 합니다(데이터 필드가 일치하는 방법에 대한 자세한 내용은 참조#match(ContentResolver, Intent, boolean, String)).

<지정된 값 중 하나라도 의도 동작과 일치하는 경우 강력한>작업</강력한> 동작이 일치합니다. 필터가 동작을 지정하지 않으면 작업이 포함되지 않은 의도만 일치합니다.

<지정된 값 중 하나라도 의도 형식<과 일치하는 경우 강력한>데이터 형식/강력한> 데이터 형식이 일치합니다. 의도 형식은 호출 Intent#resolveType에 의해 결정됩니다. "audio/*" 형식이 "audio/mpeg", "audio/aiff", "audio/*" 등과 일치할 수 있도록 의도 및 IntentFilter 모두에서 MIME 하위 형식에 와일드카드를 사용할 수 있습니다. <em>여기서 일치하는 MIME 형식은 <공식 RFC MIME 형식과 달리 b>대</b>입니다.</em> 따라서 항상 MIME 형식에 소문자를 사용해야 합니다.

<지정된 값 중 하나라도 의도 데이터의 체계와 일치하는 경우 강력한>데이터 체계</강력한> 데이터 체계가 일치합니다. 의도 체계는 해당 URI를 호출 Intent#getData 하여 android.net.Uri#getScheme 결정됩니다. <em>여기서 일치하는 체계는 <공식 RFC 스키마와 달리 대>/소문자 구분</b>입니다.</em> 따라서 항상 구성표에 소문자를 사용해야 합니다.

<필터의 데이터 구성표 중 하나와 일치하는 지정된 값이 의도의 데이터 구성표 특정 부분 em 및/em>과 일치하는 경우 강력한 데이터 구성표 특정 부분</강력한>> 부분이 일치합니다. 필터에 특정 구성표가 제공되지 않은 의도와><>< 일치합니다.<>< 의도 구성표 특정 부분은 호출 Intent#getData 및 android.net.Uri#getSchemeSpecificPart 해당 URI에 따라 결정됩니다. <em>구성표별 부품 일치는 b 대/소문>자 구분</b>입니다<.</그들>

<필터의 데이터 체계 중 하나와 일치하는 지정된 값이 의도의 데이터 기관 em 및/em>과 일치하는 경우 강력한>데이터 기관</강력한> 일치 항목이 필터에 제공된><>< 권한이 없습니다.<>< 의도 기관은 해당 URI를 호출 Intent#getData 하여 android.net.Uri#getAuthority 결정됩니다. <em>여기서 일치하는 권한은 <공식 RFC 호스트 이름과 달리 b>대/<b>입니다.</em> 따라서 항상 권한에 대 한 소문자를 사용 해야 합니다.

<지정된 값이 의도의 데이터 경로 em>및/em>과< 일치하는 경우 필터의 체계와 기관이 의도<><와 일치하면 강력한>데이터 경로<</>강력한> 경로가 일치합니다. 필터에 경로가 제공되지 않았습니다. 의도 기관은 해당 URI를 호출 Intent#getData 하여 android.net.Uri#getPath 결정됩니다.

<<필터에 지정된 의도 일치 범주에 있는 범주의 모든</em>을 포함하는 경우>< 강력한 범주/강력한>> 일치 항목입니다. 의도에 없는 필터의 추가 범주로 인해 일치 항목이 실패하지 않습니다. 작업과 달리 범주가 없는 IntentFilter는 범주가 없는 의도와만 일치합니다.

에 대한 android.content.IntentFilterJava 설명서

이 페이지의 일부는 Android 오픈 소스 프로젝트에서 만들고 공유하고 Creative Commons 2.5 특성 라이선스에 설명된 용어에 따라 사용되는 작업을 기반으로 하는 수정 사항입니다.

생성자

필드

속성

메서드

명시적 인터페이스 구현

확장 메서드

적용 대상