CardEmulation.SetOffHostForService(ComponentName, String) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
設定該服務的離線主機安全元件。
[Android.Runtime.Register("setOffHostForService", "(Landroid/content/ComponentName;Ljava/lang/String;)Z", "", ApiSince=29)]
[Android.Runtime.RequiresPermission("android.permission.NFC")]
public bool SetOffHostForService(Android.Content.ComponentName service, string offHostSecureElement);
[<Android.Runtime.Register("setOffHostForService", "(Landroid/content/ComponentName;Ljava/lang/String;)Z", "", ApiSince=29)>]
[<Android.Runtime.RequiresPermission("android.permission.NFC")>]
member this.SetOffHostForService : Android.Content.ComponentName * string -> bool
參數
- service
- ComponentName
服務的元件名稱
- offHostSecureElement
- String
安全元件用來註冊AID至。 只接受帶有前綴 SIM 或前綴 eSE 的字串。 參考:GSMA TS.26 - NFC 手機需求 TS26_NFC_REQ_069:UICC 的安全元件名稱必須為 SIM[智慧卡插槽](例如 SIM/SIM1、SIM2...SIM 的)。 TS26_NFC_REQ_070:對於嵌入式 SE,安全元件名稱必須為 eSE[number](例如 eSE/eSE1、eSE2 等)。
傳回
是否登記成功。
- 屬性
備註
設定該服務的離線主機安全元件。
如果最初是透過清單靜態設定,或是透過此 API 動態設定,則會被這個 SE 取代。 所有由本服務註冊的 AID,若成功,將重新導向至此安全元件。 使用 manifest 靜態指派的 AID 在切換 NFC 後會重新導向到 manifest 中指定的離線主機 SE。
請注意,你只能為與此 API 呼叫者在同一 UID 下執行的服務設定 off-host SE。 通常這表示你需要從與服務本身相同的套件呼叫,不過 UID 也可以在使用共用 UID 的套件間共享。
只有當裝置上有安全元件時,註冊才會成功。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。