NdefRecord.CreateExternal(String, String, Byte[]) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Créez un enregistrement NDEF contenant des données externes (spécifiques à l’application).
[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.NdefRecordParamètres
- domain
- String
nom de domaine de l’organisation émettrice
- type
- String
type de données spécifique au domaine
- data
- Byte[]
charge utile en tant qu’octets
Retours
- Attributs
Remarques
Créez un enregistrement NDEF contenant des données externes (spécifiques à l’application).
Utilisez cette méthode pour encoder des données spécifiques à l’application dans un enregistrement NDEF. Les données sont typées par un nom de domaine (généralement votre nom de package Android) et un type spécifique au domaine. Ces données sont empaquetées dans un enregistrement NDEF « NFC Forum External Type ».
Le forum NFC exige que le domaine et le type utilisés dans un enregistrement externe soient traités comme non respectant la casse, mais le filtrage des intentions Android respecte toujours la casse. Ainsi, cette méthode force le domaine et le type en minuscules avant de créer l’enregistrement NDEF.
L’exception IllegalArgumentException non cochée est levée si le domaine et le type présentent de graves problèmes, par exemple si l’un des champs est vide, interceptez toujours cette exception si vous transmettez des données générées par l’utilisateur dans cette méthode.
Il n’existe aucune restriction de ce type sur les données de charge utile.
Pour plus d’efficacité, cette méthode peut ne pas créer une copie interne du tableau d’octets de données. Veillez donc à ne pas modifier le tableau d’octets de données tout en utilisant le NdefRecord retourné.
Spécification de référence : NFC Forums-TS-RTD_1.0
Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.