NfcAdapter 類別

定義

命名空間:: Android.Nfc

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

代表本地 NFC 轉接器。

[Android.Runtime.Register("android/nfc/NfcAdapter", DoNotGenerateAcw=true)]
public sealed class NfcAdapter : Java.Lang.Object

[<Android.Runtime.Register("android/nfc/NfcAdapter", DoNotGenerateAcw=true)>]
type NfcAdapter = class
    inherit Object

繼承: Object

JavaObject

Object
NfcAdapter

屬性: RegisterAttribute

備註

代表本地 NFC 轉接器。

用輔助工具 #getDefaultAdapter(Context) 取得這台 Android 裝置的預設 NFC 轉接器。

<div class=“特殊參考”><h3>開發者指南</h3>

想了解更多使用 NFC 的資訊，請閱讀近場通訊開發者指南。

要在裝置間進行基本檔案分享，請閱讀「與 NFC 分享檔案」。 </div>

Java 文件 android.nfc.NfcAdapter。

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

欄位

名稱	Description
ActionAdapterStateChanged	廣播動作：本地 NFC 轉接器的狀態已改變。
ActionChangeTagIntentPreference	活動操作：打開設定頁面，允許使用者啟用或停用應用程式的標籤意圖接收。
ActionNdefDiscovered	當發現帶有 NDEF 有效載荷的標籤時，意圖啟動活動。
ActionPreferredPaymentChanged	廣播行動：意圖通知首選支付服務是否變更。
ActionTagDiscovered	當標籤被發現時，意圖開始某項活動。
ActionTechDiscovered	意圖在發現標籤並註冊該標籤特定技術時啟動活動。
ActionTransactionDetected	廣播動作：通知應用程式安全元件發生交易事件的意圖。
ExtraAdapterState	在 intent 中用作請求當前 power 狀態的 int 額外欄位 `#ACTION_ADAPTER_STATE_CHANGED` 。
ExtraAid	強制位元組[] 額外欄位 `#ACTION_TRANSACTION_DETECTED`
ExtraData	可選的位元組[]額外欄位 `#ACTION_TRANSACTION_DETECTED`
ExtraId	可選附加元件包含一個位元組陣列，包含發現標籤的 ID，該`#ACTION_NDEF_DISCOVERED`標籤為 `#ACTION_TECH_DISCOVERED`、 `#ACTION_TAG_DISCOVERED`、及意圖。
ExtraNdefMessages	額外內容包含在發現標籤上的 present 陣 `NdefMessage` 列。
ExtraPreferredPaymentChangedReason	強制字串額外欄位 `#ACTION_PREFERRED_PAYMENT_CHANGED` 表示觸發此事件時的條件。
ExtraReaderPresenceCheckDelay	用於與 `#enableReaderMode(Activity, ReaderCallback, int, Bundle)`.
ExtraReaderTechAPollingLoopAnnotation	在呼叫 `#enableReaderMode(Activity, ReaderCallback, int, Bundle)`Bundle 時，指定一個 NFC-A 輪詢迴圈註解（以位元組陣列形式）來指定。
ExtraSecureElementName	在 Dendatory String extra 欄位 `#ACTION_TRANSACTION_DETECTED` 中，表示交易發生的安全元件。
ExtraTag	必須額外內容，包含`Tag`發現的、 `#ACTION_NDEF_DISCOVERED#ACTION_TECH_DISCOVERED`和 `#ACTION_TAG_DISCOVERED` 意圖。
FlagListenDisable	已淘汰. 用於 `#setDiscoveryTechnology(Activity, int, int)`的旗標。
FlagListenKeep	已淘汰. 用於 `#setDiscoveryTechnology(Activity, int, int)`的旗標。
FlagListenNfcPassiveA	已淘汰. 標記用於 `#setDiscoveryTechnology(Activity, int, int)`。
FlagListenNfcPassiveB	已淘汰. 標記用於 `#setDiscoveryTechnology(Activity, int, int)`。
FlagListenNfcPassiveF	已淘汰. 標記用於 `#setDiscoveryTechnology(Activity, int, int)`。
FlagReaderDisable	已淘汰. 用於 `#setDiscoveryTechnology(Activity, int, int)`的旗標。
FlagReaderKeep	已淘汰. 用於 `#setDiscoveryTechnology(Activity, int, int)`的旗標。
FlagReaderNfcA	已淘汰. 標記用於 `#enableReaderMode(Activity, ReaderCallback, int, Bundle)`。
FlagReaderNfcB	已淘汰. 標記用於 `#enableReaderMode(Activity, ReaderCallback, int, Bundle)`。
FlagReaderNfcBarcode	已淘汰. 標記用於 `#enableReaderMode(Activity, ReaderCallback, int, Bundle)`。
FlagReaderNfcF	已淘汰. 標記用於 `#enableReaderMode(Activity, ReaderCallback, int, Bundle)`。
FlagReaderNfcV	已淘汰. 標記用於 `#enableReaderMode(Activity, ReaderCallback, int, Bundle)`。
FlagReaderNoPlatformSounds	已淘汰. 標記用於 `#enableReaderMode(Activity, ReaderCallback, int, Bundle)`。
FlagReaderSkipNdefCheck	已淘汰. 標記用於 `#enableReaderMode(Activity, ReaderCallback, int, Bundle)`。
PreferredPaymentChanged	已淘汰. 使用者選擇了其他支付應用程式作為首選付款方式。
PreferredPaymentLoaded	已淘汰. 啟用 NFC 並註冊了偏好的支付工具。
PreferredPaymentUpdated	已淘汰. 目前的優先付款已發布更新（註冊/未註冊的新輔助資料，或本身已更新）。
StateOff
StateOn
StateTurningOff
StateTurningOn

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
DefaultAdapter	已淘汰. 舊款 NfcAdapter 獲取器，永遠 `#getDefaultAdapter(Context)` 用它代替。
GestureExchangeAid	取得點擊分享功能的輔助裝置。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
IsEnabled	如果這個 NFC 轉接器啟用了任何功能，請回傳 true。
IsExitFramesSupported	回傳裝置是否支援退出框架。
IsNdefPushEnabled	如果啟用了 NDEF Push（Android Beam）功能，則回傳為真。
IsObserveModeEnabled	回傳觀察模式目前是否啟用。
IsObserveModeSupported	回傳裝置是否支援觀察模式。
IsPowerSavingModeEnabled	無論目前是否啟用省電模式，都會回傳。
IsPowerSavingModeSupported	回傳裝置是否支援省電模式。
IsReaderModeAnnotationSupported	透過傳遞包含 `#EXTRA_READER_TECH_A_POLLING_LOOP_ANNOTATION` 指向 `#enableReaderMode(Activity, ReaderCallback, int, Bundle)`鍵的額外套件，回傳裝置是否支援在啟用讀取模式時設定註解框架。
IsReaderOptionEnabled	檢查 NFC 閱讀器選項功能是否啟用。
IsReaderOptionSupported	檢查裝置是否支援 NFC 閱讀器選項功能。
IsSecureNfcEnabled	檢查 Secure NFC 功能已啟用。
IsSecureNfcSupported	檢查裝置是否支援 Secure NFC 功能。
IsTagIntentAllowed	檢查使用者是否已停用呼叫應用程式接收 NFC 標籤意圖。
IsTagIntentAppPreferenceSupported	檢查裝置是否支援標籤意圖應用程式偏好設定功能。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	代表本地 NFC 轉接器。 (繼承來源 JavaObject)
JniPeerMembers	代表本地 NFC 轉接器。
NfcAntennaInfo	回傳裝置上Nfc天線的相關資訊，例如其在裝置上的相對位置。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)

