NFC

NFC 사용을 위해 필요한 기능을 제공합니다.
Index
기능명 설명
지원 여부 해당 디바이스에서 NFC를 지원하는지 확인합니다.
not support
1.0.0 이상
활성화 확인 NFC의 활성화 여부를 확인합니다.
1.0.0 이상
not support
Read NFC 를 읽기 위해 요청합니다.
1.0.0 이상
1.0.0 이상
Write NFC 정보를 입력하기 위해 요청합니다.
1.0.0 이상
1.0.0 이상

지원 여부

해당 디바이스의 NFC 지원 여부를 조회하기 위해 요청합니다.
callback 파라미터에 입력한 함수명을 가진 함수의 매개변수로 결과가 반환됩니다.
Request
  • Schema 호출 방식.
    hyblin://native?type=nfc&cmd=isSupported&callback={FunctionName}
  • Function 호출 방식
    Android -
    iOSwebkit.messageHandler.hyblin.postMessage({"type":"nfc", "cmd":"isSupported", "callback":"{FunctionName}"});
Return Parameter

  • {FunctionName}에 파라메터로 json 데이타 형식의 값을 반환합니다.

    성공 시FunctionName({"header":{"success":true}, "body":{"status":0}});
    실패 시FunctionName({"header":{"success":false, "errorCode":"-1"}});

    기능명
    success
    true 요청이 정상적으로 처리 됨.
    false 요청이 정상적으로 처리되지 않음.
    status
    0 NFC 지원
    2800 NFC 미지원
    설명 NFC 지원 여부가 반환됩니다.
Sample Code
Request

활성화 확인

NFC 활성화 여부를 조회하기 위해 요청합니다.
callback 파라미터에 입력한 함수명을 가진 함수의 매개변수로 결과가 반환됩니다.
Request
  • Schema 호출 방식.
    hyblin://native?type=nfc&cmd=isNfcOnOff&callback={FunctionName}
  • Function 호출 방식
    Androidwindow.HLNative.hyblin(JSON.stringify({"type":"nfc", "cmd":"isNfcOnOff", "callback":"{FunctionName}"}));
    iOS -
Return Parameter

  • {FunctionName}에 파라메터로 json 데이타 형식의 값을 반환합니다.

    성공 시FunctionName({"header":{"success":true}, "body":{"status":0}});
    실패 시FunctionName({"header":{"success":false, "errorCode":"-1"}});

    기능명
    success
    true 요청이 정상적으로 처리 됨.
    false 요청이 정상적으로 처리되지 않음.
    status
    0 NFC On
    -1 NFC Off
    errorCode
    2800 NFC 미지원 기기
    설명 NFC 활성화 여부가 반환됩니다.
Sample Code
Request

Read

NFC 태그의 정보를 읽어오기 위해 요청합니다.
요청 후 NFC 태그를 가져다 대면 callback 파라미터에 입력한 함수명을 가진 함수의 매개변수로 NFC 태그의 정보가 반환됩니다.
Request
  • Schema 호출 방식.
    hyblin://native?type=nfc&cmd=readNfcData&callback={FunctionName}
  • Function 호출 방식
    Androidwindow.HLNative.hyblin(JSON.stringify({"type":"nfc", "cmd":"readNfcData", "callback":"{FunctionName}"}));
    iOSwebkit.messageHandler.hyblin.postMessage({"type":"nfc", "cmd":"readNfcData", "callback":"{FunctionName}"});
Return Parameter

  • {FunctionName}에 파라메터로 json 데이타 형식의 값을 반환합니다.

    성공 시FunctionName({"header":{"success":true}, "body":{"status":0, "data":{"type":"", "dataSet:":{"text":""}}}});
    실패 시FunctionName({"header":{"success":false, "errorCode":"-1"}});

    기능명
    success
    true 요청이 정상적으로 처리 됨.
    false 요청이 정상적으로 처리되지 않음.
    status
    0NFC On
    -1NFC Off
    errorCode
    2800NFC 미지원 기기
    2802NFC 읽기 실패
    2803데이터가 지원하지 않는 데이터만 있습니다.
    2804데이터가 비어있습니다.
    type
    text / url
    dataSet
    type이 text인 경우
    text텍스트 문자열
    type이 url인 경우
    urlURL
    설명 NFC 읽기 기능이 실행됩니다.
Sample Code
Request

Write

NFC 태그에 정보를 입력하기 위해 요청합니다.
요청 후 NFC 태그를 가져다 대면 입력한 정보가 해당 태그에 저장됩니다.
callback 파라미터에 입력한 함수명을 가진 함수의 매개변수로 실행 결과가 반환됩니다.
Request
  • Schema 호출 방식.
    hyblin://native?type=nfc&cmd=writeNfcData&param=[{type:"",dataSet:{text:""}}]&callback={FunctionName}
  • Function 호출 방식
    Androidwindow.HLNative.hyblin(JSON.stringify({"type":"nfc", "cmd":"writeNfcData", "param":[{"type":"", "dataSet":{"text":""}}], "callback":"{FunctionName}"}));
    iOSwebkit.messageHandler.hyblin.postMessage({"type":"nfc", "cmd":"writeNfcData", "param":[{"type":"", "dataSet":{"text":""}}], "callback":"{FunctionName}"});
Request Parameter
  • 기능명
    type
    text / url
    dataSet
    type이 text인 경우
    text텍스트 문자열
    type이 url인 경우
    urlURL
    protocol입력할 URL의 프로토콜
Return Parameter

  • {FunctionName}에 파라메터로 json 데이타 형식의 값을 반환합니다.

    성공 시FunctionName({"header":{"success":true}, "body":{"status":0}});
    실패 시FunctionName({"header":{"success":false, "errorCode":"-1"}});

    기능명
    success
    true 요청이 정상적으로 처리 됨.
    false 요청이 정상적으로 처리되지 않음.
    status
    0NFC On
    -1NFC Off
    errorCode
    2800NFC 미지원 기기
    2801NFC 쓰기 실패
    설명 NFC 태그에 정보를 입력합니다.
Sample Code
Request