語言

NfcAdapter.SetNdefPushMessageCallback 方法

定義

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

設定回調，動態產生 NDEF 訊息，並透過 Android Beam 傳送。

[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 訊息將被推送的非空活動。

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 被移除，呼叫此方法也不再生效。

回調只能在指定活動恢復時執行。 先將此方法呼叫為 Activity.OnDestroy，最好是從 中 。Activity.OnCreate 它不會執行 I/O 或阻斷工作，從主執行緒呼叫是安全的。

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

當訊息不需要改變時使用 SetNdefPushMessage 。 不要跳過已經達到 Activity.OnDestroy的活動。

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

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

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

適用於