vite-uni-dev-tool 1.1.0 → 1.2.1

package/dist/v3/hooks/useNFC/useNFCMpWeiXin.ts

@@ -1,812 +1,812 @@
-import { onMounted, onUnmounted, ref } from 'vue';
-import {
-  arrayNumberToArrayBuffer,
-  byteToString,
-  createUriNdefRecord,
-  formatCardInfo,
-  generateWSCBytesForAndroid,
-  getReadWriteStandard,
-  getSakHex,
-  getSakType,
-  getTnfDescription,
-  getTypeDescription,
-  parseAtqa,
-  parseUniversalTLV,
-  parseVCardPayload,
-  stringToArrayBuffer,
-  transformArrayBuffer,
-  wifiTLVConfig,
-} from './utils';
-
-export default function useNFCMpWeiXin(
-  listener: NFC.Listener,
-  _options?: NFC.NfcOption,
-): NFC.NfcResult {
-  /** 是否支持 nfc */
-  const isSupportNFC = ref<boolean | undefined>(false);
-  /** 是否监听中 */
-  const isListening = ref<boolean>(false);
-  /**
-   * 是否已连接
-   * 需要手动维护，调用connect()后连接 调用close()后断开 ,实际nfc 断开之后是无法监听到的， isConnected 已经被废弃掉了
-   */
-  const isConnected = ref<boolean>(false);
-  /** nfc 数据 */
-  const data = ref<NFC.Result>({
-    id: new ArrayBuffer(0),
-    techs: [],
-    byteArray: [],
-    hexArray: [],
-    hexNumberArray: [],
-    hexString: '',
-  });
-
-  /** nfc 适配器 */
-  let nfcAdapter: NFC.Adapter;
-
-  /** nfc 实例 */
-  let nfcInstance: NFC.Instance | undefined;
-
-  /** ndef 写入方式比较特殊，需要特殊处理 */
-  const isNdef = ref(false);
-
-  let maxTransceiveLength = 0;
-
-  const _checkInterval: any = null;
-
-  /**
-   * 初始化 nfc adapter
-   *
-   * @return {*}
-   */
-  async function initNfcAdapter() {
-    await checkHCEState();
-
-    if (!isSupportNFC.value) return;
-
-    nfcAdapter = wx.getNFCAdapter();
-
-    nfcAdapter.onDiscovered(innerListener);
-  }
-
-  function getAtqa(nfcInstance: NFC.Instance): Promise<NFC.Atqa> {
-    return new Promise((resolve, reject) => {
-      if (!nfcInstance.getAtqa) {
-        reject({ errMsg: '不支持获取 atqa' });
-      }
-      nfcInstance?.getAtqa?.({
-        success: (res) => {
-          resolve(res);
-        },
-        fail: (err) => {
-          reject(err);
-        },
-      });
-    });
-  }
-
-  function getMaxTransceiveLength(
-    nfcInstance: NFC.Instance,
-  ): Promise<NFC.MaxTransceiveLength> {
-    return new Promise((resolve, reject) => {
-      if (nfcInstance.getMaxTransceiveLength) {
-        nfcInstance?.getMaxTransceiveLength?.({
-          success: (res) => {
-            resolve(res);
-          },
-          fail: (err) => {
-            reject(err);
-          },
-        });
-      } else {
-        reject({ errMsg: '不支持获取 maxTransceiveLength' });
-      }
-    });
-  }
-
-  function getSak(nfcInstance: NFC.Instance): Promise<NFC.Sak> {
-    return new Promise((resolve, reject) => {
-      if (!nfcInstance.getMaxTransceiveLength) {
-        reject({ errMsg: '不支持获取 sak' });
-      }
-
-      nfcInstance?.getSak?.({
-        success: (res) => {
-          resolve(res);
-        },
-        fail: (err) => {
-          reject(err);
-        },
-      });
-    });
-  }
-
-  /**
-   * 检查HCE状态
-   *
-   * @return {*}
-   */
-  function checkHCEState() {
-    return new Promise((resolve, reject) => {
-      wx.getHCEState({
-        success: (res: any) => {
-          isSupportNFC.value = true;
-          resolve(res);
-        },
-        fail: (err: any) => {
-          isSupportNFC.value = false;
-          reject(err);
-        },
-      });
-    });
-  }
-
-  /**
-   * 启用HCE
-   *
-   * @return {*}
-   */
-  function startHCE() {
-    if (!isSupportNFC.value) {
-      uni.showToast({
-        title: '设备不支持 NFC',
-        icon: 'none',
-      });
-      return Promise.reject({
-        errMsg: '设备不支持 NFC',
-      });
-    }
-
-    // 前置校验
-    if (!nfcAdapter) {
-      uni.showToast({ title: '请先初始化 NFC 适配器', icon: 'none' });
-      return Promise.reject({
-        errMsg: '请先初始化 NFC 适配器',
-      });
-    }
-
-    if (isListening.value) {
-      uni.showToast({ title: 'NFC 监听已开启，无需重复操作', icon: 'none' });
-      return Promise.reject({
-        errMsg: 'NFC 监听已开启，无需重复操作',
-      });
-    }
-    nfcAdapter.startDiscovery();
-    isListening.value = true;
-    uni.showToast({
-      title: '开始监听NFC',
-      icon: 'none',
-    });
-    return Promise.resolve({
-      errMsg: '开始监听NFC',
-    });
-  }
-
-  /**
-   * 停用HCE
-   *
-   * @return {*}
-   */
-  function stopHCE() {
-    // 前置校验
-    if (!isSupportNFC.value) {
-      uni.showToast({
-        title: '设备不支持 NFC',
-        icon: 'none',
-      });
-      return Promise.reject({
-        errMsg: '设备不支持 NFC',
-      });
-    }
-
-    // 前置校验
-    if (!nfcAdapter) {
-      uni.showToast({ title: '请先初始化 NFC 适配器', icon: 'none' });
-      return Promise.reject({
-        errMsg: '请先初始化 NFC 适配器',
-      });
-    }
-
-    if (!isListening.value) {
-      uni.showToast({ title: 'NFC 监听已关闭，无需重复操作', icon: 'none' });
-      return Promise.reject({
-        errMsg: 'NFC 监听已关闭，无需重复操作',
-      });
-    }
-
-    nfcAdapter.stopDiscovery();
-    isListening.value = false;
-    uni.showToast({
-      title: '停止监听NFC',
-      icon: 'none',
-    });
-    return Promise.resolve({
-      errMsg: '停止监听NFC',
-    });
-  }
-
-  function getInstance(techs: NFC.NfcType[], needNdef?: boolean) {
-    let type = 'Ndef';
-    if (needNdef) {
-      type = 'Ndef';
-    } else {
-      type = techs.filter((tech) => tech != 'Ndef' && tech != 'NDEF')?.[0];
-    }
-
-    switch (type) {
-      case 'NFC-A':
-        return nfcAdapter.getNfcA();
-      case 'NFC-B':
-        return nfcAdapter.getNfcB();
-      case 'NFC-F':
-        return nfcAdapter.getNfcF();
-      case 'NFC-V':
-        return nfcAdapter.getNfcV();
-      case 'MIFARE Classic':
-        return nfcAdapter.getMifareClassic();
-      case 'MIFARE Ultralight':
-        return nfcAdapter.getMifareUltralight();
-      case 'Ndef':
-        isNdef.value = true;
-        return nfcAdapter.getNdef();
-      case 'ISO-DEP':
-        return nfcAdapter.getIsoDep();
-      default:
-        return undefined;
-    }
-  }
-
-  // function checkConnected() {
-  //   checkInterval = setInterval(async () => {
-  //     if (!nfcAdapter) {
-  //       isConnected.value = false;
-  //       clearInterval(checkInterval);
-  //       return;
-  //     }
-
-  //     if (!nfcInstance) {
-  //       isConnected.value = false;
-  //       clearInterval(checkInterval);
-  //       return;
-  //     }
-  //     try {
-  //       // TODO: 检测是否连接成功
-  //       // await connect();
-
-  //       isConnected.value = true;
-  //     } catch (error) {
-  //       console.log('error: ', error);
-  //       isConnected.value = false;
-  //       clearInterval(checkInterval);
-  //     }
-  //   }, options?.checkConnectedDelay ?? 500);
-  // }
-
-  /**
-   * 读取监听
-   *
-   * @param {*} res
-   */
-  async function innerListener(res: NFC.Data) {
-    const transform = transformArrayBuffer(res?.id);
-
-    nfcInstance = getInstance(res.techs, true);
-
-    if (res.techs.includes('NFC-A')) {
-      const nfcA = nfcAdapter.getNfcA();
-      try {
-        const atqa = await getAtqa(nfcA);
-        const atqaInfo = parseAtqa(atqa.atqa);
-        data.value.atqa = atqa.atqa;
-        data.value.uidType = atqaInfo?.uidType;
-        data.value.storageSize = atqaInfo?.storageSize;
-        data.value.manufacturer = atqaInfo?.manufacturer;
-        data.value.cardFeatures = atqaInfo?.cardFeatures;
-        data.value.reserved = atqaInfo?.reserved;
-      } catch (_error) {
-        // ignore error
-      }
-
-      try {
-        const sak = await getSak(nfcA);
-        const sakType = getSakType(sak.sak);
-        const sakHex = getSakHex(sak.sak);
-        data.value.sak = sak.sak;
-        data.value.sakType = sakType;
-        data.value.sakHex = sakHex;
-      } catch (_error) {
-        // ignore error
-      }
-    }
-
-    if (nfcInstance) {
-      await connect();
-
-      data.value.readWriteStandard = getReadWriteStandard(res.techs);
-      if (!isNdef.value) {
-        const maxTransceive = await getMaxTransceiveLength(nfcInstance);
-        maxTransceiveLength = maxTransceive.length;
-        data.value.maxTransceiveLength = maxTransceiveLength;
-      } else {
-        const otherInstance = getInstance(res.techs);
-        const maxTransceive = await getMaxTransceiveLength(otherInstance);
-        maxTransceiveLength = maxTransceive.length;
-        data.value.maxTransceiveLength = maxTransceiveLength;
-      }
-
-      const messages =
-        res.messages?.map((message) => {
-          const records = message.records.map((item) => {
-            const typeByte = transformArrayBuffer(
-              item.type as any as ArrayBuffer,
-            ).byteArray;
-            const type = byteToString(typeByte);
-
-            const idByte = transformArrayBuffer(
-              item.id as any as ArrayBuffer,
-            ).byteArray;
-            const id = byteToString(idByte);
-            const tnf = item.tnf?.toString() as NFC.Tnf;
-
-            const payloadByte = transformArrayBuffer(
-              item.payload as any as ArrayBuffer,
-            ).byteArray;
-
-            const typeDescription = getTypeDescription(type, payloadByte);
-
-            let payload: any = byteToString(payloadByte);
-            if (type === 'application/vnd.wfa.wsc') {
-              payload = parseUniversalTLV(payloadByte, wifiTLVConfig);
-            } else if (type === 'text/vcard') {
-              payload = parseVCardPayload(payload);
-            }
-
-            return {
-              id,
-              tnf,
-              tnfDescription: getTnfDescription(tnf),
-              type,
-              typeDescription,
-              payload,
-            };
-          });
-
-          return {
-            ...message,
-            records,
-          };
-        }) ?? [];
-
-      data.value = {
-        ...data.value,
-        ...res,
-        ...transform,
-        messages,
-      };
-
-      isConnected.value = true;
-
-      listener?.(data.value);
-      // checkConnected();
-      // 可将该行去除
-      uni?.__dev_tool_nfc_collection__?.(data.value);
-    }
-  }
-
-  /**
-   * 移除监听读取消息
-   *
-   * @return {*}
-   */
-  function offHCEMessage() {
-    if (!isSupportNFC.value) {
-      uni.showToast({ title: '设备不支持 NFC，无需移除监听', icon: 'none' });
-      return { errMsg: 'success' };
-    }
-    isConnected.value = false;
-    nfcAdapter.offDiscovered(innerListener);
-
-    uni.showToast({ title: 'NFC 监听已移除', icon: 'none' });
-    return { errMsg: 'success' };
-  }
-
-  /**
-   * 连接 nfc
-   *
-   * @return {*}
-   */
-  function connect(): Promise<{ errMsg: string }> {
-    return new Promise((resolve, reject) => {
-      if (!isSupportNFC.value) {
-        uni.showToast({ title: '设备不支持 NFC', icon: 'none' });
-        reject({
-          errMsg: '设备不支持 NFC',
-        });
-      }
-
-      if (!isListening.value) {
-        uni.showToast({ title: '请先开启前台调度监听', icon: 'none' });
-        reject({
-          errMsg: '请先开启前台调度监听',
-        });
-      }
-
-      if (!nfcInstance) {
-        uni.showToast({ title: '请先靠近 NFC 标签', icon: 'none' });
-        reject({
-          errMsg: '请先靠近 NFC 标签',
-        });
-      }
-
-      nfcInstance?.connect?.({
-        success: (res) => {
-          resolve(res);
-          isConnected.value = true;
-          uni.showToast({
-            title: 'NFC 连接成功',
-            icon: 'none',
-          });
-          resolve({
-            errMsg: 'NFC 连接成功',
-          });
-        },
-        fail: (err) => {
-          if (err.errMsg === 'connect:fail:Tech already connected') {
-            resolve(err);
-            isConnected.value = true;
-          } else {
-            reject(err);
-            isConnected.value = false;
-            nfcInstance = undefined;
-            uni.showToast({
-              title: 'NFC 连接失败',
-              icon: 'none',
-            });
-          }
-        },
-      });
-    });
-  }
-
-  /**
-   * 断开 nfc
-   *
-   * @return {*}
-   */
-  function close(): Promise<{ errMsg: string }> {
-    return new Promise((resolve, reject) => {
-      if (!isSupportNFC.value) {
-        reject({
-          errMsg: '不支持NFC',
-        });
-      }
-
-      if (!nfcInstance) {
-        reject({
-          errMsg: '未读取到NFC卡',
-        });
-      }
-
-      nfcInstance?.close?.({
-        success: (_res) => {
-          isConnected.value = false;
-          nfcInstance = undefined;
-          resolve({
-            errMsg: 'NFC 断开成功',
-          });
-
-          uni.showToast({ title: 'NFC 连接已关闭', icon: 'none' });
-        },
-        fail: (err) => {
-          reject(err);
-          uni.showToast({ title: 'NFC 连接关闭失败', icon: 'none' });
-        },
-      });
-    });
-  }
-
-  async function transceive(data: ArrayBuffer) {
-    return new Promise((resolve, reject) => {
-      if (!isSupportNFC.value) {
-        reject({
-          errMsg: '不支持NFC',
-        });
-        return;
-      }
-
-      if (!nfcInstance) {
-        reject({
-          errMsg: '未读取到NFC卡',
-        });
-        return;
-      }
-      nfcInstance?.transceive?.({
-        data,
-        success: (res) => {
-          resolve(res);
-        },
-        fail: (err) => {
-          reject(err);
-        },
-      });
-    });
-  }
-
-  async function writeNdefMessage(data: NFC.NdefData) {
-    return new Promise((resolve, reject) => {
-      if (!isSupportNFC.value) {
-        reject({
-          errMsg: '不支持NFC',
-        });
-      } else if (!nfcInstance) {
-        reject({
-          errMsg: '未读取到NFC卡',
-        });
-      } else {
-        nfcInstance?.writeNdefMessage?.({
-          ...data,
-          success: (res) => {
-            resolve(res);
-          },
-          fail: (err) => {
-            reject(err);
-          },
-        });
-      }
-    });
-  }
-
-  /**
-   * 写入数据
-   *
-   * 支持以以下类型
-   * ISO-DEP
-   * MIFARE Classic
-   * MIFARE Ultralight
-   * NFC-A
-   * NFC-B
-   * NFC-F
-   * NFC-V
-   *
-   * @param {*} data
-   * @return {*}
-   */
-  async function write(data: ArrayBuffer) {
-    try {
-      // 连接 nfc
-      await connect();
-      uni.showToast({
-        title: '开始写入数据, 请勿断开连接',
-        icon: 'none',
-      });
-      // 写入数据
-
-      const result = await transceive(data);
-
-      uni.showToast({
-        title: '数据写入成功',
-        icon: 'none',
-      });
-      // 断开 nfc
-      await close();
-      return Promise.resolve({
-        errMsg: '数据写入成功',
-        data: result,
-      });
-    } catch (error) {
-      return Promise.reject({
-        errMsg: '数据写入失败',
-        error,
-      });
-    }
-  }
-
-  /**
-   * 写入数据
-   * 支持以以下类型
-   * Ndef
-   *
-   * @param {NFC.NdefData} data
-   */
-  async function writeNdef(data: NFC.NdefRecord[]) {
-    if (!isNdef.value) {
-      uni.showToast({
-        title: 'NFC 标签不支持 NDEF',
-        icon: 'none',
-      });
-      return Promise.reject({
-        errMsg: 'NFC 标签不支持 NDEF',
-      });
-    }
-
-    if (!nfcInstance) {
-      uni.showToast({
-        title: '请先建立连接',
-        icon: 'none',
-      });
-      return Promise.reject({
-        errMsg: '请先建立连接',
-      });
-    }
-
-    if (!isConnected.value) {
-      uni.showToast({
-        title: '请先建立连接',
-        icon: 'none',
-      });
-      return Promise.reject({
-        errMsg: '请先建立连接',
-      });
-    }
-
-    uni.showToast({
-      title: '开始写入数据，请勿断开连接',
-      icon: 'none',
-      duration: 3000,
-    });
-
-    try {
-      const records = data?.map((item) => {
-        // const tnf = stringToArrayBuffer(item.tnf);
-        const id = item.id ? stringToArrayBuffer(item.id) : new ArrayBuffer(0);
-        const type = stringToArrayBuffer(item.type);
-
-        return {
-          tnf: item.tnf,
-          type,
-          id,
-          payload: item.payload,
-        };
-      });
-
-      if (maxTransceiveLength && maxTransceiveLength < records.length) {
-        uni.showToast({
-          title: '写入数据超出标签容量',
-          icon: 'none',
-          duration: 3000,
-        });
-        nfcInstance.close();
-
-        return Promise.reject({
-          errMsg: '写入数据超出标签容量',
-        });
-      }
-
-      // 连接 nfc
-      await connect();
-      uni.showToast({
-        title: '开始写入数据, 请勿断开连接',
-        icon: 'none',
-      });
-      // 写入数据
-
-      const result = await writeNdefMessage({
-        records,
-      });
-
-      await close();
-      uni.showToast({
-        title: '数据写入成功',
-        icon: 'none',
-        duration: 3000,
-      });
-      return Promise.resolve({
-        errMsg: '数据写入成功',
-        data: result,
-      });
-    } catch (error) {
-      uni.showToast({
-        title: '数据写入失败',
-        icon: 'none',
-        duration: 3000,
-      });
-
-      return Promise.reject({
-        errMsg: '数据写入失败',
-        error,
-      });
-    }
-  }
-
-  /**
-   *
-   *
-   * @param {string} text
-   * @param {string} [language='zh'] 微信小程序下无效
-   * @return {*}
-   */
-  async function writeNdefText(
-    text: string,
-    _language = 'zh',
-  ): Promise<{ errMsg: string }> {
-    return writeNdef([
-      {
-        tnf: 1,
-        type: 'T',
-        payload: stringToArrayBuffer(text),
-      },
-    ]);
-  }
-
-  function writeNdefUri(uri: string): Promise<{ errMsg: string }> {
-    const record = createUriNdefRecord(uri);
-    return writeNdef([record]);
-  }
-
-  function writeNdefAndroidApp(
-    packageName: string,
-  ): Promise<{ errMsg: string }> {
-    return writeNdef([
-      {
-        tnf: 4,
-        type: 'android.com:pkg',
-        payload: stringToArrayBuffer(packageName),
-      },
-    ]);
-  }
-
-  function writeNdefWifi({
-    ssid,
-    password,
-    authType,
-  }: NFC.WSCConfig): Promise<{ errMsg: string }> {
-    const mimeType = 'application/vnd.wfa.wsc';
-    const wifiData = generateWSCBytesForAndroid({
-      ssid,
-      password,
-      authType,
-    });
-    return writeNdef([
-      {
-        tnf: 2,
-        type: mimeType,
-        payload: arrayNumberToArrayBuffer(wifiData),
-      },
-    ]);
-  }
-
-  function writeNdefVcard(
-    cardInfo: NFC.VCardContactInfo,
-  ): Promise<{ errMsg: string }> {
-    const mimeType = 'text/vcard';
-    const cardString = formatCardInfo(cardInfo);
-
-    const cardData = stringToArrayBuffer(cardString);
-    return writeNdef([
-      {
-        tnf: 2,
-        type: mimeType,
-        payload: cardData,
-      },
-    ]);
-  }
-
-  onMounted(() => {
-    initNfcAdapter();
-  });
-
-  onUnmounted(() => {
-    stopHCE();
-    offHCEMessage();
-  });
-
-  return {
-    data,
-    isNdef,
-    isSupportNFC,
-    isListening,
-    isConnected,
-    nfcInstance,
-    startHCE,
-    stopHCE,
-    connect,
-    close,
-    write,
-    writeNdef,
-    writeNdefText,
-    writeNdefUri,
-    writeNdefAndroidApp,
-    writeNdefWifi,
-    writeNdefVcard,
-  };
-}
+import { onMounted, onUnmounted, ref } from 'vue';
+import {
+  arrayNumberToArrayBuffer,
+  byteToString,
+  createUriNdefRecord,
+  formatCardInfo,
+  generateWSCBytesForAndroid,
+  getReadWriteStandard,
+  getSakHex,
+  getSakType,
+  getTnfDescription,
+  getTypeDescription,
+  parseAtqa,
+  parseUniversalTLV,
+  parseVCardPayload,
+  stringToArrayBuffer,
+  transformArrayBuffer,
+  wifiTLVConfig,
+} from './utils';
+
+export default function useNFCMpWeiXin(
+  listener: NFC.Listener,
+  _options?: NFC.NfcOption,
+): NFC.NfcResult {
+  /** 是否支持 nfc */
+  const isSupportNFC = ref<boolean | undefined>(false);
+  /** 是否监听中 */
+  const isListening = ref<boolean>(false);
+  /**
+   * 是否已连接
+   * 需要手动维护，调用connect()后连接 调用close()后断开 ,实际nfc 断开之后是无法监听到的， isConnected 已经被废弃掉了
+   */
+  const isConnected = ref<boolean>(false);
+  /** nfc 数据 */
+  const data = ref<NFC.Result>({
+    id: new ArrayBuffer(0),
+    techs: [],
+    byteArray: [],
+    hexArray: [],
+    hexNumberArray: [],
+    hexString: '',
+  });
+
+  /** nfc 适配器 */
+  let nfcAdapter: NFC.Adapter;
+
+  /** nfc 实例 */
+  let nfcInstance: NFC.Instance | undefined;
+
+  /** ndef 写入方式比较特殊，需要特殊处理 */
+  const isNdef = ref(false);
+
+  let maxTransceiveLength = 0;
+
+  const _checkInterval: any = null;
+
+  /**
+   * 初始化 nfc adapter
+   *
+   * @return {*}
+   */
+  async function initNfcAdapter() {
+    await checkHCEState();
+
+    if (!isSupportNFC.value) return;
+
+    nfcAdapter = wx.getNFCAdapter();
+
+    nfcAdapter.onDiscovered(innerListener);
+  }
+
+  function getAtqa(nfcInstance: NFC.Instance): Promise<NFC.Atqa> {
+    return new Promise((resolve, reject) => {
+      if (!nfcInstance.getAtqa) {
+        reject({ errMsg: '不支持获取 atqa' });
+      }
+      nfcInstance?.getAtqa?.({
+        success: (res) => {
+          resolve(res);
+        },
+        fail: (err) => {
+          reject(err);
+        },
+      });
+    });
+  }
+
+  function getMaxTransceiveLength(
+    nfcInstance: NFC.Instance,
+  ): Promise<NFC.MaxTransceiveLength> {
+    return new Promise((resolve, reject) => {
+      if (nfcInstance.getMaxTransceiveLength) {
+        nfcInstance?.getMaxTransceiveLength?.({
+          success: (res) => {
+            resolve(res);
+          },
+          fail: (err) => {
+            reject(err);
+          },
+        });
+      } else {
+        reject({ errMsg: '不支持获取 maxTransceiveLength' });
+      }
+    });
+  }
+
+  function getSak(nfcInstance: NFC.Instance): Promise<NFC.Sak> {
+    return new Promise((resolve, reject) => {
+      if (!nfcInstance.getMaxTransceiveLength) {
+        reject({ errMsg: '不支持获取 sak' });
+      }
+
+      nfcInstance?.getSak?.({
+        success: (res) => {
+          resolve(res);
+        },
+        fail: (err) => {
+          reject(err);
+        },
+      });
+    });
+  }
+
+  /**
+   * 检查HCE状态
+   *
+   * @return {*}
+   */
+  function checkHCEState() {
+    return new Promise((resolve, reject) => {
+      wx.getHCEState({
+        success: (res: any) => {
+          isSupportNFC.value = true;
+          resolve(res);
+        },
+        fail: (err: any) => {
+          isSupportNFC.value = false;
+          reject(err);
+        },
+      });
+    });
+  }
+
+  /**
+   * 启用HCE
+   *
+   * @return {*}
+   */
+  function startHCE() {
+    if (!isSupportNFC.value) {
+      uni.showToast({
+        title: '设备不支持 NFC',
+        icon: 'none',
+      });
+      return Promise.reject({
+        errMsg: '设备不支持 NFC',
+      });
+    }
+
+    // 前置校验
+    if (!nfcAdapter) {
+      uni.showToast({ title: '请先初始化 NFC 适配器', icon: 'none' });
+      return Promise.reject({
+        errMsg: '请先初始化 NFC 适配器',
+      });
+    }
+
+    if (isListening.value) {
+      uni.showToast({ title: 'NFC 监听已开启，无需重复操作', icon: 'none' });
+      return Promise.reject({
+        errMsg: 'NFC 监听已开启，无需重复操作',
+      });
+    }
+    nfcAdapter.startDiscovery();
+    isListening.value = true;
+    uni.showToast({
+      title: '开始监听NFC',
+      icon: 'none',
+    });
+    return Promise.resolve({
+      errMsg: '开始监听NFC',
+    });
+  }
+
+  /**
+   * 停用HCE
+   *
+   * @return {*}
+   */
+  function stopHCE() {
+    // 前置校验
+    if (!isSupportNFC.value) {
+      uni.showToast({
+        title: '设备不支持 NFC',
+        icon: 'none',
+      });
+      return Promise.reject({
+        errMsg: '设备不支持 NFC',
+      });
+    }
+
+    // 前置校验
+    if (!nfcAdapter) {
+      uni.showToast({ title: '请先初始化 NFC 适配器', icon: 'none' });
+      return Promise.reject({
+        errMsg: '请先初始化 NFC 适配器',
+      });
+    }
+
+    if (!isListening.value) {
+      uni.showToast({ title: 'NFC 监听已关闭，无需重复操作', icon: 'none' });
+      return Promise.reject({
+        errMsg: 'NFC 监听已关闭，无需重复操作',
+      });
+    }
+
+    nfcAdapter.stopDiscovery();
+    isListening.value = false;
+    uni.showToast({
+      title: '停止监听NFC',
+      icon: 'none',
+    });
+    return Promise.resolve({
+      errMsg: '停止监听NFC',
+    });
+  }
+
+  function getInstance(techs: NFC.NfcType[], needNdef?: boolean) {
+    let type = 'Ndef';
+    if (needNdef) {
+      type = 'Ndef';
+    } else {
+      type = techs.filter((tech) => tech != 'Ndef' && tech != 'NDEF')?.[0];
+    }
+
+    switch (type) {
+      case 'NFC-A':
+        return nfcAdapter.getNfcA();
+      case 'NFC-B':
+        return nfcAdapter.getNfcB();
+      case 'NFC-F':
+        return nfcAdapter.getNfcF();
+      case 'NFC-V':
+        return nfcAdapter.getNfcV();
+      case 'MIFARE Classic':
+        return nfcAdapter.getMifareClassic();
+      case 'MIFARE Ultralight':
+        return nfcAdapter.getMifareUltralight();
+      case 'Ndef':
+        isNdef.value = true;
+        return nfcAdapter.getNdef();
+      case 'ISO-DEP':
+        return nfcAdapter.getIsoDep();
+      default:
+        return undefined;
+    }
+  }
+
+  // function checkConnected() {
+  //   checkInterval = setInterval(async () => {
+  //     if (!nfcAdapter) {
+  //       isConnected.value = false;
+  //       clearInterval(checkInterval);
+  //       return;
+  //     }
+
+  //     if (!nfcInstance) {
+  //       isConnected.value = false;
+  //       clearInterval(checkInterval);
+  //       return;
+  //     }
+  //     try {
+  //       // TODO: 检测是否连接成功
+  //       // await connect();
+
+  //       isConnected.value = true;
+  //     } catch (error) {
+  //       console.log('error: ', error);
+  //       isConnected.value = false;
+  //       clearInterval(checkInterval);
+  //     }
+  //   }, options?.checkConnectedDelay ?? 500);
+  // }
+
+  /**
+   * 读取监听
+   *
+   * @param {*} res
+   */
+  async function innerListener(res: NFC.Data) {
+    const transform = transformArrayBuffer(res?.id);
+
+    nfcInstance = getInstance(res.techs, true);
+
+    if (res.techs.includes('NFC-A')) {
+      const nfcA = nfcAdapter.getNfcA();
+      try {
+        const atqa = await getAtqa(nfcA);
+        const atqaInfo = parseAtqa(atqa.atqa);
+        data.value.atqa = atqa.atqa;
+        data.value.uidType = atqaInfo?.uidType;
+        data.value.storageSize = atqaInfo?.storageSize;
+        data.value.manufacturer = atqaInfo?.manufacturer;
+        data.value.cardFeatures = atqaInfo?.cardFeatures;
+        data.value.reserved = atqaInfo?.reserved;
+      } catch (_error) {
+        // ignore error
+      }
+
+      try {
+        const sak = await getSak(nfcA);
+        const sakType = getSakType(sak.sak);
+        const sakHex = getSakHex(sak.sak);
+        data.value.sak = sak.sak;
+        data.value.sakType = sakType;
+        data.value.sakHex = sakHex;
+      } catch (_error) {
+        // ignore error
+      }
+    }
+
+    if (nfcInstance) {
+      await connect();
+
+      data.value.readWriteStandard = getReadWriteStandard(res.techs);
+      if (!isNdef.value) {
+        const maxTransceive = await getMaxTransceiveLength(nfcInstance);
+        maxTransceiveLength = maxTransceive.length;
+        data.value.maxTransceiveLength = maxTransceiveLength;
+      } else {
+        const otherInstance = getInstance(res.techs);
+        const maxTransceive = await getMaxTransceiveLength(otherInstance);
+        maxTransceiveLength = maxTransceive.length;
+        data.value.maxTransceiveLength = maxTransceiveLength;
+      }
+
+      const messages =
+        res.messages?.map((message) => {
+          const records = message.records.map((item) => {
+            const typeByte = transformArrayBuffer(
+              item.type as any as ArrayBuffer,
+            ).byteArray;
+            const type = byteToString(typeByte);
+
+            const idByte = transformArrayBuffer(
+              item.id as any as ArrayBuffer,
+            ).byteArray;
+            const id = byteToString(idByte);
+            const tnf = item.tnf?.toString() as NFC.Tnf;
+
+            const payloadByte = transformArrayBuffer(
+              item.payload as any as ArrayBuffer,
+            ).byteArray;
+
+            const typeDescription = getTypeDescription(type, payloadByte);
+
+            let payload: any = byteToString(payloadByte);
+            if (type === 'application/vnd.wfa.wsc') {
+              payload = parseUniversalTLV(payloadByte, wifiTLVConfig);
+            } else if (type === 'text/vcard') {
+              payload = parseVCardPayload(payload);
+            }
+
+            return {
+              id,
+              tnf,
+              tnfDescription: getTnfDescription(tnf),
+              type,
+              typeDescription,
+              payload,
+            };
+          });
+
+          return {
+            ...message,
+            records,
+          };
+        }) ?? [];
+
+      data.value = {
+        ...data.value,
+        ...res,
+        ...transform,
+        messages,
+      };
+
+      isConnected.value = true;
+
+      listener?.(data.value);
+      // checkConnected();
+      // 可将该行去除
+      uni?.__dev_tool_nfc_collection__?.(data.value);
+    }
+  }
+
+  /**
+   * 移除监听读取消息
+   *
+   * @return {*}
+   */
+  function offHCEMessage() {
+    if (!isSupportNFC.value) {
+      uni.showToast({ title: '设备不支持 NFC，无需移除监听', icon: 'none' });
+      return { errMsg: 'success' };
+    }
+    isConnected.value = false;
+    nfcAdapter.offDiscovered(innerListener);
+
+    uni.showToast({ title: 'NFC 监听已移除', icon: 'none' });
+    return { errMsg: 'success' };
+  }
+
+  /**
+   * 连接 nfc
+   *
+   * @return {*}
+   */
+  function connect(): Promise<{ errMsg: string }> {
+    return new Promise((resolve, reject) => {
+      if (!isSupportNFC.value) {
+        uni.showToast({ title: '设备不支持 NFC', icon: 'none' });
+        reject({
+          errMsg: '设备不支持 NFC',
+        });
+      }
+
+      if (!isListening.value) {
+        uni.showToast({ title: '请先开启前台调度监听', icon: 'none' });
+        reject({
+          errMsg: '请先开启前台调度监听',
+        });
+      }
+
+      if (!nfcInstance) {
+        uni.showToast({ title: '请先靠近 NFC 标签', icon: 'none' });
+        reject({
+          errMsg: '请先靠近 NFC 标签',
+        });
+      }
+
+      nfcInstance?.connect?.({
+        success: (res) => {
+          resolve(res);
+          isConnected.value = true;
+          uni.showToast({
+            title: 'NFC 连接成功',
+            icon: 'none',
+          });
+          resolve({
+            errMsg: 'NFC 连接成功',
+          });
+        },
+        fail: (err) => {
+          if (err.errMsg === 'connect:fail:Tech already connected') {
+            resolve(err);
+            isConnected.value = true;
+          } else {
+            reject(err);
+            isConnected.value = false;
+            nfcInstance = undefined;
+            uni.showToast({
+              title: 'NFC 连接失败',
+              icon: 'none',
+            });
+          }
+        },
+      });
+    });
+  }
+
+  /**
+   * 断开 nfc
+   *
+   * @return {*}
+   */
+  function close(): Promise<{ errMsg: string }> {
+    return new Promise((resolve, reject) => {
+      if (!isSupportNFC.value) {
+        reject({
+          errMsg: '不支持NFC',
+        });
+      }
+
+      if (!nfcInstance) {
+        reject({
+          errMsg: '未读取到NFC卡',
+        });
+      }
+
+      nfcInstance?.close?.({
+        success: (_res) => {
+          isConnected.value = false;
+          nfcInstance = undefined;
+          resolve({
+            errMsg: 'NFC 断开成功',
+          });
+
+          uni.showToast({ title: 'NFC 连接已关闭', icon: 'none' });
+        },
+        fail: (err) => {
+          reject(err);
+          uni.showToast({ title: 'NFC 连接关闭失败', icon: 'none' });
+        },
+      });
+    });
+  }
+
+  async function transceive(data: ArrayBuffer) {
+    return new Promise((resolve, reject) => {
+      if (!isSupportNFC.value) {
+        reject({
+          errMsg: '不支持NFC',
+        });
+        return;
+      }
+
+      if (!nfcInstance) {
+        reject({
+          errMsg: '未读取到NFC卡',
+        });
+        return;
+      }
+      nfcInstance?.transceive?.({
+        data,
+        success: (res) => {
+          resolve(res);
+        },
+        fail: (err) => {
+          reject(err);
+        },
+      });
+    });
+  }
+
+  async function writeNdefMessage(data: NFC.NdefData) {
+    return new Promise((resolve, reject) => {
+      if (!isSupportNFC.value) {
+        reject({
+          errMsg: '不支持NFC',
+        });
+      } else if (!nfcInstance) {
+        reject({
+          errMsg: '未读取到NFC卡',
+        });
+      } else {
+        nfcInstance?.writeNdefMessage?.({
+          ...data,
+          success: (res) => {
+            resolve(res);
+          },
+          fail: (err) => {
+            reject(err);
+          },
+        });
+      }
+    });
+  }
+
+  /**
+   * 写入数据
+   *
+   * 支持以以下类型
+   * ISO-DEP
+   * MIFARE Classic
+   * MIFARE Ultralight
+   * NFC-A
+   * NFC-B
+   * NFC-F
+   * NFC-V
+   *
+   * @param {*} data
+   * @return {*}
+   */
+  async function write(data: ArrayBuffer) {
+    try {
+      // 连接 nfc
+      await connect();
+      uni.showToast({
+        title: '开始写入数据, 请勿断开连接',
+        icon: 'none',
+      });
+      // 写入数据
+
+      const result = await transceive(data);
+
+      uni.showToast({
+        title: '数据写入成功',
+        icon: 'none',
+      });
+      // 断开 nfc
+      await close();
+      return Promise.resolve({
+        errMsg: '数据写入成功',
+        data: result,
+      });
+    } catch (error) {
+      return Promise.reject({
+        errMsg: '数据写入失败',
+        error,
+      });
+    }
+  }
+
+  /**
+   * 写入数据
+   * 支持以以下类型
+   * Ndef
+   *
+   * @param {NFC.NdefData} data
+   */
+  async function writeNdef(data: NFC.NdefRecord[]) {
+    if (!isNdef.value) {
+      uni.showToast({
+        title: 'NFC 标签不支持 NDEF',
+        icon: 'none',
+      });
+      return Promise.reject({
+        errMsg: 'NFC 标签不支持 NDEF',
+      });
+    }
+
+    if (!nfcInstance) {
+      uni.showToast({
+        title: '请先建立连接',
+        icon: 'none',
+      });
+      return Promise.reject({
+        errMsg: '请先建立连接',
+      });
+    }
+
+    if (!isConnected.value) {
+      uni.showToast({
+        title: '请先建立连接',
+        icon: 'none',
+      });
+      return Promise.reject({
+        errMsg: '请先建立连接',
+      });
+    }
+
+    uni.showToast({
+      title: '开始写入数据，请勿断开连接',
+      icon: 'none',
+      duration: 3000,
+    });
+
+    try {
+      const records = data?.map((item) => {
+        // const tnf = stringToArrayBuffer(item.tnf);
+        const id = item.id ? stringToArrayBuffer(item.id) : new ArrayBuffer(0);
+        const type = stringToArrayBuffer(item.type);
+
+        return {
+          tnf: item.tnf,
+          type,
+          id,
+          payload: item.payload,
+        };
+      });
+
+      if (maxTransceiveLength && maxTransceiveLength < records.length) {
+        uni.showToast({
+          title: '写入数据超出标签容量',
+          icon: 'none',
+          duration: 3000,
+        });
+        nfcInstance.close();
+
+        return Promise.reject({
+          errMsg: '写入数据超出标签容量',
+        });
+      }
+
+      // 连接 nfc
+      await connect();
+      uni.showToast({
+        title: '开始写入数据, 请勿断开连接',
+        icon: 'none',
+      });
+      // 写入数据
+
+      const result = await writeNdefMessage({
+        records,
+      });
+
+      await close();
+      uni.showToast({
+        title: '数据写入成功',
+        icon: 'none',
+        duration: 3000,
+      });
+      return Promise.resolve({
+        errMsg: '数据写入成功',
+        data: result,
+      });
+    } catch (error) {
+      uni.showToast({
+        title: '数据写入失败',
+        icon: 'none',
+        duration: 3000,
+      });
+
+      return Promise.reject({
+        errMsg: '数据写入失败',
+        error,
+      });
+    }
+  }
+
+  /**
+   *
+   *
+   * @param {string} text
+   * @param {string} [language='zh'] 微信小程序下无效
+   * @return {*}
+   */
+  async function writeNdefText(
+    text: string,
+    _language = 'zh',
+  ): Promise<{ errMsg: string }> {
+    return writeNdef([
+      {
+        tnf: 1,
+        type: 'T',
+        payload: stringToArrayBuffer(text),
+      },
+    ]);
+  }
+
+  function writeNdefUri(uri: string): Promise<{ errMsg: string }> {
+    const record = createUriNdefRecord(uri);
+    return writeNdef([record]);
+  }
+
+  function writeNdefAndroidApp(
+    packageName: string,
+  ): Promise<{ errMsg: string }> {
+    return writeNdef([
+      {
+        tnf: 4,
+        type: 'android.com:pkg',
+        payload: stringToArrayBuffer(packageName),
+      },
+    ]);
+  }
+
+  function writeNdefWifi({
+    ssid,
+    password,
+    authType,
+  }: NFC.WSCConfig): Promise<{ errMsg: string }> {
+    const mimeType = 'application/vnd.wfa.wsc';
+    const wifiData = generateWSCBytesForAndroid({
+      ssid,
+      password,
+      authType,
+    });
+    return writeNdef([
+      {
+        tnf: 2,
+        type: mimeType,
+        payload: arrayNumberToArrayBuffer(wifiData),
+      },
+    ]);
+  }
+
+  function writeNdefVcard(
+    cardInfo: NFC.VCardContactInfo,
+  ): Promise<{ errMsg: string }> {
+    const mimeType = 'text/vcard';
+    const cardString = formatCardInfo(cardInfo);
+
+    const cardData = stringToArrayBuffer(cardString);
+    return writeNdef([
+      {
+        tnf: 2,
+        type: mimeType,
+        payload: cardData,
+      },
+    ]);
+  }
+
+  onMounted(() => {
+    initNfcAdapter();
+  });
+
+  onUnmounted(() => {
+    stopHCE();
+    offHCEMessage();
+  });
+
+  return {
+    data,
+    isNdef,
+    isSupportNFC,
+    isListening,
+    isConnected,
+    nfcInstance,
+    startHCE,
+    stopHCE,
+    connect,
+    close,
+    write,
+    writeNdef,
+    writeNdefText,
+    writeNdefUri,
+    writeNdefAndroidApp,
+    writeNdefWifi,
+    writeNdefVcard,
+  };
+}