NfcAdapter.SetNdefPushMessageCallback メソッド

定義

名前空間:: Android.Nfc

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

重要

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

Android Beam を使用して送信する NDEF メッセージを動的に生成するコールバックを設定します。

[Android.Runtime.Register("setNdefPushMessageCallback", "(Landroid/nfc/NfcAdapter$CreateNdefMessageCallback;Landroid/app/Activity;[Landroid/app/Activity;)V", "")]
public void SetNdefPushMessageCallback(Android.Nfc.NfcAdapter.ICreateNdefMessageCallback? callback, Android.App.Activity? activity, params Android.App.Activity[]? activities);

[<Android.Runtime.Register("setNdefPushMessageCallback", "(Landroid/nfc/NfcAdapter$CreateNdefMessageCallback;Landroid/app/Activity;[Landroid/app/Activity;)V", "")>]
member this.SetNdefPushMessageCallback : Android.Nfc.NfcAdapter.ICreateNdefMessageCallback * Android.App.Activity * Android.App.Activity[] -> unit

パラメーター

callback: NfcAdapter.ICreateNdefMessageCallback

NDEF メッセージを作成するコールバック。コールバックプロバイダーをクリアするために null 。

activity: Activity

NDEF メッセージがプッシュされる null 以外のアクティビティ。

activities: Activity[]

null 以外の追加アクティビティの null 以外の配列。追加のアクティビティがない場合は、空の配列を渡します。そのアクティビティの OnCreate メソッドから一度に 1 つのアクティビティを登録します。

属性: RegisterAttribute

例外

UnsupportedOperationException

デバイスは NFC をサポートしていません。

IllegalStateException

指定されたアクティビティは既に破棄されています。

NullPointerException

Android Beam が機能する Android バージョンでは、 activity、 activities、または activities の要素が null。

注釈

Android ビームは API レベル 29 で非推奨になりました。 Android Beam をサポートするデバイスでは、API レベル 33 を通じて引き続き機能します。 API レベル 34 以降では、Android Beam が削除され、このメソッドの呼び出しは無効になります。

コールバックは、指定されたアクティビティが再開されている間のみ実行できます。 Activity.OnCreateからActivity.OnDestroyする前に、このメソッドを呼び出します。 I/O またはブロック作業は実行されず、メインスレッドから呼び出しても安全です。

再開されたアクティビティによってプッシュできる NDEF メッセージは 1 つだけです。静的メッセージも SetNdefPushMessage で設定されている場合、このコールバックが優先されます。 null渡すとコールバックプロバイダーがクリアされます。登録済みの静的メッセージは引き続き使用されます。

メッセージを変更する必要がない場合は、 SetNdefPushMessage を使用します。既に Activity.OnDestroyに達しているアクティビティを渡さないでください。

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

Android オープンソースProject android.nfc.NfcAdapter.setNdefPushMessageCallbackのソースドキュメント。

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

適用対象