用語と慣習
使用される拡張バッカス・ノア形式（ABNF）表記は [[RFC5234]] に規定されています。
NFC は Near Field Communications の略で、13.56 MHzで動作する短距離無線技術を指し、
10 cm 未満の距離でデバイス間の通信を可能にします。NFCの通信プロトコルおよびデータ交換フォーマットは、
ISO/IEC 14443 や FeliCa を含む既存の無線周波数識別（RFID）標準に基づいています。
NFC標準には ISO/IEC 18092[5] や NFC Forum が定義するものが含まれます。完全な一覧は
NFC Forum Technical Specifications を参照してください。
NFC adapter は、特定のハードウェア要素（NFCチップ）で実装された NFC 機能へのアクセスを提供する基盤プラットフォーム上のソフトウェア実体です。
デバイスは組み込みのものやUSB経由で接続された複数の NFC アダプタを持つ場合があります。
NFC peer は他のデバイスと相互作用して NFC を用いてデータを交換できる能動的な給電デバイスです。
現在の仕様では、ピアツーピアはサポートされていません。
NFC device は NFC peer または NFC tag のいずれかです。
NDEF は NFC Forum Data Exchange Format の略で、[[!NFC-NDEF]] に標準化された
軽量のバイナリメッセージ形式です。
NDEF message は1つ以上のアプリケーション定義の NDEF record をカプセル化します。
NDEF メッセージは NFC tag に保存されたり、NFC対応デバイス間で交換されたりします。
用語 NFC content は NFC tag へ送信または受信される全てのバイトを指します。
現在の API ではこれは NDEF message と同義です。
例
本セクションでは、開発者が本仕様のさまざまな機能をどのように利用できるかを示します。
機能サポート
Web NFC がサポートされているかどうかの検出は {{NDEFReader}} オブジェクトをチェックすることで行えます。
ただし、これは NFC ハードウェアが利用可能であることを保証するものではありません。
if ("NDEFReader" in window) { /* Scan and write NDEF Tags */ }
データ書き込みに関する一般情報
データの書き込みは概して簡単ですが、NFC での書き込みの仕組みに関していくつか注意点があります。
NFC リーダーはポーリングで動作するため、タグに書き込んだり恒久的に読み取り専用にするには、
まずタグが見つかって読み取られる必要があり、つまりポーリングを初期化する必要があります。
既に `scan()` を呼んでポーリングが開始されていない場合、`write()` と `makeReadOnly()` メソッドは
タグが見つかって読み取られ、操作が試行されるまで一時的にポーリングを開始します。
つまり、フローは最初にタグが見つかったときに読み取りが行われ、その後に書き込み操作が続くということです。
これにより、`scan()` が実行中で `reading` イベントのイベントリスナがある場合、
`write()` や `makeReadOnly()` の操作中にそのイベントが一度発火する可能性があり、
意図した挙動でない場合があります。
以下のセクションではこの挙動に対処する方法を説明しますが、まずは簡単な例をいくつか示します。
テキスト文字列を書き込む
テキスト文字列を NFC タグに書き込むのは簡単です。
const ndef = new NDEFReader();
ndef.write(
"Hello World"
).then(() => {
console.log("Message written.");
}).catch(error => {
console.log(`Write failed :-( try again: ${error}.`);
});
URL を書き込む
URL タイプの NDEF レコードを書き込むには、NDEFMessage を使用します。ここでは async/await を利用します。
const ndef = new NDEFReader();
try {
await ndef.write({
records: [{ recordType: "url", data: "https://w3c.github.io/web-nfc/" }]
});
} catch {
console.log("Write failed :-( try again.");
};
書き込み中の初期読み取りの扱い
書き込むにはタグが見つかって読み取られる必要があります。これにより、既存データやシリアル番号を確認して
実際に書き込みたいタグかどうかを判断することができます。
このため、`write()` は `reading` イベント内から呼び出すことが推奨されます。`makeReadOnly()` についても同様です。
以下の例は共通の `reading` ハンドラと単独の書き込みのために特化したハンドラを調整する方法を示しています。
const ndef = new NDEFReader();
let ignoreRead = false;
ndef.onreading = (event) => {
if (ignoreRead) {
return; // write pending, ignore read.
}
console.log("We read a tag, but not during pending write!");
};
function write(data) {
ignoreRead = true;
return new Promise((resolve, reject) => {
ndef.addEventListener("reading", event => {
// Check if we want to write to this tag, or reject.
ndef.write(data).then(resolve, reject).finally(() => ignoreRead = false);
}, { once: true });
});
}
await ndef.scan();
try {
await write("Hello World");
console.log("We wrote to a tag!")
} catch(err) {
console.error("Something went wrong", err);
}
タイムアウト付きで書き込みをスケジュールする
書き込み操作に時間制限を設けることが有用な場合があります。例えばユーザーにタグをタッチするよう促し、
一定時間内にタグが見つからなければタイムアウトする、という場合です。
const ndef = new NDEFReader();
ndef.onreading = (event) => console.log("We read a tag!");
function write(data, { timeout } = {}) {
return new Promise((resolve, reject) => {
const ctlr = new AbortController();
ctlr.signal.onabort = () => reject("Time is up, bailing out!");
setTimeout(() => ctlr.abort(), timeout);
ndef.addEventListener("reading", event => {
ndef.write(data, { signal: ctlr.signal }).then(resolve, reject);
}, { once: true });
});
}
await ndef.scan();
try {
// Let's wait for 5 seconds only.
await write("Hello World", { timeout: 5_000 });
} catch(err) {
console.error("Something went wrong", err);
} finally {
console.log("We wrote to a tag!");
}
スキャンエラーの処理
この例は {{NDEFReader/scan}} のプロミスが拒否された場合や `readingerror` が発火した場合に何が起きるかを示します。
const ndef = new NDEFReader();
ndef.scan().then(() => {
console.log("Scan started successfully.");
ndef.onreadingerror = (event) => {
console.log("Error! Cannot read data from the NFC tag. Try a different one?");
};
ndef.onreading = (event) => {
console.log("NDEF message read.");
};
}).catch(error => {
console.log(`Error! Scan failed to start: ${error}.`);
});
単一タグを一度だけ読み取る
この例は単一のタグを読み取ってポーリングを停止する便利関数を簡単に作る方法を示し、
不要な作業を減らしてバッテリ寿命を節約します。
この例は指定ミリ秒後にタイムアウトするよう簡単に拡張できます。
const ndef = new NDEFReader();
function read() {
return new Promise((resolve, reject) => {
const ctlr = new AbortController();
ctlr.signal.onabort = reject;
ndef.addEventListener("reading", event => {
ctlr.abort();
resolve(event);
}, { once: true });
ndef.scan({ signal: ctlr.signal }).catch(err => reject(err));
});
}
read().then(({ serialNumber }) => {
console.log(serialNumber);
});
タグからデータを読み、空のタグに書き込む
この例はタグ上に保存できるさまざまな種類のデータを読み取る方法を示します。タグが未フォーマットまたは空のレコードを含む場合、
値 "Hello World" のテキストメッセージを書き込みます。
const ndef = new NDEFReader();
await ndef.scan();
ndef.onreading = async ({ message }) => {
if (message.records.length == 0 || // unformatted tag
message.records[0].recordType == "empty") { // empty record
await ndef.write({
records: [{ recordType: "text", data: "Hello World" }]
});
return;
}
const decoder = new TextDecoder();
for (const record of message.records) {
switch (record.recordType) {
case "text":
const textDecoder = new TextDecoder(record.encoding);
console.log(`Text: ${textDecoder.decode(record.data)} (${record.lang})`);
break;
case "url":
console.log(`URL: ${decoder.decode(record.data)}`);
break;
case "mime":
if (record.mediaType === "application/json") {
console.log(`JSON: ${JSON.parse(decoder.decode(record.data))}`);
}
else if (record.mediaType.startsWith("image/")) {
const blob = new Blob([record.data], { type: record.mediaType });
const img = document.createElement("img");
img.src = URL.createObjectURL(blob);
img.onload = () => window.URL.revokeObjectURL(this.src);
document.body.appendChild(img);
}
else {
console.log(`Media not handled`);
}
break;
default:
console.log(`Record not handled`);
}
}
};
NFC タグでゲーム進捗を保存・復元する
関連するデータソースのフィルタリングはカスタムレコード識別子（この場合 "`/my-game-progress`"）を使用して行えます。
データを読み取ると直ちにカスタム NDEF データレイアウトで書き込みを行いゲーム進捗を更新します。
const ndef = new NDEFReader();
await ndef.scan();
ndef.onreading = async ({ message }) => {
if (message.records[0]?.id !== "/my-game-progress")
return;
console.log(`Game state: ${ JSON.stringify(message.records) }`);
const encoder = new TextEncoder();
const newMessage = {
records: [{
id: "/my-game-progress",
recordType: "mime",
mediaType: "application/json",
data: encoder.encode(JSON.stringify({
level: 3,
points: 4500,
lives: 3
}))
}]
};
await ndef.write(newMessage);
console.log("Message written");
};
JSON を書き込み・読み取り（直列化・逆直列化）
JSON データの保存と受信は、直列化と逆直列化で簡単に行えます。
const ndef = new NDEFReader();
await ndef.scan();
ndef.onreading = (event) => {
const decoder = new TextDecoder();
for (const record of event.message.records) {
if (record.mediaType === "application/json") {
const json = JSON.parse(decoder.decode(record.data));
const article =/^[aeio]/i.test(json.title) ? "an" : "a";
console.log(`${json.name} is ${article} ${json.title}`);
}
}
};
const encoder = new TextEncoder();
await ndef.write({
records: [
{
recordType: "mime",
mediaType: "application/json",
data: encoder.encode(JSON.stringify({
name: "Benny Jensen",
title: "Banker"
}))
},
{
recordType: "mime",
mediaType: "application/json",
data: encoder.encode(JSON.stringify({
name: "Zoey Braun",
title: "Engineer"
}))
}]
});
データを書き込み既存データを出力する
データの書き込みには NFC tag をタップする必要があります。
const ndef = new NDEFReader();
await ndef.scan();
ndef.onreading = async (event) => {
const decoder = new TextDecoder();
for (const record of event.message.records) {
console.log("Record type: " + record.recordType);
console.log("MIME type: " + record.mediaType);
console.log("=== data ===\n" + decoder.decode(record.data));
}
try {
await ndef.write("Overriding data is fun!");
} catch(error) {
console.log(`Write failed :-( try again: ${error}.`);
}
};
NDEF メッセージのリスニングを停止する
{{NDEFScanOptions/signal}} を使用して 3 秒間 NDEF メッセージを読み取ります。
const ndef = new NDEFReader();
const ctrl = new AbortController();
await ndef.scan({ signal: ctrl.signal });
ndef.onreading = () => {
console.log("NDEF message read.");
};
ctrl.signal.onabort = () => {
console.log("We're done waiting for NDEF messages.");
};
// Stop listening to NDEF messages after 3s.
setTimeout(() => ctrl.abort(), 3_000);
スマートポスターメッセージを書き込む
const ndef = new NDEFReader();
const encoder = new TextEncoder();
await ndef.write({ records: [
{
recordType: "smart-poster", // Sp
data: { records: [
{
recordType: "url", // URL record for the Sp content
data: "https://my.org/content/19911"
},
{
recordType: "text", // title record for the Sp content
data: "Funny dance"
},
{
recordType: ":t", // type record, a local type to Sp
data: encoder.encode("image/gif") // MIME type of the Sp content
},
{
recordType: ":s", // size record, a local type to Sp
data: new Uint32Array([4096]) // byte size of Sp content
},
{
recordType: ":act", // action record, a local type to Sp
// do the action, in this case open in the browser
data: new Uint8Array([0])
},
{
recordType: "mime", // icon record, a MIME type record
mediaType: "image/png",
data: await (await fetch("icon1.png")).arrayBuffer()
},
{
recordType: "mime", // another icon record
mediaType: "image/jpg",
data: await (await fetch("icon2.jpg")).arrayBuffer()
}
]}
}
]});
NDEF メッセージをペイロードに含む外部レコードを読み取る
外部タイプレコードはアプリケーション定義のレコードを作成するために使用できます。
これらのレコードはペイロードとして NDEF message を含むことがあり、
アプリケーションのコンテキストで使用される local types を含む独自の NDEF records を持ちます。
smart poster レコードタイプもペイロードとして NDEF message を含む点に注意してください。
NDEF はレコードの順序を保証しないため、関連データをカプセル化する目的で
NDEF message をペイロードに持つ外部タイプレコードを使うことは有用です。
次の例は、テキストレコードと local type "act"（アクション）を含む NDEF message を
ペイロードとして持つソーシャル投稿向けの外部レコードを読み取る方法を示しています。
"act" の定義は smart poster から借用されていますが、ローカルアプリケーションの文脈で使用されます。
const ndef = new NDEFReader();
await ndef.scan();
ndef.onreading = (event) => {
const externalRecord = event.message.records.find(
record => record.type == "example.com:smart-poster"
);
let action, text;
for (const record of externalRecord.toRecords()) {
if (record.recordType == "text") {
const decoder = new TextDecoder(record.encoding);
text = decoder.decode(record.data);
} else if (record.recordType == ":act") {
action = record.data.getUint8(0);
}
}
switch (action) {
case 0: // do the action
console.log(`Post "${text}" to timeline`);
break;
case 1: // save for later
console.log(`Save "${text}" as a draft`);
break;
case 2: // open for editing
console.log(`Show editable post with "${text}"`);
break;
}
};
NDEF メッセージをペイロードに含む外部レコードを書き込む
外部タイプレコードは、ペイロードとして NDEF message を含むようなアプリケーション定義レコードを作成するために使用できます。
const ndef = new NDEFReader();
await ndef.write({ records: [
{
recordType: "example.game:a",
data: {
records: [
{
recordType: "url",
data: "https://example.game/42"
},
{
recordType: "text",
data: "Game context given here"
},
{
recordType: "mime",
mediaType: "image/png",
data: getImageBytes(fromURL)
}
]
}
}
]});
外部レコード内の不明レコードを読み書きする
不明タイプレコードは開発者がその意味を知っている場合、外部タイプレコード内で有用であり、
そのため MIME タイプを指定する必要を避けられます。
const encoder = new TextEncoder();
const ndef = new NDEFReader();
await ndef.write({ records: [
{
recordType: "example.com:shoppingItem", // External record
data: {
records: [
{
recordType: "unknown", // Shopping item name
data: encoder.encode("Food")
},
{
recordType: "unknown", // Shopping item description
data: encoder.encode("Provide nutritional support for an organism.")
}
]
}
}
]});
const ndef = new NDEFReader();
await ndef.scan();
ndef.onreading = (event) => {
const shoppingItemRecord = event.message.records[0];
if (shoppingItemRecord?.recordType !== "example.com:shoppingItem")
return;
const [nameRecord, descriptionRecord] = shoppingItemRecord.toRecords();
const decoder = new TextDecoder();
console.log("Item name: " + decoder.decode(nameRecord.data));
console.log("Item description: " + decoder.decode(descriptionRecord.data));
};
NFC タグを恒久的に読み取り専用にする
NFC タグを恒久的に読み取り専用にすることは簡単です。
const ndef = new NDEFReader();
ndef.makeReadOnly().then(() => {
console.log("NFC tag has been made permanently read-only.");
}).catch(error => {
console.log(`Operation failed: ${error}`);
});
const ndef = new NDEFReader();
try {
await ndef.write("Hello world");
console.log("Message written.");
await ndef.makeReadOnly();
console.log("NFC tag has been made permanently read-only after writing to it.");
} catch (error) {
console.log(`Operation failed: ${error}`);
}
データ表現
The NDEFMessage interface
任意の NDEF message の内容は
NDEFMessage インターフェイスによって公開されます：
[SecureContext, Exposed=Window]
interface NDEFMessage {
constructor(NDEFMessageInit messageInit);
readonly attribute FrozenArray<NDEFRecord> records;
};
dictionary NDEFMessageInit {
required sequence<NDEFRecordInit> records;
};
records
プロパティは list の NDEF record を表し、
NDEF message を定義します。
NDEFMessageInit 辞書は NDEF message を初期化するために使用されます。
The NDEFRecord interface
任意の NDEF record の内容は
NDEFRecord インターフェイスによって公開されます：
[SecureContext, Exposed=Window]
interface NDEFRecord {
constructor(NDEFRecordInit recordInit);
readonly attribute USVString recordType;
readonly attribute USVString? mediaType;
readonly attribute USVString? id;
readonly attribute DataView? data;
readonly attribute USVString? encoding;
readonly attribute USVString? lang;
sequence<NDEFRecord>? toRecords();
};
dictionary NDEFRecordInit {
required USVString recordType;
USVString mediaType;
USVString id;
USVString encoding;
USVString lang;
any data; // DOMString or BufferSource or NDEFMessageInit
};
mediaType プロパティは MIME type を表し、
NDEF record のペイロードの MIME タイプを示します。
recordType プロパティは NDEF record の種類を表します。
id プロパティは
record identifier を表し、
これは絶対または相対の URL です。識別子の一意性は本仕様ではなく生成者によって保証されます。
NFC NDEF 仕様では record identifier の代わりに "message identifier" と "payload identifier" の用語が使われますが、
識別子はメッセージ（レコードの集合）ではなく各レコードに紐付いており、ペイロードが存在しない場合でも含まれる可能性があります。
encoding 属性は、ペイロードがテキストデータである場合に使用される
エンコーディング名（encoding name）を表します。
lang 属性は、エンコードされた場合のペイロードの言語タグ（language tag）を表します。
language tag は [[BCP47]] 仕様で定義された Language-Tag の生成規則に一致する string です
（可能な値の正式な一覧は IANA Language Subtag
Registry を参照してください）。
言語範囲は U+002D ハイフンマイナス ("-") で区切られた 1 つ以上の subtags で構成されます。
例えば 'en-AU' はオーストラリアで話される英語を表し、'fr-CA' はカナダで話されるフランス語を表します。
[[RFC5646]] セクション2.2.9 の有効性基準を満たし、IANA レジストリへの参照なしに検証可能な言語タグは構造的に有効と見なされます。
data プロパティは PAYLOAD field のデータを表します。
toRecords() メソッドは呼び出されたとき、NDEF Record に対して
convert NDEFRecord.data bytes を実行した結果を返さなければなりません。
NDEFRecordInit 辞書は、record type である recordType と、
任意の record identifier id およびペイロードデータ data で
NDEF record を初期化するために使用されます。
NDEFRecordInit のデータ型から NDEF record 型へのマッピングは、
アルゴリズム的な手順で示されており、[[[#steps-receiving]]] および [[[#writing-content]]] セクションで説明されています。
convert NDEFRecord.data bytes を実行するには、
|record:NDEFRecord| が与えられたとき、次の手順を実行してください：
|bytes:byte sequence| を record の data 属性の値とします。
|recordType:record type| を |record| の recordType 属性の値とします。
|recordType| が "`smart-poster`" の場合、|bytes| と `"smart-poster"` を与えて
parse records from bytes を実行した結果を返します。
|recordType| に対して validate external type を実行して true が返る場合、|bytes| と `"external"` を与えて
parse records from bytes を実行した結果を返します。
それ以外の場合、{ "NotSupportedError" } を [= exception/throw =] します。
The record type string
この文字列は NDEFRecord に許可される record types を定義します。
[[[#data-mapping]]] セクションはそれが NDEF record 型にどのようにマッピングされるかを説明します。
標準化された well known type name は次のいずれかです：
The "empty " string
empty な NDEFRecord を表す値。
The "text " string
Text record を表す値。
The "url " string
URI record を表す値。
The "smart-poster " string
Smart poster レコードを表す値。
The "absolute-url " string
absolute-URL record を表す値。
The "mime " string
MIME type record を表す値。
The "unknown " string
unknown record を表す値。
[=well known type names=] に加えて、組織がカスタムの external type name を作成することも可能です。
これはドメイン名とカスタムタイプ名をコロン `U+003A` (`:`) で区切った文字列です。
アプリケーションは local type name を使用することもできます。これは小文字または数字で始まらなければならない文字列で、
NFC Forum の [=local type=] を表します。通常、親レコードのペイロードである NDEFMessage のレコード内で使用されます（例：smart poster）。
local type のコンテキストは、このレコードが属する NDEFMessage のペイロードである親レコードであり、
local type name はそのコンテキストで他の型名と競合しないようにするべきです。
Web NFC の任意の実装はチャンク化されたレコードを単一の論理レコードとして透過的に公開しなければならないため、
unchanged record は明示的に表現されません。
2 つの well-known type records （NFC Forum の local type および global type を含む）は、
文字ごとに大文字小文字を区別して比較しなければなりません。
2 つの external types は文字ごとに小文字・大文字を区別せずに比較しなければなりません。
任意の well-known type record と external type のバイナリ表現は相対 URI（RFC 3986）として書かれなければならず、
それぞれ名前空間識別子 (NID) "`nfc`" と名前空間固有文字列 (NSS) "`wkt`" および "`ext`" を省略します。つまり、
"`urn:nfc:wkt:`" および "`urn:nfc:ext:`" プレフィックスを省略します。
例えば "`urn:nfc:ext:company.com:a`" は "`company.com:a`" として格納され、
Text record の well-known type records は "`urn:nfc:wkt:T`" ですが、"`T`" として格納されます。
データマッピング
[[[#writing-content]]] セクションで使用されるように、NDEFRecordInit のデータ型から
NDEF record 型へのマッピングは次の通りです：
{{recordType}}
{{mediaType}}
{{data}}
record type [=TNF field=]
[=TYPE field=]
"`empty`" unused unused Empty record 0
unused
"`text`" unused
{{BufferSource}} or
[=Well-known type record=]
1
"`T`"
"`url`" unused {{DOMString}}
[=Well-known type record=]
1
"`U`"
"`smart-poster`" unused {{NDEFMessageInit}}
[=Well-known type record=]
1
"`Sp`"
[=local type name=] prefixed by a colon `U+003A` (`:`), e.g., "`:act`", "`:s`", and "`:t`"
unused
{{BufferSource}} or {{NDEFMessageInit}}
[=Local type=] record*
1
[=local type name=], e.g., "`act`", "`s`", and "`t`"
"`mime`" [= MIME type =]
{{BufferSource}}
MIME type record 2
[= MIME type =]
"`absolute-url`" unused {{DOMString}} url
Absolute-URL record 3
[=Absolute-URL=]
[=external type name=] unused
{{BufferSource}} or
External type record 4
[=external type name=]
"`unknown`" unused {{BufferSource}}
[=Unknown record=]
5
unused
* [=local type=] レコードは別のレコードの NDEFMessage ペイロード内に埋め込まれている必要があります。
受信した NDEF message に対して使用されるように、NDEF record 型から NDEFRecord へのマッピングは次の通りです。
record type [=TNF field=]
[=TYPE field=]
{{recordType}}
{{mediaType}}
[=Empty record=]
0
unused "`empty`"
null
[=Well-known type record=]
1
"`T`"
"`text`"
null
[=Well-known type record=]
1
"`U`"
"`url`"
null
[=Well-known type record=]
1
"`Sp`"
"`smart-poster`"
null
[=Local type=] record*
1
[=local type name=], e.g., "`act`", "`s`", and "`t`"
[=local type name=] prefixed by a colon `U+003A` (`:`), e.g., "`:act`", "`:s`", and "`:t`"
null
[=MIME type record=]
2
[=MIME type=]
"`mime`"
The MIME type used in the NDEF record
[=Absolute-URL record=]
3
URL
"`absolute-url`"
null
[=External type record=]
4
[=external type name=]
[=external type name=]
null
Unknown record 5
unused "`unknown`"
null
NDEFReader オブジェクト
NDEFReader は、タグなどのデバイスが磁気誘導フィールド内にあるときに
browsing context に NFC 機能を公開し、NDEF messages を読み取ります。
また、到達範囲内の NFC tag に NDEF messages を書き込むためにも使用されます。
typedef (DOMString or BufferSource or NDEFMessageInit) NDEFMessageSource;
[SecureContext, Exposed=Window]
interface NDEFReader : EventTarget {
constructor();
attribute EventHandler onreading;
attribute EventHandler onreadingerror;
Promise<undefined> scan(optional NDEFScanOptions options={});
Promise<undefined> write(NDEFMessageSource message,
optional NDEFWriteOptions options={});
Promise<undefined> makeReadOnly(optional NDEFMakeReadOnlyOptions options={});
};
[SecureContext, Exposed=Window]
interface NDEFReadingEvent : Event {
constructor(DOMString type, NDEFReadingEventInit readingEventInitDict);
readonly attribute DOMString serialNumber;
[SameObject] readonly attribute NDEFMessage message;
};
dictionary NDEFReadingEventInit : EventInit {
DOMString? serialNumber = "";
required NDEFMessageInit message;
};
NDEFMessageSource は {{NDEFReader/write()}} メソッドが受け付ける引数型を表すユニオン型です。
NDEFReadingEvent は新しい NFC 読み取り時にディスパッチされるイベントです。
serialNumber プロパティは衝突回避と識別に用いられるデバイスのシリアル番号を表し、
利用できない場合は空文字列です。message は NDEFMessage オブジェクトです。
NDEFReadingEventInit は、シリアル番号と message メンバー経由の
NDEFMessageInit データで新規イベントを初期化するために使用されます。
serialNumber が存在しない、または null の場合、空文字列でイベントを初期化します。
ほとんどのタグには安定した一意識別子（UID）がありますが、すべてではなく、読み取りのたびに
ランダムな番号を生成するタグもあります。シリアル番号は通常、`:` で区切られた 4 または 7 個の数値で構成されます。
{{NDEFReader}} オブジェクトは次の
内部スロット を持ちます:
Internal Slot
Initial value
Description (non-normative )
[[\WriteOptions]] null
書き込み用の {{NDEFWriteOptions}} 値。
[[\WriteMessage]] null
書き込まれる {{NDEFMessage}}。
初期状態では未設定です。
onreading は新しい読み取りが利用可能であることを通知するために呼び出される {{EventHandler}} です。
onreadingerror は読み取り中にエラーが発生したことを通知するために呼び出される {{EventHandler}} です。
設定オブジェクトに関連付けられた NFC 状態
NFC をサポートする browsing context の active document の
relevant settings object には、次の 内部スロット を持つ
NFC state レコードが関連付けられています:
Internal Slot
Initial value
Description (non-normative )
[[\Suspended]] false
NFC 機能が suspended かどうかを示すブール値フラグ。初期値は false。
[[\ActivatedReaderList]] empty set
{{NDEFReader}} インスタンスの set 。
[[\PendingWrite]] empty
|promise:Promise| と |writer:NDEFReader| のタプル。|promise| は保留中の {{Promise}} を、
|writer| は {{NDEFReader}} を保持します。
[[\PendingMakeReadOnly]] empty
|promise:Promise| と |writer:NDEFReader| のタプル。|promise| は保留中の {{Promise}} を、
|writer| は {{NDEFReader}} を保持します。
activated reader objects は [[\ActivatedReaderList]] 内部スロットの値です。
pending write tuple は [[\PendingWrite]] 内部スロットの値です。
pending makeReadOnly tuple は [[\PendingMakeReadOnly]] 内部スロットの値です。
NFC is suspended は [[\Suspended]] 内部スロットが true の場合です。
suspend NFC するには、[[\Suspended]] 内部スロットを true に設定します。
resume NFC するには、[[\Suspended]] 内部スロットを false に設定します。
内部スロットは本仕様における記法としてのみ使用され、実装がそれらを明示的な内部プロパティに対応付ける必要はありません。
NFC アダプタの扱い
実装は本仕様で記述されるアルゴリズム手順に従って、複数の NFC adapter を使用してもよい（MAY）ものとします。
権限の取得
Web NFC API は [=default powerful feature=] であり、[=powerful feature/name=] は
"nfc" です。
obtain permission するには、次の手順を実行します:
|state:PermissionState| を、" nfc " で
[=getting the current permission state=] を実行した結果とします。
|state| が {{PermissionState["granted"]}}（すなわち、[[[PERMISSIONS]]] API を用いて
origin および global object に対して権限が付与されている）であれば、true を返します。
それ以外で |state| が {{PermissionState["prompt"]}} の場合、
任意でユーザーに "nfc" の request permission to use を行います。
許可された場合は true を返します。
request permission の手順はまだ明確に定義されていません。
現時点では、UA は与えられた origin と global object に対する "nfc" の
ポリシーについてユーザーに問い合わせ、ユーザーが許可すれば true を返します。
false を返します。
保留中の書き込み操作の中止
abort a pending write operation を試みるには、次の手順を実行します:
pending write tuple |tuple| が存在しない場合、これらの手順を中止します。
|tuple| の writer がすでに進行中の NFC データ転送を開始している場合、これらの手順を中止します。
|tuple| の promise を {{"AbortError"}} で reject し、これらの手順を中止します。
promise を reject すると pending write tuple はクリアされます。
保留中の読み取り専用化操作の中止
abort a pending make read-only operation を試みるには、次の手順を実行します:
pending makeReadOnly tuple |tuple| が存在しない場合、これらの手順を中止します。
|tuple| の writer がすでに NFC タグを恒久的な読み取り専用にしている場合、これらの手順を中止します。
|tuple| の promise を {{"AbortError"}} で reject し、これらの手順を中止します。
promise を reject すると pending makeReadOnly tuple はクリアされます。
NDEFWriteOptions 辞書
dictionary NDEFWriteOptions {
boolean overwrite = true;
AbortSignal? signal;
};
overwrite プロパティの値が false の場合、write アルゴリズム は
NFC tag を読み取り、その上に NDEF レコードがあるかどうかを確認し、
ある場合はいかなる保留中の書き込みも実行しません。
signal プロパティにより、{{NDEFReader/write()}} 操作を中止できます。
NDEFMakeReadOnlyOptions 辞書
dictionary NDEFMakeReadOnlyOptions {
AbortSignal? signal;
};
signal プロパティにより、{{NDEFReader/makeReadOnly()}} 操作を中止できます。
NDEFScanOptions 辞書
dictionary NDEFScanOptions {
AbortSignal signal;
};
signal プロパティにより、{{NDEFReader/scan()}} 操作を中止できます。
Writing content
本セクションは、タイマーが期限切れになる前に、次回近接範囲に入ったときに
NFC tag に NDEF message を書き込む方法を説明します。
任意の時点で、現在のメッセージが送信されるか書き込みが中止されるまで、
1 つの origin につき設定可能な NDEF message は最大 1 つです。
write() メソッド
NDEFReader.write メソッドは、呼び出されたとき、
write a message アルゴリズムを実行しなければなりません:
|p:Promise| を新しい {{Promise}} オブジェクトとします。
現在アクティブな top-level browsing context で実行していない場合、|p| を
{{"InvalidStateError"}} で reject して |p| を返します。
|message:NDEFMessageSource| を第 1 引数とします。
|options:NDEFWriteOptions| を第 2 引数とします。
|signal:AbortSignal| を、存在すれば |options| の同名の辞書メンバー、そうでなければ null とします。
|signal| が [= AbortSignal/aborted =] の場合、|signal| の [=AbortSignal/abort reason=] で |p| を
reject し、|p| を返します。
|signal| が null でない場合、|signal| に
次の中止手順 を追加します:
environment settings object 上で
abort a pending write operation を実行します。
[=promise/React=] to |p|:
|p| が settle（fulfill または reject）された場合、存在すれば
pending write tuple をクリアします。
|p| を返し、次の手順をin parallel に実行します:
obtain permission が false を返す場合、|p| を {{"NotAllowedError"}} で
reject し、これらの手順を中止します。
基盤となる NFC Adapter が存在しない、または接続を確立できない場合、
|p| を {{"NotSupportedError"}} で reject し、これらの手順を中止します。
UA が基盤の NFC Adapter にアクセスすることを許可されていない場合（例: ユーザー設定）、
|p| を {{"NotReadableError"}} で reject し、これらの手順を中止します。
基盤の NFC Adapter がデータのプッシュをサポートしていない場合、
|p| を {{"NotSupportedError"}} で reject し、これらの手順を中止します。
実装は |p| を {{"NotSupportedError"}} で reject してもよく、
これらの手順を中止してもかまいません（MAY）。
UA はこの地点でメッセージ書き込みを中止することがあります。
終了の理由は実装詳細です。例えば、要求された操作をサポートできない場合があります。
|message|、`""`、`0` を与えて create NDEF message を呼び出した結果として、
UA により作成される NDEF message の表記を |output| とします。
これが例外を投げた場合、その例外で |p| を reject し、これらの手順を中止します。
abort a pending write operation を試みます。
書き込みは、それまでに構成された書き込み操作をすべて置き換えます。
`this`.[[\WriteOptions]] を |options| に設定します。
`this`.[[\WriteMessage]] を |output| に設定します。
pending write tuple を (`this`, |p|) に設定します。
NFC tag |device| が通信範囲に入ったときはいつでも、
start the NFC write の手順を実行します。
NFC is suspended の場合、ユーザーによって promise が中止されるか、
NFC tag が通信範囲に入るまで待機を続けます。
start the NFC write するには、次の手順を実行します:
|p:Promise| を pending write tuple の promise とします。
|writer| を pending write tuple の writer とします。
|options:NDEFWriteOptions| を |writer|.[[\WriteOptions]] とします。
近接範囲の NFC tag がフォーマットまたは書き込みのための NDEF 技術を公開しない場合、
|p| を {{"NotSupportedError"}} で reject して |p| を返します。
NFC is not suspended であることを検証します。
成功した場合、次を実行します:
|device| が NFC tag で、|options| の overwrite が false の場合、
タグを読み取り、タグ上に NDEF レコードがあるか確認します。
ある場合、|p| を {{"NotAllowedError"}} で reject して |p| を返します。
|output:NDEFMessage| を |writer|.[[\WriteMessage]] とします。
通信範囲内の NFC adapter を用いて、|output| をバッファとして
|device| へのデータ転送を開始します。
近接範囲の NFC tag が未フォーマットで NDEF フォーマット可能な場合は、
それをフォーマットし、|output| をバッファとして書き込みます。
複数のアダプタはユーザーにより順次使用されるべきです。
異なる複数の接続された NFC adapter で同時にタップが起こる可能性は非常に低いです。
それが起きた場合、成功するまで（望ましくは 1 台ずつ）タップを繰り返す必要があるでしょう。
ここでのエラーは操作を繰り返す必要があることを示します。そうしないと、
すべての接続された NFC adapter で操作が成功したとユーザーが誤解する恐れがあります。
転送が失敗した場合、|p| を {{"NetworkError"}} で reject し、これらの手順を中止します。
転送が完了したら、|p| を resolve します。
Making content read-only
本セクションは、近接範囲内にあるときに NFC tag を恒久的に読み取り専用にする方法を説明します。
任意の時点で、NFC tag が恒久的に読み取り専用にされるか操作が中止されるまで、
1 つの origin につきリクエストは最大 1 件です。
makeReadOnly() メソッド
start the NFC make read-only するには、次の手順を実行します:
|p:Promise| を pending makeReadOnly tuple の promise とします。
近接範囲の NFC tag がフォーマットのための NDEF 技術を公開しない場合、
|p| を {{"NotSupportedError"}} で reject して |p| を返します。
NFC is not suspended であることを検証します。
成功した場合、次を実行します:
通信範囲内の NFC adapter を用いて、|device| を恒久的に読み取り専用にします。
操作が失敗した場合、|p| を {{"NetworkError"}}
で reject し、これらの手順を中止します。
操作が完了したら、|p| を resolve します。
この操作は一方向であり、元に戻すことはできません。
一度 NFC タグを読み取り専用にすると、以後書き込みはできません。
コンテンツのパース
バイト列からのレコードのパース
|bytes:byte sequence| および |context: string| を与えて
parse records from bytes するには、次の手順を実行します:
|bytes| の長さが `0` の場合、null を返します。
|records| を空のリストとします。
|bytes| に未読のバイトがある限り、次のサブ手順を実行します:
残りの |bytes| の長さが `3` 未満の場合、null を返します。
以降のいずれかのステップで残りの |bytes| の長さを超えて読み取る必要がある場合、null を返します。
|ndef| を現在の NDEF record の表記とします。
|header:byte| を |bytes| の次のバイトとします。
|messageBegin:boolean|（MB field ）を |header| の最上位ビット（ビット 7）とします。
これがこれらのサブ手順の最初の反復で、かつ |messageBegin| が false の場合、null を返します。
|messageEnd:boolean|（ME field ）を |header| のビット 6 とします。
チャンク化されたレコードはサブレコードとして許可されないため、ビット 5（CF field ）は無視します。
|shortRecord:boolean|（SR field ）を |header| のビット 4 とします。
|hasIdLength:boolean|（IL field ）を |header| のビット 3 とします。
|ndef| の |typeNameField:number|（TNF field ）を |header| のビット 2〜0 の整数値とします。
|typeLength:number| を |bytes| の次のバイト（TYPE LENGTH field ）の整数値とします。
|shortRecord| が true の場合、|payloadLength:number| を |bytes| の次のバイト
（PAYLOAD LENGTH field ）の整数値とします。
それ以外の場合、|payloadLength| を |bytes| の次の 4 バイトの整数値とします。
|hasIdLength| が true の場合、|idLength:number| を |bytes| の次のバイト
（ID LENGTH field ）の整数値とし、そうでなければ `0` とします。
|typeLength| > 0 の場合、|ndef| の |type:string| を、次の |typeLength| バイト
（TYPE field ）に対して UTF-8 decode を実行した結果とし、
そうでなければ |type| を空文字列とします。
|idLength| > 0 の場合、|ndef| の |id:string| を、次の |idLength| バイト
（ID field ）に対して UTF-8 decode を実行した結果とし、
そうでなければ |ndef| の |id| を空文字列とします。
|ndef| の |payload| を、最後の |payloadLength| バイト
（PAYLOAD field ）の byte sequence とし、`0` バイトであってもよいものとします。
|record:NDEFRecord| を、|ndef| と |context| を与えて
parse an NDEF record を実行した結果とします。
|record| が null でない場合、|records| に |record| をappend します。
|messageEnd| が true の場合、
|records| と |context| を与えて check parsed records を実行し、
|error| を投げた場合、|promise| を |error| で reject し、これらの手順を中止します。
それ以外の場合、これらのサブ手順を終了します（ループを終了）。
|records| を返します。
パース済みレコードの検査
|records: NDEFRecord sequence| および |context: string| を与えて
check parsed records するには、次の手順を実行します:
|context| が `"smart-poster"` で、|records| がちょうど 1 つの URI record を含まない場合、
または複数の type record 、size record 、action record を含む場合、
{{TypeError}} を [= exception/throw =] します。
それ以外の場合は true を返します。
NDEF well-known `T` レコードのパース
|ndefRecord| を与えて
parse an NDEF text record を |record:NDEFRecord| に行うには、
次の手順を実行します:
|record| の recordType を "`text`" に設定します。
|record| の mediaType を null に設定します。
|ndefRecord| の PAYLOAD field が存在しない場合、
|record| の data を null に設定して |record| を返します。
|header:byte| を |ndefRecord| の PAYLOAD field の最初の byte とします。
|languageLength:octet| を、|header| のビット `5` からビット `0` の値とします。
|language:string| を、2 バイト目から |languageLength| + `1` バイト目までを
ASCII decode した結果とします。
|buffer:byte sequence| を、|ndefRecords| の PAYLOAD field の残り
（|header| と |languageLength| バイト分を除く）の byte sequence とします。
|record| の lang を |language| に設定します。
|record| の encoding を、|header| のビット `7` が `0` の場合は "`utf-8`"、
それ以外は "`utf-16be`" に設定します。
|record| の data を |buffer| に設定します。
|record| を返します。
Unicode 標準は UTF-8、UTF-16、UTF-32 など複数のエンコーディングを定義しています。
UTF-8 はウェブで推奨されるエンコーディングであり、[=code points=] が単一バイトで表現されるため、
エンディアンに依存しない利点があります。
NDEF のテキストレコードは、テキストを UTF-8 または UTF-16 のいずれかでエンコードできます。
一般にウェブでは UTF-8 の使用が推奨されますが、既存システムとの統合のために UTF-16 が必要な場合もあります。
データ伝送順序、すなわち NDEF のバイトオーダは [[[NFC-NDEF]]] でビッグエンディアン（BE）と定義されており、
すべてがビッグエンディアンのバイト順序で読み戻されます。
UTF-16 の場合、各 [=code point=] が 2 バイトにまたがるため、読み書き間でバイト順序が異なる可能性があり、
バイト順序は重要です。このため UTF-16 でエンコードされたテキストには通常バイトオーダマーク（BOM、`0xFEFF`）が含まれます。
ホストマシンと NDEF でバイト順序が異なる場合、値は `0xFFFE` として読み戻され、
バイト順序を入れ替える必要があることを示します。[[[ENCODING]]] ではバイト順序に応じて
UTF-16 を UTF-16BE（ビッグエンディアン）と UTF-16LE（リトルエンディアン）に区別します。
バイトオーダマークが存在しない場合は、UTF-16BE エンコーディングを仮定すべきです。
decoder を `encoding` を `utf-16` に設定して使用すると、
バイトオーダマークが存在する場合に自動的にバイトの入れ替えを検出します。
バイトオーダマークがない場合にビッグエンディアンとして読み取るには `utf-16be` を使用できます。
encoder を使用する場合、UTF-8 にのみエンコード可能です。
したがって UTF-16 が必要な場合は、手動で、またはライブラリを用いてエンコードする必要があります。
NDEF well-known `U` レコードのパース
|ndefRecord| を与えて
parse an NDEF URL record を |record:NDEFRecord| に行うには、
次の手順を実行します:
|record| の recordType を "`url`" に設定します。
|record| の mediaType を null に設定します。
|ndefRecord| の PAYLOAD field が存在しない場合、
|record| の data を null に設定して |record| を返します。
|buffer:byte sequence| を、|ndefRecords| の PAYLOAD field の
byte sequence とします。
|prefixByte:byte| を、|buffer| の最初の byte の値とします。
|prefixByte| の値が [[[NFC-STANDARDS]]] の URI Record Type Definition 仕様
セクション 3.2.2 表 3 の URL 展開コードに一致する場合、
|prefixString:string| を、|prefixByte| の値に対応する
byte sequence の値とします。
|record| の data を、|prefixString| に |buffer| を連結したものに設定します。
それ以外で |prefixByte| に一致がない場合、|record| の data を |buffer| に設定します。
|record| を返します。
NDEF well-known `Sp` レコードのパース
|ndefRecord| を与えて
parse an NDEF smart-poster record を |record:NDEFRecord| に行うには、
次の手順を実行します:
|record| の recordType を "`smart-poster`" に設定します。
|record| の mediaType を null に設定します。
|ndefRecord| の PAYLOAD field が存在しない場合、
|record| の data を null に設定して |record| を返します。
|buffer:byte sequence| を、|ndefRecords| の PAYLOAD field の
byte sequence とします。
|record| の data を |buffer| に設定します。
|record| を返します。
アプリケーションは data に対して toRecords() を呼び出して
NDEF records にパースするか、自身でパースしてもかまいません。
|ndefRecord| を与えて
parse a smart-poster size record を |record:NDEFRecord| に行うには、
次の手順を実行します:
|record| の recordType を "`:s`" に設定します。
|record| の mediaType を null に設定します。
|ndefRecord| の PAYLOAD field がちょうど 4 バイトでない場合、
{{TypeError}} を [= exception/throw =] します。
|buffer:byte sequence| を、|ndefRecords| の PAYLOAD field の
byte sequence とします。
|record| の data を |buffer| に設定します。
アプリケーションはこの値を、smart-poster 内の URI レコードが参照する
オブジェクトのサイズを示す 32 ビット符号なし整数としてパースできます。
|record| を返します。
|ndefRecord| を与えて
parse a smart-poster type record を |record:NDEFRecord| に行うには、
次の手順を実行します:
|record| の recordType を "`:t`" に設定します。
|record| の mediaType を null に設定します。
|buffer:byte sequence| を、|ndefRecords| の PAYLOAD field の
byte sequence とします。
アプリケーションはこの値を、smart-poster 内の URI レコードが参照する
オブジェクトのメディアタイプを示す [[RFC2048]] メディアタイプを含む文字列としてパースできます。
|record| の data を |buffer| に設定します。
|record| を返します。
|ndefRecord| を与えて
parse a smart-poster action record を
|record:NDEFRecord| に行うには、次の手順を実行します:
|record| の recordType を "`:act`" に設定します。
|record| の mediaType を null に設定します。
|ndefRecord| の PAYLOAD field がちょうど 1 バイトでない場合、
{{TypeError}} を [= exception/throw =] します。
|buffer:byte sequence| を、|ndefRecords| の PAYLOAD field の
byte sequence とします。
|record| の data を |buffer| に設定します。
アプリケーションはこの値を 8 ビット符号なし整数としてパースでき、その値は
ここ で定義されています。
|record| を返します。
ローカルタイプレコードのパース
|ndef| を与えて
parse a local type record を |record:NDEFRecord| に行うには、
次の手順を実行します:
|record| の recordType を "`:`"（`U+003A`）に |ndef| の |type:string| を連結したものに設定します。
|record| の mediaType を null に設定します。
|buffer:byte sequence| を、|ndefRecords| の PAYLOAD field の
byte sequence とします。
|record| の data を |buffer| に設定します。
|record| を返します。
NDEF MIME タイプレコードのパース
|ndefRecord| を与えて
parse an NDEF MIME type record を |record:NDEFRecord| に行うには、
次の手順を実行します:
|record| の recordType を "`mime`" に設定します。
|record| の mediaType を、|mimeType| を入力として
serialize a MIME type を実行した結果に設定します。
|buffer:byte sequence| を、存在する場合は |ndefRecords| の PAYLOAD field の
byte sequence 、そうでなければ null とします。
|record| の data を |buffer| に設定します。
|record| を返します。
NDEF absolute-URL レコードのパース
|ndefRecord| を与えて
parse an NDEF absolute-URL record を
|record:NDEFRecord| に行うには、次の手順を実行します:
|record| の recordType を "`absolute-url`" に設定します。
|record| の mediaType を null に設定します。
|buffer:byte sequence| を、|ndefRecords| の TYPE field の
byte sequence とします。
|record| の data を |buffer| に設定します。
|record| を返します。
NDEF 外部タイプレコードのパース
|ndefRecord| を与えて
parse an NDEF external type record を
|record:NDEFRecord| に行うには、次の手順を実行します:
record の |ndefRecord| の TYPE field に対して [=validate external type=] を実行して
false を返す場合、null を返します。
|domain| と |type| を、|ndefRecord| の TYPE field の値に対して
[=split external type=] を実行した結果とします。
|domain| を、
Unicode ToUnicode を
|domain_name| に |domain|、|CheckHyphens| に false、|CheckBidi| に true、
|CheckJoiners| に true、|UseSTD3ASCIIRules| に true、|Transitional_Processing| に false を
それぞれ設定して実行した結果とします。結果にエラーが含まれる場合、null を返します。
TYPE field には ASCII として保存されたドメイン部分が含まれるため、
例えば "xn--hndvrker-9zan.dk:abc" は上記の変換後に "håndværker.dk:abc" として提示されます。
|record| の recordType を、|domain|、"`:`"、|type| を連結したものに設定します。
|record| の mediaType を null に設定します。
|buffer:byte sequence| を、存在する場合は |ndefRecords| の PAYLOAD field の
byte sequence 、そうでなければ null とします。
|record| の data を |buffer| に設定します。
|record| を返します。
NDEF 不明タイプレコードのパース
|ndefRecord| を与えて
parse an NDEF unknown record を |record:NDEFRecord| に行うには、
次の手順を実行します:
|record| の recordType を "`unknown`" に設定します。
|record| の mediaType を null に設定します。
|buffer:byte sequence| を、存在する場合は |ndefRecords| の PAYLOAD field の
byte sequence 、そうでなければ null とします。
|record| の data を |buffer| に設定します。
|record| を返します。
セキュリティとプライバシー
信頼の連鎖
実装は、ユーザーが Web NFC API の一部であるメソッドを許可したときに、副作用なくそのアクションのみが実行されることを保証する必要があります。
既定では、NDEF は、データを書き込んだ後にタグを恒久的な読み取り専用にできることを除いて、コンテンツを信頼できるようにする手段を提供しません。
これは工場出荷時設定からでも可能です。
この API によって書き込まれるデータは自動的に署名や暗号化はされず、これは既存のネイティブ NFC API に従います。
NDEF メッセージの完全性と真正性を保護するために、NFC Forum は [[NDEF-SIGNATURE]] を導入しました。
NDEF signature と鍵管理の使用はアプリケーションの責任です。
NFC 経由で交換されるデータの機密性 を信頼するため、アプリケーションは暗号化された
NFC content を使用しても構いません。
NFC 経由で交換されるデータの完全性 を信頼するため、アプリケーションは PKI（公開鍵基盤）に基づく鍵管理とともに
NDEF signature を使用しても構いません。
一般的な MIME タイプに関するセキュリティ上の考慮事項は [[RFC2048]] および [[RFC2046]] で議論されています。
プライバシーへの影響と実装上の考慮事項
NFC タグは、バーコードや QR コードと同様に、人間が読めない方法でデータを交換する別の手段であり、それらを共有することは、
予期しないプライバシーおよびセキュリティ上の影響をもたらす可能性があります。ウェブサイトが QR コードを読み取るには、
画像を取得して、その画像の内容（QR コードを含む）がウェブページで利用可能になることを明確に示す中断的な UI（カメラ）を
使用する必要があり、ユーザーにスキャンが行われていることを明確にします。
NFC でタグをスキャンするには、ユーザーがスキャンデバイス（例: 携帯電話）を NFC タグに近接（通常 5〜10cm、2〜4 インチ）
させる必要があります。
Web NFC のスキャンがアクティブでないときにタグをスキャンすると、ホスト OS の処理がトリガーされます。
したがって、NFC タグのスキャンから URL やアプリを起動することは Web NFC 自身では処理もサポートもされません。
さらに、Web NFC のスキャンはユーザー操作から有効化される必要があり、サイトがフォーカスされていない場合や
デバイスの画面が消灯（すなわちロック解除されていない）したときにはスキャンは一時停止されます。
これは、偶発的なスキャンが起こりにくいようにするためです。
Web NFC はさらに、スキャンデバイスを NFC タグに近づけたときにデータがスキャンされることを UX 上ユーザーに非常に明確に示すことを
実装に推奨します。基本的には QR コードのスキャンの UX フローを模倣します。
そのための方法は多数あります。例えば音を鳴らす、スキャン中に永続的な UI を表示する（任意の時点でキャンセルできるモーダルダイアログなど）。
実装は、アップロードしようとしているデータを表示し、ユーザーが承認するまで共有を延期し、どのレコードを共有するかをユーザーが選択できる
UI を表示することもできます。
スキャン中の読み取りと書き込み
ユーザーがタグをスキャンすると、その時点でウェブアプリケーションはタグ上のデータを読み取るアクセス権を持ち、
読み取り専用でない場合はタグにデータを書き込むこともできます。私的利用向けの市販ステッカー（例: メイカーコミュニティ）では
しばしばロックされておらず（読み取り＋書き込み）、商用展開の NFC は読み取り専用であるのが一般的です。
以前のプロトコル SNEP（Simple NDEF Exchange Protocol）は、能動デバイス（例: 携帯電話）が別の能動デバイスから
NDEF データを受信することを可能にしていましたが、Web NFC ではサポートされておらず、サポートされているネイティブプラットフォームでも
現在廃止されつつあります。
より新しいプロトコル TNEP（Tag NDEF Exchange Protocol）は、スキャナデバイス（例: 携帯電話）と能動的に給電された
IoT デバイスの間で双方向通信を可能にします。これは現時点では Web NFC でサポートされておらず、また受け入れる入力に制限があり、
IoT デバイスは受け付けるレコードが有効であることを保証しなければなりません。
タグがプライバシーに敏感なデータを含む場合、そのようなデータはサイトと共有されます。UX がデータ交換の前にユーザーによる確認を
要求する場合は、すぐには共有されない可能性もあります。
場合によっては、タグ／デバイスがプライバシーに敏感なデータを含むことが明らかなこともあります。例えば NFC 対応の会議バッジや
名刺の場合です。これは、あなたや近親者が糖尿病患者であることを示しうる、NFC 対応のグルコースメータでも同様です。
他の場合には起こりうることが明確でないかもしれませんが、ユーザーがタグにデータを書き込むアプリやウェブサイトを使用し、
ユーザーの知らないうちにユーザー ID などをエンコードしてしまい、その後別のサイトが読み戻せることがあります。
私的で予期しないデータは、ファイル（例: ワープロ文書、PDF、カメラ画像）にも保存され、ファイルアップロード API を使って
アップロードされることがあります。Web NFC API に関連する緩和策は、ファイルアップロードに関連するものよりも強力であり、
個人を特定できる可能性はより低くなります。
スキャン中の読み取りと書き込み
タグのスキャンは、ウェブサイトがタグを識別する方法を知っており、かつ現実世界でのタグの位置を知っている場合（例えば博物館内に
設置されているなど）、ユーザーの位置を明らかにすることがあります。また、FeliCa NFC タグは主に日本で使用されている等の理由から、
ある程度推測できるかもしれませんが、Web NFC は使用されているタグ技術を明らかにはしません。
これは、ユーザーのアクションを必要とし、バックグラウンドでトリガーされないため、ウェブの広告およびトラッキングモデルを
現実世界に持ち込むものではありません。適切な UX によって、スキャンがアクティブであることが明確になるべきです。
既存データの上書き
NFC タグに書き込むとタグを壊してしまう、いわゆる「文鎮化（brick）」してしまうのではないかという懸念もあります。
NFC タグは複数のユーザーアプリケーションによって読み取られるように設計されており、NDEF タグは簡単に恒久的な読み取り専用にできるように
設計されています。これは工場出荷時の設定でそのように構成することもできます。
NDEF はデータの読み書きのための単純な交換フォーマットであり、双方向通信のためのものではありません。NFC は下位技術に基づく複数の
通信フォーマットをサポートしており（そのため NDEF のように読み取り専用にロックされていません）が、これらはいずれも Web NFC では
サポートされていません。
NFC 利用時にユーザーが認識すべき事項
本節では、NFC の使用時にユーザーが認識すべき事項のいくつかを詳述します。実装は、関連する NFC アクションが実行される前または実行時に、
これらの事実をユーザーに教育するのを助けることが推奨されます。
読み取られたデータはサイトと共有される
サイトが NFC コンテンツを読み取るアクセス権を持っている場合、スキャンされたタグのデータは、ファイルや画像をアップロードする場合と
同様にサイトと共有されます。どのサイトでも同じですが、そのデータを適切かつ意図した方法で扱うかどうかはユーザーの信頼に委ねられます。
読み取り専用でないタグのデータはサイトによって変更・上書きされ得る
店舗内のタグなど、展開された NFC ソリューションは、誤って、または悪意ある行為の一環として変更されないよう、常に読み取り専用に
すべきです。
私用のタグやステッカーは工場出荷時にロック解除（書き込み可能）されていることが多く、そのようなタグはスキャンによって上書き／変更される
可能性があることをユーザーは認識すべきです。
固定（例: 設置）タグの読み取りは読み取り位置を露出し得る
固定タグは、そのデータ内に ID や位置をエンコードしている場合があり、そのため、タグの物理的な位置を把握しているサイトにその情報が
露出し、読み取りが行われた位置を推定できることがあります。これがサービスへのログインと組み合わさると、あなたの位置情報をサイトと
共有してしまう可能性があります。
書き込まれたデータは、読み取りアクセス権が付与された他のアプリやサイトから読み取れます。
タグ上の任意の NDEF データは、適切なアクセスを持つ任意のアプリやウェブサイトによって読み取られます。
その意図がない場合は、想定された読者のみが読み取れるように、データを安全な方法で暗号化すべきです。
同時に複数のタグが読み取りフィールド内に存在し得る
NFC は一度に 1 つのタグしか読み取れませんが、複数のタグを検出でき、そのうち 1 つを通信対象のタグとして選択できます。
このユースケースは、財布の中に複数のスマートカード（NFC ベース）があり、カードを取り出したくない場合などが考えられます。
これは主に外部ハードウェアによって読み取られる決済カードや交通系カードに有用であり、Web NFC のユースケースではありません。
Web NFC では、以下の攻撃ベクトルを防ぐため、複数のタグが利用可能な場合の読み取りを許可しません。
誰かが正規のタグの上に悪意のある NFC タグ／ステッカーを重ねて貼り、誤ったアプリ／サイトを読み込ませたり、
正しいアプリ／サイトに誤ったデータを注入したりする攻撃ベクトルがあります。これは、元のタグのデータをクローンして変更することで
実行できます。例えば URL を変更して悪意のあるアプリ／サイトを読み込ませる、あるいは正しいアプリ／サイトに悪意のあるデータを
注入するなどです。例: タグは本来 https://example.com に誘導するはずが、
https://exаmple.com（キリル文字の а を使用）に変更される——見た目は正規に見え、
機微なデータを悪意のあるサイトに渡してしまうかもしれません。
タグからウェブサイトを読み込むことは Web NFC の範囲外ですが、上記の攻撃ベクトルのため、複数のタグが利用可能な場合に
ユーザーエージェントが URL を自動読み込みしないことが推奨されます。
複数のタグが利用可能なときに読み取りを禁止することで、Web NFC はサイトへの誤／悪意あるデータ注入に対して十分に保護します。
既存の NFC タグを遮蔽することは容易ではなく、目立つフェライトシールドが必要となるためです。金属は磁場に干渉し、
タグを読み取れなくします。
セキュリティポリシー
本節は実装に関する規範的なセキュリティポリシーを列挙します。
可視のドキュメント
Web NFC の機能は、top-level browsing context の {{Document}} のうち、
その {{Document/visibilityState}} が `"visible"` の場合に限り許可されます。
これはまた、表示がオフである、またはデバイスがロックされている場合、UA は NFC 無線へのアクセスをブロックすべきであることを意味します。
バックグラウンドのウェブページについては、NFC content の受信および書き込みは
suspended でなければなりません（MUST）。
ブロックリスト
Web NFC には、ウェブサイトがそれらを悪用するのを防ぐための脆弱な NFC デバイスの
blocklist が含まれます。
物理的な位置漏えいのリスクの警告
NFC content のリッスンおよび書き込み時に、与えられた origin が物理的位置を推測できる可能性について、
UA はユーザーに警告しても構いません（MAY）。
自動処理の制限
NFC content 上のペイロードデータが信頼できない場合、ユーザーが承認しない限り、
UA はそのコンテンツの自動処理（NFC tag 内の URL を用いたウェブページのオープン、アプリのインストール、
その他のアクションなど）に使用してはなりません（MUST NOT）。
次のポリシーは、アプリケーションによる実装が推奨されます。
