Comment on page
NFC リーダー
このプラグインでは次の機能を提供します。
- タグIDの読み取り
- NFCタグに割り当てられた固有のIDを読み取ることができます。
- ブロックデータ読み取り(FeliCaのみ)
- FeliCaのブロックデータを読み取ることができます。
- Cordova 11.0.0 以降
- Cordova iOSプラットフォーム 6.2.0 以降
- Swift 4 以降 (5 以降推奨)
- Androidは非対応
- iOS 13 以降
- iPhone 7 以降
- NFC Type A (Mifare[^2])
- NFC Type F (FeliCa)
monaca.NfcReader.readId(successCallback, failCallback, args)
NFCタグのIDを読み込みます。
Type A: UID / Type F: IDm NFC Type Bには対応していません。
successCallback(result)
result: 以下のデータが返されます。
{
"type": "typeA", // NFCタグの種類 (typeA / typeF)
"id": "xxxxxxxxxx", // NFCタグのID
"cancelled": false // 読み取りがキャンセルされたかどうか
}
- idは16進数文字列です。
- idの桁数はNFCタグの種類によって変わります。
- FeliCaではアプリケーションに指定されたシステムコード(後述)に対応するIDが返ります。
- プラグインのデフォルトではシステムコード=
0003のカードに設定されています。 - システムコードを変更したい場合は、後述のシステムコードの指定を参照してください。
failCallback
failCallback(error)
error: エラーメッセージ(文字列)
エラーの内容はエラーメッセージ参照
args
{
"message" : "NFCタグをスマートフォンに近づけてください"
}
parameter | type | optional | default value | description |
|---|---|---|---|---|
message | string | YES | "Bring the NFC tag closer to your Smartphone" | 検出中のUIに表示されるメッセージ文字列 |
例
monaca.NfcReader.readId((result) => {
if (result.cancelled) {
// cancelled
} else {
// success
const detected_id = result.id;
const detected_type = result.type;
}
}, (error) => {
// error
const error_message = error;
}, {
"message" : "NFCタグをスマートフォンに近づけてください"
});
monaca.NfcReader.readBlockData(successCallback, failCallback, args)
FeliCaのブロックデータを読み込みます。
successCallback(result)
result: 以下のデータが返されます。
{
"type": "typeF", // NFCタグの種類 (typeF)
"id": "xxxxxxxxxx", // NFCタグのID
"cancelled": false, // 読み取りがキャンセルされたかどうか
"data": [n][16] // blockData[n][16] 1ブロック=16byte x n(n: 0 .. count-1)
}
- 指定したサービスコード・システムコード(後述)に対応するIDおよびブロックデータが返ります。
failCallback(error)
error: エラーメッセージ(文字列)
エラーの内容はエラーメッセージ参照
args
{
"service_code" : [ 0x09, 0x0f ], // サービスコード
"start" : 0, // 読み取り開始インデックス
"count" : 12, // 読み取りブロック数 (count <= 12)
"message" : "NFCタグをスマートフォンに近づけてください"
}
parameter | type | optional | default value | description |
|---|---|---|---|---|
service_code | array(byte[2]) | NO | - | サービスコード |
start | int | NO | - | 読み取り開始インデックス (0 <= start < 20) |
count | int | NO | - | 読み取りブロック数 (count <= 12) |
message | string | YES | "Bring the NFC tag closer to your Smartphone" | 検出中のUIに表示されるメッセージ文字列 |
- 指定したサービスコード(後述)に対応するデータが返ります。
- サービスコードは１つのみ対応しています。複数のサービスコードを指定することはできません。
- システムコードを指定したい場合は、後述のシステムコードの指定を参照してください。
- FeliCaのブロックデータは最大20個です。
- 一度に読み取れるブロックデータ数は12個までです。
- count <= 12
- start + count <= 20
例
monaca.NfcReader.readBlockData((result) => {
if (result.cancelled) {
// cancelled
} else {
// success
const detected_id = result.id;
const detected_type = result.type;
const blockData = result.data;
// convert block data to traffic IC history
const history = blockData.map(block => {
return monaca.NfcReader.convertToHistory(block);
});
}
}, (error) => {
// error
const error_message = error;
}, {
"service_code" : [ 0x09, 0x0f ],
"start" : 0, // start index
"count" : 12, // count
"message" : "NFCタグをスマートフォンに近づけてください"
});
message | description |
|---|---|
"Invalid Arguments" | 引数指定のエラー |
"NFC Not Available" | NFCが使用できない |
"NFC Connection Error" | NFC接続時のエラー |
"Feature Not Supported" | 対応していない機能の呼び出し(typeA + readBlockData etc.) |
"Unsupported NFC Tag is detected" | 未対応のNFCタグの検出 |
"Request Service Error" | サービスコードの指定エラー |
"Read Block Data Error" | ブロックデータ読み込みエラー |
"Read Block Data Error: Invalid Status Code" | ブロックデータ読み込み ステータスコード異常 |
"NFC Session timed out" | NFC読み取りタイムアウト |
"Unhandled NFC error" | その他のNFCエラー |
プラグインの使用にはアプリケーションの
config.xmlに以下の設定を追加する必要があります。- Swiftバージョンの指定(必須)
- システムコードの指定(任意)
このプラグインはSwiftで書かれています。 アプリケーションの
config.xml にてSwiftのバージョンを指定する必要があります。 config.xmlに以下の記述を追加してください。<platform name="ios">
<preference name="SwiftVersion" value="5"/>
</platform>
プラグイン にデフォルトで指定されているFeliCaシステムコードは
0003です。 このコードを変更もしくは追加したい場合は、以下のいずれかの方法で設定してください。
- 1.MonacaクラウドIDEから
設定 → Cordova プラグインの管理を選択します。 - 2.NFCリーダープラグインの設定ボタンをクリックします。
- 3.インストールパラメータ の欄に以下のように値を設定してください。
0003をfe00に変更する場合：SYSTEM_CODES=fe00
Cordova CLIからプラグインを使用する場合は、プラグイン追加時に
variableオプションで値を指定してください。# '0003'を'fe00'に変更する場合
cordova plugin add @monaca/monaca-plugin-nfc-reader --variable SYSTEM_CODES=fe00
FeliCaにおいて、事業者や使用目的ごとに割り当てられたコードをシステムコードと呼びます。
FeliCaカードを採用しているサービスごとに異なるシステムコードが割り当てられています。
また、FeliCaカードでは１枚のカードの中に複数のシステム領域を持つことができます。 この場合、１枚のカード内には複数のシステムコードが存在します。ID(IDm)はシステム領域ごとに割り当てられています。 対象のIDを取得するにはシステムコードの指定が必要となります。 このプラグインの現在のバージョンではシステムコードは１つのみ対応しています。
iOSアプリケーションでは対応するシステムコードを
*.plistファイルに指定しておく必要があります。 この設定方法については前述のシステムコードの指定を参照してください。FeliCaのシステム領域の中には、サービスと呼ばれる領域が存在します。複数のサービス領域が存在し、その中にブロックデータが格納されています。 どのサービス領域のブロックデータを取得するか特定するためにサービスコードが用いられます。
ブロックデータの取得にはシステムコードとサービスコードの両方が必要です。
プラグインの対応状況
- このプラグインの現在のバージョンではシステムコードは１つのみ指定可能です。
readId(),readBlockData()ともに、システムコードで指定された１つのシステム領域からの読み込みに対応しています。readBlockData()では１つのサービスコードで指定されたサービス領域からのブロックデータの読み込みに対応しています。
ブロックデータの活用方法の１つとして、交通系ICカードの利用履歴の読み取りが挙げられます。 このプラグインでは参考としてブロックデータから利用履歴への変換メソッドを提供しています。
/**
* Convert blockData to traffic history
* @param {int[16]} blockData
* @return {object} traffic history object
*/
monaca.NfcReader.convertToHistory(blockData)
traffic history object:
{
"year": 2022, // 年
"month": 11, // 月
"day": 1, // 日
"boarding_station_code": [xxx, xxx], // 乗車駅(2byte)
"exit_station_code": [xxx, xxx], // 降車駅(2byte)
"balance": 1000 // 残高
}
使用例
monaca.NfcReader.readBlockData((result) => {
if (result.cancelled) {
} else {
const history = result.data.map(block => {
return monaca.NfcReader.convertToHistory(block);
});
}
}, (error) => {
}, {
// (略)
});
注意
交通系ICのデータ形式は公表されていません。
convertToHistoryの処理は独自の調査結果により実装されています。 このメソッドに関してはあくまでも参考程度として、以下の方針のもと提供させて頂きます。- 全ての交通系ICカードに対応しているものではありません。
- 一般的な交通系ICカードの列車の乗降履歴のみに対応しています。
- それ以外の乗り物や買い物の履歴などはデータ形式が異なるケースがあり対応していません。
- このメソッドに関しての一切の動作保証は致しかねます。
- 今後のバージョンでの提供や互換性に関しても未定となります。
- FeliCaはソニー株式会社の登録商標です。
- このドキュメント内に記載されたFeliCaおよびそれに関する技術 用語はソニー株式会社様により公開されている技術資料を基に構成されています。
- システムコード、サービスコード等の数値は、対応するカード・サービスの事業者様より提供を受けた上でご利用ください。
1: FeliCa はソニー株式会社の登録商標です。 FeliCa はソニー株式会社が開発した非接触ICカードの技術方式です。
2: Mifare はNXPセミコンダクターズN.V.の登録商標です。
最終更新 11mo ago