NdefRecord.CreateExternal(String, String, Byte[]) 方法

定義

命名空間:

Android.Nfc

組件:

Mono.Android.dll

建立一個包含外部（應用程式特定）資料的新 NDEF 記錄。

[Android.Runtime.Register("createExternal", "(Ljava/lang/String;Ljava/lang/String;[B)Landroid/nfc/NdefRecord;", "")]
public static Android.Nfc.NdefRecord? CreateExternal(string? domain, string? type, byte[]? data);

[<Android.Runtime.Register("createExternal", "(Ljava/lang/String;Ljava/lang/String;[B)Landroid/nfc/NdefRecord;", "")>]
static member CreateExternal : string * string * byte[] -> Android.Nfc.NdefRecord

參數

domain

String

發行組織的網域名稱

type

String

領域特定類型的資料

data

Byte[]

有效載荷以位元組形式

傳回

NdefRecord

屬性

RegisterAttribute

備註

建立一個包含外部（應用程式特定）資料的新 NDEF 記錄。

使用此方法將應用程式專屬資料編碼為 NDEF 紀錄。 資料會以網域名稱（通常是你的 Android 套件名稱）和網域特定類型來分類。 這些資料會被打包成「NFC 論壇外部類型」NDEF 紀錄。

NFC 論壇要求外部紀錄中使用的網域和類型必須不區分大小寫，然而 Android 的意圖過濾始終是大小寫區分的。 因此，此方法會在建立 NDEF 記錄前強制將網域和類型縮小為小寫。

若域與類型存在嚴重問題，例如任一欄位為空，未勾選例外 IllegalArgumentException 會被拋出，因此若將使用者產生資料傳入此方法，務必捕捉此異常。

酬載資料則沒有此類限制。

為了效率，此方法可能不會在內部複製資料位元組陣列，因此請注意不要在使用回傳的 NdefRecord 時修改資料位元組陣列。

參考規範：NFCForum-TS-RTD_1.0

Java 文件 android.nfc.NdefRecord.createExternal(java.lang.String, java.lang.String, byte[])。

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