NfcAdapter.EnableForegroundDispatch メソッド

定義

名前空間:: Android.Nfc

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

指定されたアクティビティへのフォアグラウンドディスパッチを有効にします。

[Android.Runtime.Register("enableForegroundDispatch", "(Landroid/app/Activity;Landroid/app/PendingIntent;[Landroid/content/IntentFilter;[[Ljava/lang/String;)V", "")]
public void EnableForegroundDispatch(Android.App.Activity? activity, Android.App.PendingIntent? intent, Android.Content.IntentFilter[]? filters, string[][]? techLists);

[<Android.Runtime.Register("enableForegroundDispatch", "(Landroid/app/Activity;Landroid/app/PendingIntent;[Landroid/content/IntentFilter;[[Ljava/lang/String;)V", "")>]
member this.EnableForegroundDispatch : Android.App.Activity * Android.App.PendingIntent * Android.Content.IntentFilter[] * string[][] -> unit

パラメーター

activity: Activity

ディスパッチ先のアクティビティ

intent: PendingIntent

ディスパッチの開始する PendingIntent

filters: IntentFilter[]

ディスパッチをオーバーライドする IntentFilters、または常にディスパッチする場合は null

techLists: String[][]

NfcAdapter#ACTION_TECH_DISCOVERED意図のディスパッチに一致を実行するために使用される技術リスト

属性: RegisterAttribute

例外

IllegalStateException

アクティビティが現在フォアグラウンドにない場合

注釈

指定されたアクティビティへのフォアグラウンドディスパッチを有効にします。

これにより、検出された Tag をアプリケーションにディスパッチするときに、フォアグラウンドアクティビティが優先されます。

このメソッドに IntentFilter が指定されている場合は、 NfcAdapter#ACTION_NDEF_DISCOVERED と NfcAdapter#ACTION_TAG_DISCOVEREDの両方のディスパッチ意図を照合するために使用されます。 NfcAdapter#ACTION_TECH_DISCOVEREDはそのディスパッチインテントの IntentFilter 照合の外部にあるメタデータに依存しているため、技術リストを個別に渡すことによって処理されます。技術リストの最初のレベルの各エントリは、一致させるためにすべて存在する必要があるテクノロジの配列を表します。最初のレベルセットのいずれかが一致する場合、ディスパッチは指定された PendingIntent を介してルーティングされます。つまり、2 番目のレベルは一緒に AND され、最初のレベルのエントリは一緒に ORed になります。

ワイルドカードに作用し、フォアグラウンドアクティビティがNfcAdapter#ACTION_TAG_DISCOVERED意図を介してすべてのタグを受信するfiltersパラメーターとtechLists パラメーターの両方に対してnullを渡す場合。

このメソッドは、メインスレッドから呼び出す必要があり、アクティビティがフォアグラウンド (再開) にある場合にのみ呼び出す必要があります。また、アクティビティは、Activity#onPauseコールバックが完了する前に#disableForegroundDispatchを呼び出して、フォアグラウンドディスパッチを有効にした後で無効にする必要があります。

android.Manifest.permission#NFC アクセス許可が必要です。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象