NdefRecord.CreateExternal(String, String, Byte[]) メソッド

定義

外部 (アプリケーション固有) データを含む新しい 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[]

ペイロード (バイト単位)

返品

属性

注釈

外部 (アプリケーション固有) データを含む新しい NDEF レコードを作成します。

このメソッドを使用して、アプリケーション固有のデータを NDEF レコードにエンコードします。 データは、ドメイン名 (通常は Android パッケージ名) とドメイン固有の型で型指定されます。 このデータは、"NFC フォーラム外部型" NDEF レコードにパッケージ化されます。

NFC フォーラムでは、外部レコードで使用されるドメインと型は大文字と小文字を区別しないものとして扱われる必要があります。ただし、Android の意図フィルター処理では常に大文字と小文字が区別されます。 したがって、このメソッドは、NDEF レコードを作成する前に、ドメインと型を小文字に強制します。

ドメインと型に重大な問題がある場合 (たとえば、いずれかのフィールドが空の場合) は、オフの例外 IllegalArgumentException がスローされるため、ユーザーが生成したデータをこのメソッドに渡す場合は常にこの例外をキャッチします。

ペイロード データにこのような制限はありません。

効率を高めるために、このメソッドはデータ バイト配列の内部コピーを作成しない可能性があるため、返された NdefRecord を引き続き使用しながらデータ バイト配列を変更しないように注意してください。

リファレンス仕様: NFCForum-TS-RTD_1.0

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象