語言

NfcAdapter.SetNdefPushMessage(NdefMessage, Activity, Activity[]) 方法

定義

命名空間:
Android.Nfc
組件:
Mono.Android.dll

設定一個靜態的 NDEF 訊息，要用 Android Beam 傳送。

[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

靜態 NDEF 訊息用來推送 NFC，或 null 清除靜態訊息提供者。

activity
Activity

NDEF 訊息將被推送的非空活動。

activities
Activity[]

一個非空的額外非空活動陣列。 如果沒有其他活動，則傳遞一個空陣列。 一次從該活動 OnCreate 的方法中註冊一個活動。

屬性
RegisterAttribute

例外狀況

UnsupportedOperationException

該裝置不支援 NFC。

IllegalStateException

指定的活動已經被銷毀。

NullPointerException

在 Android 版本中，若 Android Beam 是可運作的 activity，， activities， 或 的 activities 元素為 null。

備註

Android Beam 在 API 等級 29 時被棄用。 在支援 Android Beam 的裝置上，它能維持到 API 等級 33 的運作。 從 API 層級 34 開始，Android Beam 被移除，呼叫此方法也不再生效。

該訊息僅在指定活動恢復時，才會提供給 NDEF 推送。 先將此方法呼叫為 Activity.OnDestroy，最好是從 中 。Activity.OnCreate 它不會執行 I/O 或阻斷工作，從主執行緒呼叫是安全的。

恢復的活動只能推送一個 NDEF 訊息。 如果訊息回撥也設定為 SetNdefPushMessageCallback，則回調優先權。 傳遞 null 會清除靜態訊息提供者;註冊回撥繼續提供 NDEF 訊息。

當訊息必須動態產生時使用 SetNdefPushMessageCallback 。 不要跳過已經達到 Activity.OnDestroy的活動。

需要 android.Manifest.permission#NFC 權限。

Android 開源 Project 原始碼文件。android.nfc.NfcAdapter.setNdefPushMessage

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於