HarmonyOS 接入

libs/KycNfcSdk-v1.0.0-b3e74971.har
libs/WAAnalytics-2.3.4-ce3e09a.har

{
  "modelVersion": "5.0.2",
  "dependencies": {},
  "overrides": {
    "analytics": "file:./libs/WAAnalytics-2.3.4-ce3e09a.har"
  }
}

{
  "name": "entry",
  "version": "1.0.0",
  "dependencies": {
    "kycnfcsdk": "file:../libs/KycNfcSdk-v1.0.0-b3e74971.har",
    "analytics": "file:../libs/WAAnalytics-2.3.4-ce3e09a.har"
  }
}

"requestPermissions": [
  { "name": "ohos.permission.INTERNET" }
]

[
  { "name": "ohos.permission.INTERNET" },
  { "name": "ohos.permission.GET_NETWORK_INFO" },
  { "name": "ohos.permission.SET_NETWORK_INFO" },
  { "name": "ohos.permission.NFC_TAG" }
]

{
  "module": {
    "abilities": [
      {
        "name": "EntryAbility",
        "exported": true,
        "skills": [
          {
            "actions": [
              "ohos.nfc.tag.action.TAG_FOUND"
            ],
            "uris": [
              { "type": "tag-tech/NfcB" },
              { "type": "tag-tech/IsoDep" }
            ]
          }
        ]
      }
    ]
  }
}

import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { JLElementName } from 'kycnfcsdk';

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    JLElementName.elementName = {
      bundleName: want.bundleName as string,
      abilityName: want.abilityName as string,
      moduleName: want.moduleName as string
    };
  }
}

import {
  InputData,
  NfcInitDataMap,
  WbCloudNfcSDK
} from 'kycnfcsdk';

const inputData = new InputData(
  orderNo,
  openApiAppId,
  openApiAppVersion,
  openApiNonce,
  openApiUserId,
  openApiSign,
  ocrCertId
);

import {
  InputData,
  NfcInitDataMap,
  TRAVEL_CARD_BIRTH,
  TRAVEL_CARD_NO,
  TRAVEL_CARD_VALIDATE,
  WbCloudNfcSDK
} from 'kycnfcsdk';

const data: NfcInitDataMap = {};

data[WbCloudNfcSDK.INPUT_DATA] = new InputData(
  orderNo,
  openApiAppId,
  openApiAppVersion,
  openApiNonce,
  openApiUserId,
  openApiSign,
  ocrCertId
);

// 单位：毫秒。Demo 传入 20000。
data[WbCloudNfcSDK.NFC_TIME] = 20000;

// Demo 中：'1' 表示身份证；'3' 表示回乡证/旅行证件类流程。
data[WbCloudNfcSDK.NFC_TYPE] = nfcType;

if (nfcType === '3') {
  data[TRAVEL_CARD_NO] = travelCardNo;
  data[TRAVEL_CARD_BIRTH] = travelBirth;
  data[TRAVEL_CARD_VALIDATE] = travelValidate;
}

data.travel_card_no = travelCardNo;
data.travel_card_birth = travelBirth;
data.travel_card_validate = travelValidate;

import common from '@ohos.app.ability.common';
import {
  NfcLoginListener,
  WbCloudNfcSDK
} from 'kycnfcsdk';

class LoginListener implements NfcLoginListener {
  onLoginSuccess(): void {
    // 初始化和 SDK 登录成功后，再启动读卡。
  }

  onLoginFailed(errorCode: string, errorMsg: string): void {
    // 初始化失败，业务侧提示或上报。
  }
}

const context = getContext() as common.UIAbilityContext;
WbCloudNfcSDK.getInstance().init(context, data, new LoginListener());

import common from '@ohos.app.ability.common';
import {
  NfcResultListener,
  WBNfcResult,
  WbCloudNfcSDK
} from 'kycnfcsdk';

class ResultListener implements NfcResultListener {
  onFinish(result: WBNfcResult): void {
    if (result.code === '0') {
      // 读卡成功。可使用 result.reqId/orderNo 查询最终业务结果。
      return;
    }

    // 读卡失败或取消。展示 result.message，并按业务需要上报。
  }
}

const context = getContext() as common.UIAbilityContext;
WbCloudNfcSDK.getInstance().startActivityForNfc(context, new ResultListener());

GET https://kyc1.qcloud.com/ems-partner/cert/nfc/getocrcertid

class SignResponse {
  sign: string = '';
  ocrCertId: string = '';
  code: string = '';
  msg: string = '';
}

GET https://kyc1.qcloud.com/ems-partner/cert/nfc/queryrecord

import { WbCloudNfcConfig } from 'kycnfcsdk';

const config = WbCloudNfcConfig.getInstance();

// 是否使用 SIT 环境。生产环境不要打开。
config.setSitEnv(false);

// 是否打开 SDK 内部日志。Demo 打开；生产环境建议 false。
config.setEnableLog(false);

const availability = WbCloudNfcSDK.getInstance().getNfcAvailability();

interface NfcAvailabilityState {
  status: NfcAvailabilityStatus; // ready / unsupported / disabled
  code: string;
  message: string;
  canRead: boolean;
}

-enable-property-obfuscation
-enable-toplevel-obfuscation
-enable-filename-obfuscation
-enable-export-obfuscation

JLElementName.elementName = {
  bundleName: want.bundleName as string,
  abilityName: want.abilityName as string,
  moduleName: want.moduleName as string
};

WbCloudNfcSDK.getInstance().resetCanDoNfcSdkRecognise();