applican

マイページに戻る

NFC

NFCタグを読み取り、情報を取得します。
※Androidのみ使用可能です。

機能

利用用途

NFCタグを読み込みたい場合は、こちらの機能をご利用ください。

【対応ランタイムバージョン】

ランタイムのバージョン毎に最適化したサンプルをダウンロードしてご使用ください。

サンプル NFC
サンプル NFC
サンプル NFC
サンプル NFC
サンプル NFC
サンプル NFC
サンプル NFC
サンプル NFC

メソッド

NfcError

NFC APIのメソッド実行時にエラーが発生した場合のエラー情報です。

プロパティ

code : Number 下記定数と一致する何れかのエラーコードです。
nfcError.NO_NFC_FEATURE:1 NFCが使えない端末または、NFC非搭載の端末です。
nfcError.PERMISSION_NOT_GRANTED:2 NFCの権限が許可されていません。
nfcError.NOT_INITIALIZED:3 init()が呼び出されていません。
nfcError.NOT_FOREGROUND:4 アクティビティは現在フォアグラウンドにありません。
nfcError.NFC_DISABLED:5 NFCのアダプターが無効です。
nfcError.UNSUPPORTED_OS:6 サポート対象外のOSです。

init

メソッド説明

init(Function successCallback, Function<NfcError> errorCallback)

NFC APIの初期化を行います。このメソッドを呼び出さないと、以降のメソッドは全て失敗します。

パラメータ

successCallback : Function 初期化に成功した場合にCallbackされます。
errorCallback : Function 初期化に失敗した場合にCallbackされます

Return

void

サンプルコード

applican.nfc.init(successCallback, errorCallback);

function successCallback() {
  alert("Success: init”);
}

function errorCallback(error){
  var dump = “Failed: init¥n”;
  dump += "code:" + error.code + "¥n";
  alert(dump);
}

startNfcReaderTag

メソッド説明

startNfcReaderTag(Function messageCallback, Function successCallback, Function<NfcError> errorCallback)

NFCタグの読み取りを開始します。

パラメータ

messageCallback : Object NFC読み取り完了した場合にCallbackされます。
successCallback : Function NFC読み取り開始に成功した場合にCallbackされます。
errorCallback：Function<NfcError> NFC読み取り開始に失敗した場合にCallbackされます。

Return

void

サンプルコード

applican.nfc.startNfcReaderTag(messageCallback, successCallback, errorCallback);

function messageCallback(ret) {
  var dump = "NFC読み取り完了：¥n” + JSON.stringify(ret) + "¥n";alert(dump);
}

function successCallback() {
  alert("Success: startNfcReaderTag”);
}

function errorCallback(error){
  var dump = “Failed: startNfcReaderTag¥n”;
  dump += "code:" + error.code + "¥n";
  alert(dump);
}

startNfcReaderNdef

メソッド説明

startNfcReaderNdef(Function messageCallback, Function successCallback, Function<NfcError> errorCallback)

NFCのNDEF Messageの読み取りを開始します。

パラメータ

messageCallback : Object NFCのNDEF Messageの読み取り完了した場合にCallbackされます。
successCallback : Function NFCのNDEF Messageの読み取り開始に成功した場合にCallbackされます。
errorCallback：Function<NfcError> NFCのNDEF Messageの読み取り開始に失敗した場合にCallbackされます。

Return

void

サンプルコード

applican.nfc.startNfcReaderNdef(messageCallback, successCallback, errorCallback);

function messageCallback(ret) {
  var dump = "NFC NDEF Message読み取り完了：¥n” + JSON.stringify(ret) + "¥n";alert(dump);
}

function successCallback() {
  alert("Success: startNfcReaderNdef”);
}

function errorCallback(error){
  var dump = “Failed: startNfcReaderNdef¥n”;dump += "code:" + error.code + "¥n";
  alert(dump);
}

stopNfcReader

メソッド説明

stopNfcReader(Function successCallback, Function<NfcError> errorCallback)

NFCの読み取りを終了します。

パラメータ

successCallback : Function 読み取りを終了に成功した場合にCallbackされます。
errorCallback：Function<NfcError> 読み取りを終了に失敗した場合にCallbackされます。

Return

void

サンプルコード

applican.nfc.stopNfcReader(successCallback, errorCallback);

function successCallback(){
  alert("Success: stopNfcReader");
}

function errorCallback(error){
  var dump = “Failed: stopNfcReader¥n”;
  dump += "code:" + error.code + "¥n";alert(dump);
}

showNfcSettings

メソッド説明

showNfcSettings(Function successCallback, Function<NfcError> errorCallback)

NFCの設定画面を表示します。iOSの場合は無視されます。

パラメータ

successCallback : Function 設定画面が表示された場合にCallbackされます。
errorCallback：Function<NfcError> 設定画面が表示失敗した場合にCallbackされます。

Return

void

サンプルコード

applican.nfc.showNfcSettings(successCallback, errorCallback);

function successCallback() {
  alert("Success: showNfcSettings");
}

function errorCallback(error){
  var dump = “Failed: stopNfcReader¥n";dump += "code:" + error.code + "¥n";
  alert(dump);
}