CardEmulation 類別

定義

命名空間:: Android.Nfc.CardEmulators

組件:: Mono.Android.dll

重要

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

此類別可用於查詢 NFC 卡片模擬服務的狀態。

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

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

繼承: Object

JavaObject

Object
CardEmulation

屬性: RegisterAttribute

備註

此類別可用於查詢 NFC 卡片模擬服務的狀態。

關於 NFC 卡模擬的一般入門，請閱讀 NFC 卡模擬開發者指南。</p>

使用此類別需要裝置上存在。PackageManager#FEATURE_NFC_HOST_CARD_EMULATION

Java 文件 android.nfc.cardemulation.CardEmulation。

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

欄位

名稱	Description
ActionChangeDefault	活動動作：請使用者更改某一類別的預設卡片模擬服務。
CategoryOther	可用於所有其他卡片模擬服務的類別。
CategoryPayment	用於 NFC 支付服務的類別。
ExtraCategory	類別額外對。`#ACTION_CHANGE_DEFAULT`
ExtraServiceComponent	服務 `ComponentName` 物件作為額外物件傳送進來 `#ACTION_CHANGE_DEFAULT`。
NfcInternalErrorCommandTimeout	已淘汰. 此錯誤發生在 NFC 堆疊在等待指令回應時逾時。
NfcInternalErrorNfcCrashRestart	已淘汰. 當 NFC 指令看門狗重新啟動 NFC 堆疊時，會報告此錯誤。
NfcInternalErrorNfcHardwareError	已淘汰. 當 NFC 控制器無法回應或發生 NCI 傳輸錯誤時，會報告此錯誤。
NfcInternalErrorUnknown	已淘汰. 此類別可用於查詢 NFC 卡片模擬服務的狀態。
PropertyAllowSharedRolePriority	屬性名稱用於表示應用程式希望允許相關服務共享相同的 AID 路由優先權，當該應用程式是角色持有者時。
ProtocolAndTechnologyRouteDefault	已淘汰. 在設定檔中路由到預設值。
ProtocolAndTechnologyRouteDh	已淘汰. 路由至裝置主機（DH）。
ProtocolAndTechnologyRouteEse	已淘汰. 路由到 eSE。
ProtocolAndTechnologyRouteNdefNfcee	已淘汰. 路由到 T4T NDEF-NCEE 模擬。
ProtocolAndTechnologyRouteUicc	已淘汰. 路線前往UICC。
ProtocolAndTechnologyRouteUnset	已淘汰. 路線未設定。
SelectionModeAlwaysAsk	已淘汰. 的 `#getSelectionModeForCategory(String)`回傳值。
SelectionModeAskIfConflict	已淘汰. 的 `#getSelectionModeForCategory(String)`回傳值。
SelectionModePreferDefault	已淘汰. 的 `#getSelectionModeForCategory(String)`回傳值。

屬性

名稱	Description
AidsForPreferredPaymentService	取得首選支付服務的註冊輔助裝置。
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
DefaultNfcSubscriptionId	會回傳系統預設的 NFC 訂閱 ID。
DescriptionForPreferredPaymentService	此類別可用於查詢 NFC 卡片模擬服務的狀態。
DescriptionForPreferredPaymentServiceFormatted	回傳使用者可見的首選支付服務描述。
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
IsEuiccSupported	EUICC 是否支援作為安全元件 EE，支援主機卡外的模擬？
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	此類別可用於查詢 NFC 卡片模擬服務的狀態。 (繼承來源 JavaObject)
JniPeerMembers	此類別可用於查詢 NFC 卡片模擬服務的狀態。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
RouteDestinationForPreferredPaymentService	取得首選支付服務的路由目的地。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)

方法

名稱	Description
CategoryAllowsForegroundPreference(String)	回傳使用者是否允許在指定類別註冊的 AID 由前景應用程式偏好的服務處理，而非預設設定。
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	此類別可用於查詢 NFC 卡片模擬服務的狀態。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	此類別可用於查詢 NFC 卡片模擬服務的狀態。 (繼承來源 JavaObject)
Equals(Object)	此類別可用於查詢 NFC 卡片模擬服務的狀態。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetAidsForService(ComponentName, String)	取得服務指定類別目前註冊的 AID。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
GetInstance(NfcAdapter)	幫手取得這個職業的實例。
GetPollingLoopFiltersForService(ComponentName)	取得所有註冊為 HostApduService 的輪詢迴圈過濾器。
GetPollingLoopPatternFiltersForService(ComponentName)	檢索所有註冊於 HostApduService 的輪詢迴圈模式過濾器。
GetSelectionModeForCategory(String)	回傳已通過類別的服務選擇模式。
IsDefaultServiceForAid(ComponentName, String)	允許應用程式查詢某服務目前是否是指定 ISO7816-4 應用程式 ID 的預設處理程序。
IsDefaultServiceForCategory(ComponentName, String)	允許應用程式查詢某服務目前是否是處理卡片模擬類別的預設服務。
IsDeviceScreenOnRequiredForService(ComponentName)	檢查裝置是否必須開啟螢幕才能啟動服務。
IsDeviceUnlockRequiredForService(ComponentName)	檢查裝置是否必須解鎖才能啟動服務。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
RegisterAidsForService(ComponentName, String, IList<String>)	註冊指定服務特定類別的輔助裝置清單。
RegisterNfcEventCallback(IExecutor, CardEmulation+INfcEventCallback)	註冊NFC活動回撥。
RegisterPollingLoopFilterForService(ComponentName, String, Boolean)	註冊一個 HostApduService 的輪詢迴圈過濾器（PLF），並指示是否應該自動交易。
RegisterPollingLoopPatternFilterForService(ComponentName, String, Boolean)	註冊一個 HostApduService 的輪詢迴圈模式過濾器（PLPF），並指示是否應該自動交易。
RemoveAidsForService(ComponentName, String)	移除先前登記的指定服務類別的輔助災難清單。
RemovePollingLoopFilterForService(ComponentName, String)	取消註冊一個 HostApduService 的輪詢迴圈過濾器（PLF）。
RemovePollingLoopPatternFilterForService(ComponentName, String)	取消註冊一個 HostApduService 的輪詢迴圈模式過濾器（PLPF）。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetOffHostForService(ComponentName, String)	設定該服務的離線主機安全元件。
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	此類別可用於查詢 NFC 卡片模擬服務的狀態。 (繼承來源 JavaObject)
SetPreferredService(Activity, ComponentName)	允許前景應用程式指定在特定活動處於前景時，優先選擇哪種卡片模擬服務。
SetRequireDeviceScreenOnForService(ComponentName, Boolean)	設定裝置是否必須開啟螢幕才能啟動服務。
SetRequireDeviceUnlockForService(ComponentName, Boolean)	設定是否必須解鎖裝置才能啟動服務。
SetShouldDefaultToObserveModeForService(ComponentName, Boolean)	設定該服務何時成為首選服務，NFC 堆疊應啟用觀察模式或停用觀察模式。
SupportsAidPrefixRegistration()	有些裝置可能允許應用程式註冊所有以特定前綴開頭的 AID，例如
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
UnregisterNfcEventCallback(CardEmulation+INfcEventCallback)	取消註冊先前註冊於 registerNfcEventCallback（Executor，NfcEventCallback）的 NFC 事件回撥。
UnsetOffHostForService(ComponentName)	取消該服務的主機外安全元件。
UnsetPreferredService(Activity)	取消指定活動的首選服務。
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 端是否有效。

適用於