方法

名稱	Description
AllowOneTransaction()	暫時停用觀察模式，允許單一主機卡模擬（HCE）交易繼續進行。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	代表本地 NFC 轉接器。 (繼承來源 JavaObject)
Disable()	關閉 NFC 硬體。
DisableForegroundDispatch(Activity)	關閉對該活動的前景派遣。
DisableForegroundNdefPush(Activity)	已淘汰. 關閉 NDEF 訊息推送，透過 P2P。
DisableReaderMode(Activity)	將 NFC 轉接器恢復為正常運作模式：支援點對點（Android Beam）、卡片模擬，以及所有支援標籤技術的輪詢。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	代表本地 NFC 轉接器。 (繼承來源 JavaObject)
Enable()	啟用 NFC 硬體。
EnableForegroundDispatch(Activity, PendingIntent, IntentFilter[], String[][])	啟用對特定活動的前景派遣。
EnableForegroundNdefPush(Activity, NdefMessage)	已淘汰. 在此活動處於前景時，啟用 NDEF 訊息透過 NFC 推送。
EnableReaderMode(Activity, NfcAdapter+IReaderCallback, NfcReaderFlags, Bundle)	當這個活動在前景時，將 NFC 控制器限制在讀取模式。
Equals(Object)	代表本地 NFC 轉接器。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetDefaultAdapter(Context)	幫手取得預設的 NFC 轉接器。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
Ignore(Tag, Int32, NfcAdapter+IOnTagRemovedListener, Handler)	表示只要 NFC 標籤還在範圍內，你就不再有興趣與它通訊。
InvokeBeam(Activity)	手動呼叫 Android Beam 來分享資料。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
ResetDiscoveryTechnology(Activity)	恢復 NFC 控制器的輪詢/聆聽技術至預設狀態，該技術已被 `#setDiscoveryTechnology(Activity , int , int)`
SetBeamPushUris(Uri[], Activity)	設定一個或多個 `Uri`s 發送 Android Beam （TM）。
SetBeamPushUrisCallback(NfcAdapter+ICreateBeamUrisCallback, Activity)	設定一個回調，動態產生一個或多個 `Uri`s，並用 Android Beam（TM）發送。
SetDiscoveryTechnology(Activity, NfcReaderFlags, NfcListenFlags)	設定 NFC 控制器啟用特定輪詢/聆聽技術，依參數指定，且此活動位於前景。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetNdefPushMessage(NdefMessage, Activity, Activity[])	設定一個靜態的 NDEF 訊息，要用 Android Beam 傳送。
SetNdefPushMessageCallback(NfcAdapter+ICreateNdefMessageCallback, Activity, Activity[])	設定回調，動態產生 NDEF 訊息，並透過 Android Beam 傳送。
SetObserveModeEnabled(Boolean)	控制 NFC 介面卡是否允許交易繼續進行，或進入觀察模式，僅觀察並通知 APDU 服務輪詢迴圈框架。
SetOnNdefPushCompleteCallback(NfcAdapter+IOnNdefPushCompleteCallback, Activity, Activity[])	在成功啟用 Android Beam （TM）時設定回撥。
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	代表本地 NFC 轉接器。 (繼承來源 JavaObject)
SetPowerSavingMode(Boolean)	設定下次禁用 `NfcAdapter#disable()`NFC 晶片時是否應進入省電模式。
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	代表本地 NFC 轉接器。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	代表本地 NFC 轉接器。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	代表本地 NFC 轉接器。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	代表本地 NFC 轉接器。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	代表本地 NFC 轉接器。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	代表本地 NFC 轉接器。 (繼承來源 JavaObject)

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	代表本地 NFC 轉接器。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於