Language

NfcAdapter.SetNdefPushMessage(NdefMessage, Activity, Activity[]) メソッド

定義

Android ビームを使用して送信する静的 NDEF メッセージを設定します。

[Android.Runtime.Register("setNdefPushMessage", "(Landroid/nfc/NdefMessage;Landroid/app/Activity;[Landroid/app/Activity;)V", "")]
public void SetNdefPushMessage(Android.Nfc.NdefMessage? message, Android.App.Activity? activity, params Android.App.Activity[]? activities);
[<Android.Runtime.Register("setNdefPushMessage", "(Landroid/nfc/NdefMessage;Landroid/app/Activity;[Landroid/app/Activity;)V", "")>]
member this.SetNdefPushMessage : Android.Nfc.NdefMessage * Android.App.Activity * Android.App.Activity[] -> unit

パラメーター

message
NdefMessage

NFC 経由でプッシュする静的 NDEF メッセージ。静的メッセージ プロバイダーをクリアするために null 。

activity
Activity

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

activities
Activity[]

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

属性

例外

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

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

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

注釈

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

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

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

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

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

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

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

適用対象