vite-uni-dev-tool 1.0.0 → 1.1.0

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

@@ -1,966 +1,966 @@
-import { onMounted, onUnmounted, ref } from 'vue';
-import {
-  formatCardInfo,
-  getAndroidTechs,
-  getReadWriteStandard,
-  getSakHex,
-  getSakType,
-  getTnfDescription,
-  getTypeDescription,
-  parseAtqaAndroid,
-  parseUniversalTLV,
-  parseVCardPayload,
-  stringToBytes,
-  transformArrayBuffer,
-  wifiTLVConfig,
-  generateWSCBytesForAndroid,
-} from './utils';
-
-// 声明变量，但不立即初始化
-let NfcAdapter: any;
-let _Context: any;
-let _Tag: any;
-let Ndef: any;
-let NfcA: any;
-let NfcB: any;
-let NfcF: any;
-let NfcV: any;
-let _NdefFormat: any;
-let NdefFormatable: any;
-let MifareClassic: any;
-let MifareUltralight: any;
-let IsoDep: any;
-let Intent: any;
-let PendingIntent: any;
-let IntentFilter: any;
-let Settings: any;
-let NdefRecord: any;
-let NdefMessage: any;
-
-let INTENT_FLAGS_SINGLE_TOP: any;
-let PENDING_INTENT_FLAGS: any;
-let EXTRA_NDEF_MESSAGES: any;
-let EXTRA_ID: any;
-let EXTRA_TAG: any;
-let _TNF_MIME_MEDIA: any;
-let _ACTION_NFC_SETTINGS: any;
-
-let NFC_INTENT_FILTERS: any[] = [];
-
-const NFC_TECH_LISTS = [
-  ['android.nfc.tech.Ndef'],
-  ['android.nfc.tech.NdefFormatable'],
-  ['android.nfc.tech.IsoDep'],
-  ['android.nfc.tech.NfcA'],
-  ['android.nfc.tech.NfcB'],
-  ['android.nfc.tech.NfcF'],
-  ['android.nfc.tech.NfcV'],
-  ['android.nfc.tech.MifareClassic'],
-  ['android.nfc.tech.MifareUltralight'],
-];
-
-// 初始化 Android 类
-function initAndroidClasses() {
-  try {
-    if (NfcAdapter) return; // 避免重复初始化
-
-    NfcAdapter = plus.android.importClass('android.nfc.NfcAdapter');
-    _Context = plus.android.importClass('android.content.Context');
-    _Tag = plus.android.importClass('android.nfc.Tag');
-    Ndef = plus.android.importClass('android.nfc.tech.Ndef');
-    NfcA = plus.android.importClass('android.nfc.tech.NfcA');
-    NfcB = plus.android.importClass('android.nfc.tech.NfcB');
-    NfcF = plus.android.importClass('android.nfc.tech.NfcF');
-    NfcV = plus.android.importClass('android.nfc.tech.NfcV');
-    _NdefFormat = plus.android.importClass('android.nfc.tech.NdefFormat');
-    NdefFormatable = plus.android.importClass(
-      'android.nfc.tech.NdefFormatable',
-    );
-    MifareClassic = plus.android.importClass('android.nfc.tech.MifareClassic');
-    MifareUltralight = plus.android.importClass(
-      'android.nfc.tech.MifareUltralight',
-    );
-    IsoDep = plus.android.importClass('android.nfc.tech.IsoDep');
-    Intent = plus.android.importClass('android.content.Intent');
-    PendingIntent = plus.android.importClass('android.app.PendingIntent');
-    IntentFilter = plus.android.importClass('android.content.IntentFilter');
-    Settings = plus.android.importClass('android.provider.Settings');
-    NdefRecord = plus.android.importClass('android.nfc.NdefRecord');
-    NdefMessage = plus.android.importClass('android.nfc.NdefMessage');
-
-    INTENT_FLAGS_SINGLE_TOP = Intent.FLAG_ACTIVITY_SINGLE_TOP;
-    PENDING_INTENT_FLAGS = PendingIntent.FLAG_MUTABLE;
-
-    EXTRA_NDEF_MESSAGES = NfcAdapter.EXTRA_NDEF_MESSAGES;
-    EXTRA_ID = NfcAdapter.EXTRA_ID;
-    EXTRA_TAG = NfcAdapter.EXTRA_TAG;
-
-    _TNF_MIME_MEDIA = NdefRecord.TNF_MIME_MEDIA;
-    _ACTION_NFC_SETTINGS = Settings.ACTION_NFC_SETTINGS;
-
-    NFC_INTENT_FILTERS = [
-      NfcAdapter.ACTION_NDEF_DISCOVERED,
-      NfcAdapter.ACTION_TECH_DISCOVERED,
-      NfcAdapter.ACTION_TAG_DISCOVERED,
-    ];
-  } catch (e) {
-    console.error('Core: initAndroidClasses error', e);
-  }
-}
-
-export default function useNFCAndroid(
-  listener: NFC.Listener,
-  options?: NFC.NfcOption,
-): NFC.NfcResult {
-  /** 是否支持 nfc */
-  const isSupportNFC = ref<boolean | undefined>(false);
-  /** 是否监听中 */
-  const isListening = ref<boolean>(false);
-  /** 是否已连接 */
-  const isConnected = ref<boolean>(false);
-  /** nfc 数据 */
-  const data = ref<NFC.Result>({
-    id: new ArrayBuffer(0),
-    techs: [],
-    byteArray: [],
-    hexArray: [],
-    hexNumberArray: [],
-    hexString: '',
-  });
-
-  /** ndef 写入方式比较特殊，需要特殊处理 */
-  const isNdef = ref(false);
-
-  // 延迟获取 mainActivity，确保 plus 已就绪
-  let mainActivity: any = null;
-
-  onMounted(() => {
-    initAndroidClasses();
-    try {
-      mainActivity = plus.android.runtimeMainActivity();
-      initNfcAdapter();
-    } catch (e) {
-      console.error('Core: failed to init NFC adapter', e);
-    }
-  });
-
-  let checkInterval: any = null;
-
-  let nfcAdapter: NFC.Adapter | null = null;
-  let nfcPendingIntent: any = null;
-  let nfcTag: any = null;
-  let nfcInstance: any = null;
-
-  let maxTransceiveLength = 0;
-
-  function checkConnected() {
-    checkInterval = setInterval(() => {
-      if (!nfcAdapter) {
-        isConnected.value = false;
-        clearInterval(checkInterval);
-        return;
-      }
-
-      if (!nfcAdapter.isEnabled()) {
-        isConnected.value = false;
-        clearInterval(checkInterval);
-        return;
-      }
-      if (!nfcInstance) {
-        isConnected.value = false;
-        clearInterval(checkInterval);
-        return;
-      }
-
-      if (nfcInstance.isConnected()) {
-        isConnected.value = true;
-      } else {
-        isConnected.value = false;
-        clearInterval(checkInterval);
-      }
-    }, options?.checkConnectedDelay ?? 500);
-  }
-
-  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 NfcA.get(nfcTag);
-      case 'NFC-B':
-        return NfcB.get(nfcTag);
-      case 'NFC-F':
-        return NfcF.get(nfcTag);
-      case 'NFC-V':
-        return NfcV.get(nfcTag);
-      case 'MIFARE Classic':
-        return MifareClassic.get(nfcTag);
-      case 'MIFARE Ultralight':
-        return MifareUltralight.get(nfcTag);
-      case 'Ndef':
-        isNdef.value = true;
-        return Ndef.get(nfcTag);
-      case 'Ndef Formatable':
-        return NdefFormatable.get(nfcTag);
-      case 'ISO-DEP':
-        return IsoDep.get(nfcTag);
-      default:
-        return undefined;
-    }
-  }
-
-  function innerListener() {
-    try {
-      const intent = mainActivity.getIntent();
-      if (!intent) {
-        uni.showToast({ title: 'NFC 数据解析失败', icon: 'none' });
-        return;
-      }
-
-      // 获取id
-      const id = intent.getByteArrayExtra(EXTRA_ID);
-
-      const transform = transformArrayBuffer(id);
-
-      let techs: NFC.NfcType[] = [];
-
-      let sak = 0;
-      let sakHex = '';
-      let sakType = undefined;
-      let atqaInfo = {
-        uidType: 0,
-        storageSize: 0,
-        manufacturer: 0,
-        cardFeatures: 0,
-        reserved: 0,
-      };
-      let readWriteStandard: string[] = [];
-      let sectorCount = 0;
-      let blockCount = 0;
-      let messages: any = [];
-      nfcTag = intent.getParcelableExtra(EXTRA_TAG); // 先获取 Tag 实例
-
-      if (nfcTag) {
-        // 核心方法：通过 Tag.getTechList() 获取原生技术列表数组
-        const nativeTechList = nfcTag.getTechList();
-        // 转换为可直接使用的 string 数组（兼容原生返回格式）
-        techs = Array.isArray(nativeTechList) ? nativeTechList : [];
-
-        techs = getAndroidTechs(techs);
-
-        nfcInstance = getInstance(techs, true);
-
-        if (!nfcInstance) {
-          uni.showToast({ title: 'NFC 实例获取失败', icon: 'none' });
-          return;
-        }
-
-        // 一定要连接
-        nfcInstance?.connect?.();
-
-        if (isNdef.value) {
-          const otherInstance = getInstance(techs);
-          maxTransceiveLength = otherInstance?.getMaxTransceiveLength?.() ?? 0;
-        } else {
-          maxTransceiveLength = nfcInstance?.getMaxTransceiveLength?.() ?? 0;
-        }
-
-        readWriteStandard = getReadWriteStandard(techs);
-
-        sectorCount = nfcInstance?.getSectorCount?.();
-
-        blockCount = nfcInstance?.getBlockCount?.();
-
-        const ndefMessage = intent.getParcelableArrayExtra(EXTRA_NDEF_MESSAGES);
-
-        if (ndefMessage && ndefMessage.length > 0) {
-          let records = ndefMessage?.[0]?.getRecords?.();
-
-          records = records.map((record: any) => {
-            const idObject = record?.getId?.();
-
-            const id = idObject
-              ? plus.android.invoke(idObject, 'toString')
-              : '';
-
-            const tnfObject = record?.getTnf?.();
-            const tnf = tnfObject
-              ? plus.android.invoke(tnfObject, 'toString')
-              : '';
-            const tnfDescription = getTnfDescription(tnf);
-
-            const payloadByte = record?.getPayload?.();
-
-            const typeObject = record?.getType?.();
-            const type = typeObject
-              ? (plus.android.newObject('java.lang.String', typeObject) as any)
-              : '';
-            const typeDescription = getTypeDescription(
-              type as string,
-              payloadByte,
-            );
-
-            let payload: any = payloadByte
-              ? plus.android.newObject('java.lang.String', payloadByte)
-              : '';
-            if (type === 'application/vnd.wfa.wsc') {
-              payload = parseUniversalTLV(payloadByte, wifiTLVConfig);
-            } else if (type === 'text/vcard') {
-              payload = parseVCardPayload(payload);
-            }
-
-            return {
-              id,
-              tnf,
-              tnfDescription,
-              type,
-              typeDescription,
-              payload,
-            };
-          });
-          messages = [
-            {
-              records,
-            },
-          ];
-        } else {
-          messages = [];
-        }
-
-        if (techs.includes('NFC-A')) {
-          // NFC-A 标签的 SAK 信息
-          const nfcAInstance = NfcA.get(nfcTag);
-          const sakShortObject =
-            plus.android.invoke(nfcAInstance, 'getSak') ?? 0;
-
-          const sakStr = plus.android.invoke(sakShortObject, 'toString');
-
-          sak = Number(sakStr) || 0;
-
-          sakType = getSakType(sak);
-
-          sakHex = getSakHex(sak);
-
-          const atqa = plus.android.invoke(nfcAInstance, 'getAtqa');
-
-          atqaInfo = parseAtqaAndroid(atqa);
-        }
-      }
-
-      //  返回数据
-      data.value = {
-        ...data.value,
-        ...transform,
-        ...atqaInfo,
-        id,
-        sak,
-        sakHex,
-        sakType,
-        techs,
-        messages,
-        maxTransceiveLength,
-        readWriteStandard,
-        sectorCount,
-        blockCount,
-      };
-      // 回调通知外部
-      listener(data.value);
-      // 检查链接状态
-      checkConnected();
-
-      // 可将改行去除
-      uni?.__dev_tool_nfc_collection__?.(data.value);
-    } catch (_error) {
-      console.log('error: ', _error);
-    }
-  }
-
-  function initNfcAdapter() {
-    try {
-      if (!mainActivity) {
-        uni.showToast({ title: '无法获取主 Activity 实例', icon: 'none' });
-        return;
-      }
-
-      nfcAdapter = NfcAdapter.getDefaultAdapter(mainActivity);
-
-      // 1. 设备不支持 NFC
-      if (!nfcAdapter) {
-        isSupportNFC.value = false;
-        return;
-      }
-
-      // 2. NFC 功能未开启
-      if (!nfcAdapter.isEnabled()) {
-        isSupportNFC.value = false;
-        return;
-      }
-
-      // 3. 初始化成功，注册监听
-      isSupportNFC.value = true;
-    } catch (_error) {
-      isSupportNFC.value = false;
-    }
-  }
-
-  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 适配器 NFC',
-      });
-    }
-    //
-    if (isListening.value) {
-      uni.showToast({ title: 'NFC 监听已开启，无需重复操作', icon: 'none' });
-      return Promise.reject({
-        errMsg: 'NFC 监听已开启，无需重复操作',
-      });
-    }
-
-    try {
-      // 1. 注册 newintent 事件监听
-      plus.globalEvent.addEventListener('newintent', innerListener);
-
-      plus.globalEvent.addEventListener('resume', () => {
-        if (nfcAdapter) {
-          const filters = NFC_INTENT_FILTERS.map(
-            (filter) => new IntentFilter(filter),
-          );
-          nfcAdapter?.enableForegroundDispatch(
-            mainActivity,
-            nfcPendingIntent,
-            filters,
-            NFC_TECH_LISTS,
-          );
-        }
-      });
-
-      plus.globalEvent.addEventListener('pause', () => {
-        if (nfcAdapter) {
-          nfcAdapter?.disableForegroundDispatch(mainActivity);
-        }
-      });
-
-      // 2. 构建前台调度 PendingIntent（缓存实例，避免重复创建）
-      if (!nfcPendingIntent) {
-        const intent = new Intent(mainActivity, mainActivity.getClass());
-        intent.addFlags(INTENT_FLAGS_SINGLE_TOP);
-        nfcPendingIntent = PendingIntent.getActivity(
-          mainActivity,
-          0,
-          intent,
-          PENDING_INTENT_FLAGS,
-        );
-      }
-
-      // 3. 构建 Intent 过滤器
-      const filters = NFC_INTENT_FILTERS.map(
-        (filter) => new IntentFilter(filter),
-      );
-
-      // 4. 启用前台调度（核心：App 前台优先捕获 NFC 事件）
-      nfcAdapter?.enableForegroundDispatch(
-        mainActivity,
-        nfcPendingIntent,
-        filters,
-        NFC_TECH_LISTS,
-      );
-
-      // 5. 更新监听状态
-      isListening.value = true;
-      uni.showToast({
-        title: '开始监听NFC',
-        icon: 'none',
-      });
-      return Promise.reject({
-        errMsg: '开始监听NFC',
-      });
-    } catch (_error) {
-      uni.showToast({ title: 'NFC 监听开启失败', icon: 'none' });
-      isListening.value = false;
-      return Promise.reject({
-        errMsg: 'NFC 监听开启失败',
-      });
-    }
-  }
-
-  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 监听已关闭，无需重复操作',
-      });
-    }
-
-    try {
-      // 1. 禁用前台调度
-      nfcAdapter.disableForegroundDispatch(mainActivity);
-      // 2. 更新监听状态
-      isListening.value = false;
-      isConnected.value = false;
-      uni.showToast({
-        title: '停止监听NFC',
-        icon: 'none',
-      });
-      clearInterval(checkInterval);
-      return Promise.resolve({
-        errMsg: '停止监听NFC',
-      });
-    } catch (_error) {
-      uni.showToast({ title: 'NFC 监听停止失败', icon: 'error' });
-      return Promise.resolve({
-        errMsg: 'NFC 监听停止失败',
-        error: _error,
-      });
-    }
-  }
-
-  function connect() {
-    if (!isSupportNFC.value) {
-      uni.showToast({ title: '设备不支持 NFC', icon: 'none' });
-      return Promise.reject({
-        errMsg: '设备不支持 NFC',
-      });
-    }
-
-    if (!nfcInstance) {
-      uni.showToast({ title: '请先靠近 NFC 标签', icon: 'none' });
-      return Promise.reject({
-        errMsg: '请先靠近 NFC 标签',
-      });
-    }
-
-    if (!isListening.value) {
-      uni.showToast({ title: '请先开启前台调度监听', icon: 'none' });
-      return Promise.reject({
-        errMsg: '请先开启前台调度监听',
-      });
-    }
-
-    try {
-      checkConnected();
-      if (!nfcInstance.isConnected()) {
-        // 补充连接状态判断
-        nfcInstance.connect();
-        isConnected.value = true;
-        uni.showToast({ title: 'NFC 连接成功', icon: 'none' });
-        return Promise.resolve({
-          errMsg: 'NFC 连接成功',
-        });
-      } else {
-        isConnected.value = true;
-        uni.showToast({ title: 'NFC 已处于连接状态', icon: 'none' });
-        return Promise.reject({
-          errMsg: 'NFC 已处于连接状态',
-        });
-      }
-    } catch (error) {
-      uni.showToast({ title: 'NFC 连接失败', icon: 'none' });
-      isConnected.value = false;
-      return Promise.reject({
-        errMsg: 'NFC 连接失败',
-        error,
-      });
-    }
-  }
-
-  function close() {
-    if (!isSupportNFC.value) {
-      uni.showToast({ title: '设备不支持 NFC', icon: 'none' });
-      return Promise.reject({
-        errMsg: '设备不支持 NFC',
-      });
-    }
-
-    if (!nfcInstance) {
-      uni.showToast({ title: '无连接中的 NFC 标签', icon: 'none' });
-      return Promise.reject({
-        errMsg: '无连接中的 NFC 标签',
-      });
-    }
-
-    try {
-      if (nfcInstance.isConnected()) {
-        nfcInstance.close();
-      }
-      // 清空缓存，重置状态
-      nfcTag = null;
-      nfcInstance = null;
-      isConnected.value = false;
-      isNdef.value = false;
-      clearInterval(checkInterval);
-      uni.showToast({ title: 'NFC 连接已关闭', icon: 'none' });
-      return Promise.resolve({
-        errMsg: 'NFC 连接已关闭',
-      });
-    } catch (error) {
-      uni.showToast({ title: 'NFC 连接关闭失败', icon: 'none' });
-      return Promise.reject({
-        errMsg: 'NFC 连接关闭失败',
-        error,
-      });
-    }
-  }
-
-  function offHCEMessage() {
-    try {
-      if (!isSupportNFC.value) {
-        uni.showToast({ title: '设备不支持 NFC，无需移除监听', icon: 'none' });
-        return true;
-      }
-
-      // 1. 移除 newintent 事件监听
-      plus.globalEvent.removeEventListener('newintent', innerListener);
-
-      // 2. 停止前台调度，关闭连接
-      if (nfcAdapter && isListening.value) {
-        nfcAdapter.disableForegroundDispatch(mainActivity);
-      }
-      if (nfcInstance && nfcInstance.isConnected()) {
-        nfcInstance.close();
-      }
-
-      // 3. 清空所有缓存，重置状态
-      nfcPendingIntent = null;
-      nfcTag = null;
-      nfcInstance = null;
-      isListening.value = false;
-      isConnected.value = false;
-      isNdef.value = false;
-      clearInterval(checkInterval);
-      uni.showToast({ title: 'NFC 监听已移除', icon: 'none' });
-      return true;
-    } catch (_error) {
-      uni.showToast({ title: 'NFC 监听移除失败', icon: 'none' });
-
-      return false;
-    }
-  }
-
-  /**
-   * 确保 NFC 已连接
-   * @param checkNdef 是否检查 NDEF 支持
-   */
-  function ensureConnected(checkNdef = false) {
-    if (checkNdef && !isNdef.value) {
-      uni.showToast({ title: 'NFC 标签不支持 NDEF', icon: 'none' });
-      throw { errMsg: 'NFC 标签不支持 NDEF' };
-    }
-    if (!nfcInstance) {
-      uni.showToast({ title: '请先建立连接', icon: 'none' });
-      throw { errMsg: '请先建立连接' };
-    }
-    if (!isConnected.value) {
-      uni.showToast({ title: '请先建立连接', icon: 'none' });
-      throw { errMsg: '请先建立连接' };
-    }
-  }
-
-  /**
-   * 执行 NDEF 写入操作的通用流程
-   * @param createMessage 创建 NdefMessage 的函数
-   * @returns Promise
-   */
-  async function executeNdefWrite(createMessage: () => any) {
-    try {
-      ensureConnected(true);
-
-      uni.showToast({
-        title: '开始写入数据，请勿断开连接',
-        icon: 'none',
-        duration: 3000,
-      });
-
-      const message = createMessage();
-
-      // 容量检查
-      if (maxTransceiveLength < message.getByteArrayLength()) {
-        uni.showToast({
-          title: '写入数据超出标签容量',
-          icon: 'none',
-          duration: 3000,
-        });
-        try {
-          nfcInstance.close();
-        } catch (_e) {
-          // ignore error
-        }
-        return Promise.reject({ errMsg: '写入数据超出标签容量' });
-      }
-
-      if (nfcInstance.isWritable()) {
-        nfcInstance.writeNdefMessage(message);
-        nfcInstance.close();
-
-        uni.showToast({
-          title: '数据写入成功',
-          icon: 'none',
-          duration: 3000,
-        });
-        return Promise.resolve({ errMsg: '数据写入成功' });
-      } else {
-        uni.showToast({
-          title: 'NFC 标签不允许写入',
-          icon: 'none',
-          duration: 3000,
-        });
-        nfcInstance.close();
-        return Promise.reject({ errMsg: 'NFC 标签不允许写入' });
-      }
-    } catch (_error) {
-      uni.showToast({
-        title: '数据写入失败',
-        icon: 'none',
-        duration: 3000,
-      });
-      try {
-        nfcInstance?.close();
-      } catch (_e) {
-        // ignore error
-      }
-      return Promise.reject({ errMsg: '数据写入失败', error: _error });
-    }
-  }
-
-  /**
-   * 非 ndef 数据写入
-   *
-   * TODO: 暂时无法提供通用的写入方法
-   *
-   * @param {ArrayBuffer} writeData
-   * @return {*}
-   */
-  function write(writeData: ArrayBuffer) {
-    if (isNdef.value) {
-      uni.showToast({
-        title: 'NDEF 请勿使用该方法',
-        icon: 'none',
-      });
-      return Promise.reject({
-        errMsg: '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',
-    });
-
-    try {
-      nfcInstance.connect();
-      if (!nfcInstance.isWritable()) {
-        uni.showToast({ title: 'NFC 标签不允许写入', icon: 'none' });
-        nfcInstance.close();
-        return Promise.reject({
-          errMsg: 'NFC 标签不允许写入',
-        });
-      }
-      if (nfcInstance.getMaxTransceiveLength() < writeData.byteLength) {
-        uni.showToast({ title: '写入数据超出标签容量', icon: 'none' });
-        nfcInstance.close();
-        return Promise.reject({
-          errMsg: '写入数据超出标签容量',
-        });
-      }
-      const result = nfcInstance.transceive(writeData);
-      nfcInstance.close();
-      uni.showToast({ title: '数据写入成功', icon: 'none' });
-      return Promise.resolve({
-        errMsg: '数据写入成功',
-        data: result,
-      });
-    } catch (error) {
-      uni.showToast({ title: '数据写入失败', icon: 'none' });
-      return Promise.reject({
-        errMsg: '数据写入失败',
-        error,
-      });
-    }
-  }
-
-  /**
-   * 通用的 ndef 写入方法
-   *
-   * @param {NFC.NdefData} data
-   */
-  function writeNdef(data: NFC.NdefRecord[]) {
-    return executeNdefWrite(() => {
-      const records = data?.map((item) => {
-        const tnf = stringToBytes(item.tnf + '');
-        const id = item.id ? stringToBytes(item.id) : null;
-        const type = stringToBytes(item.type);
-
-        return new NdefRecord(tnf, type, id, item.payload);
-      });
-      return new NdefMessage(records);
-    });
-  }
-
-  /**
-   * 写入 NDEF 文本数据
-   *
-   * https://developer.android.google.cn/reference/kotlin/android/nfc/NdefRecord?hl=en#createtextrecord
-   *
-   * @param {string} text
-   * @param {string} [language='zh']
-   * @return {*}
-   */
-  function writeNdefText(text: string, language: string = 'zh') {
-    return executeNdefWrite(() => {
-      return new NdefMessage([NdefRecord.createTextRecord(language, text)]);
-    });
-  }
-
-  /**
-   *  写入 NDEF URI 数据
-   * https://developer.android.google.cn/reference/kotlin/android/nfc/NdefRecord?hl=en#createuri
-   *
-   * 会自动根据
-   * https://
-   * tel:
-   * ...
-   * 进行区分
-   *
-   * @param {string} uri
-   * @return {*}
-   */
-  function writeNdefUri(uri: string) {
-    return executeNdefWrite(() => {
-      return new NdefMessage([NdefRecord.createUri(uri)]);
-    });
-  }
-
-  /**
-   *  Android 应用包名 写入
-   *
-   * @param {string} packageName - 数据
-   * @param {string} [typeName] - 类型名称，默认为 "a" (Android Application Record)
-   * @return {*}
-   */
-  function writeNdefAndroidApp(packageName: string) {
-    return executeNdefWrite(() => {
-      // 创建 Android 应用记录 (AAR - Android Application Record)
-      const appRecord = NdefRecord.createApplicationRecord(packageName);
-      return new NdefMessage([appRecord]);
-    });
-  }
-
-  /**
-   * 写入 WiFi 配置到 NFC 标签
-   *
-   * @param {NFC.WSCConfig} { ssid, password, authType }
-   * @return {*}
-   */
-  function writeNdefWifi({ ssid, password, authType }: NFC.WSCConfig) {
-    return executeNdefWrite(() => {
-      const mimeType = 'application/vnd.wfa.wsc';
-      const wifiData = generateWSCBytesForAndroid({
-        ssid,
-        password,
-        authType,
-      });
-      const wifiRecord = NdefRecord.createMime(mimeType, wifiData);
-      return new NdefMessage([wifiRecord]);
-    });
-  }
-
-  /**
-   * 写入 vCard 数据到 NFC 标签
-   *
-   * @param {NFC.VCardContactInfo} cardInfo
-   * @return {*}
-   */
-  function writeNdefVcard(cardInfo: NFC.VCardContactInfo) {
-    return executeNdefWrite(() => {
-      const mimeType = 'text/vcard';
-      const cardString = formatCardInfo(cardInfo);
-      const cardData = stringToBytes(cardString);
-      const cardRecord = NdefRecord.createMime(mimeType, cardData);
-      return new NdefMessage([cardRecord]);
-    });
-  }
-
-  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 {
+  formatCardInfo,
+  getAndroidTechs,
+  getReadWriteStandard,
+  getSakHex,
+  getSakType,
+  getTnfDescription,
+  getTypeDescription,
+  parseAtqaAndroid,
+  parseUniversalTLV,
+  parseVCardPayload,
+  stringToBytes,
+  transformArrayBuffer,
+  wifiTLVConfig,
+  generateWSCBytesForAndroid,
+} from './utils';
+
+// 声明变量，但不立即初始化
+let NfcAdapter: any;
+let _Context: any;
+let _Tag: any;
+let Ndef: any;
+let NfcA: any;
+let NfcB: any;
+let NfcF: any;
+let NfcV: any;
+let _NdefFormat: any;
+let NdefFormatable: any;
+let MifareClassic: any;
+let MifareUltralight: any;
+let IsoDep: any;
+let Intent: any;
+let PendingIntent: any;
+let IntentFilter: any;
+let Settings: any;
+let NdefRecord: any;
+let NdefMessage: any;
+
+let INTENT_FLAGS_SINGLE_TOP: any;
+let PENDING_INTENT_FLAGS: any;
+let EXTRA_NDEF_MESSAGES: any;
+let EXTRA_ID: any;
+let EXTRA_TAG: any;
+let _TNF_MIME_MEDIA: any;
+let _ACTION_NFC_SETTINGS: any;
+
+let NFC_INTENT_FILTERS: any[] = [];
+
+const NFC_TECH_LISTS = [
+  ['android.nfc.tech.Ndef'],
+  ['android.nfc.tech.NdefFormatable'],
+  ['android.nfc.tech.IsoDep'],
+  ['android.nfc.tech.NfcA'],
+  ['android.nfc.tech.NfcB'],
+  ['android.nfc.tech.NfcF'],
+  ['android.nfc.tech.NfcV'],
+  ['android.nfc.tech.MifareClassic'],
+  ['android.nfc.tech.MifareUltralight'],
+];
+
+// 初始化 Android 类
+function initAndroidClasses() {
+  try {
+    if (NfcAdapter) return; // 避免重复初始化
+
+    NfcAdapter = plus.android.importClass('android.nfc.NfcAdapter');
+    _Context = plus.android.importClass('android.content.Context');
+    _Tag = plus.android.importClass('android.nfc.Tag');
+    Ndef = plus.android.importClass('android.nfc.tech.Ndef');
+    NfcA = plus.android.importClass('android.nfc.tech.NfcA');
+    NfcB = plus.android.importClass('android.nfc.tech.NfcB');
+    NfcF = plus.android.importClass('android.nfc.tech.NfcF');
+    NfcV = plus.android.importClass('android.nfc.tech.NfcV');
+    _NdefFormat = plus.android.importClass('android.nfc.tech.NdefFormat');
+    NdefFormatable = plus.android.importClass(
+      'android.nfc.tech.NdefFormatable',
+    );
+    MifareClassic = plus.android.importClass('android.nfc.tech.MifareClassic');
+    MifareUltralight = plus.android.importClass(
+      'android.nfc.tech.MifareUltralight',
+    );
+    IsoDep = plus.android.importClass('android.nfc.tech.IsoDep');
+    Intent = plus.android.importClass('android.content.Intent');
+    PendingIntent = plus.android.importClass('android.app.PendingIntent');
+    IntentFilter = plus.android.importClass('android.content.IntentFilter');
+    Settings = plus.android.importClass('android.provider.Settings');
+    NdefRecord = plus.android.importClass('android.nfc.NdefRecord');
+    NdefMessage = plus.android.importClass('android.nfc.NdefMessage');
+
+    INTENT_FLAGS_SINGLE_TOP = Intent.FLAG_ACTIVITY_SINGLE_TOP;
+    PENDING_INTENT_FLAGS = PendingIntent.FLAG_MUTABLE;
+
+    EXTRA_NDEF_MESSAGES = NfcAdapter.EXTRA_NDEF_MESSAGES;
+    EXTRA_ID = NfcAdapter.EXTRA_ID;
+    EXTRA_TAG = NfcAdapter.EXTRA_TAG;
+
+    _TNF_MIME_MEDIA = NdefRecord.TNF_MIME_MEDIA;
+    _ACTION_NFC_SETTINGS = Settings.ACTION_NFC_SETTINGS;
+
+    NFC_INTENT_FILTERS = [
+      NfcAdapter.ACTION_NDEF_DISCOVERED,
+      NfcAdapter.ACTION_TECH_DISCOVERED,
+      NfcAdapter.ACTION_TAG_DISCOVERED,
+    ];
+  } catch (e) {
+    console.error('Core: initAndroidClasses error', e);
+  }
+}
+
+export default function useNFCAndroid(
+  listener: NFC.Listener,
+  options?: NFC.NfcOption,
+): NFC.NfcResult {
+  /** 是否支持 nfc */
+  const isSupportNFC = ref<boolean | undefined>(false);
+  /** 是否监听中 */
+  const isListening = ref<boolean>(false);
+  /** 是否已连接 */
+  const isConnected = ref<boolean>(false);
+  /** nfc 数据 */
+  const data = ref<NFC.Result>({
+    id: new ArrayBuffer(0),
+    techs: [],
+    byteArray: [],
+    hexArray: [],
+    hexNumberArray: [],
+    hexString: '',
+  });
+
+  /** ndef 写入方式比较特殊，需要特殊处理 */
+  const isNdef = ref(false);
+
+  // 延迟获取 mainActivity，确保 plus 已就绪
+  let mainActivity: any = null;
+
+  onMounted(() => {
+    initAndroidClasses();
+    try {
+      mainActivity = plus.android.runtimeMainActivity();
+      initNfcAdapter();
+    } catch (e) {
+      console.error('Core: failed to init NFC adapter', e);
+    }
+  });
+
+  let checkInterval: any = null;
+
+  let nfcAdapter: NFC.Adapter | null = null;
+  let nfcPendingIntent: any = null;
+  let nfcTag: any = null;
+  let nfcInstance: any = null;
+
+  let maxTransceiveLength = 0;
+
+  function checkConnected() {
+    checkInterval = setInterval(() => {
+      if (!nfcAdapter) {
+        isConnected.value = false;
+        clearInterval(checkInterval);
+        return;
+      }
+
+      if (!nfcAdapter.isEnabled()) {
+        isConnected.value = false;
+        clearInterval(checkInterval);
+        return;
+      }
+      if (!nfcInstance) {
+        isConnected.value = false;
+        clearInterval(checkInterval);
+        return;
+      }
+
+      if (nfcInstance.isConnected()) {
+        isConnected.value = true;
+      } else {
+        isConnected.value = false;
+        clearInterval(checkInterval);
+      }
+    }, options?.checkConnectedDelay ?? 500);
+  }
+
+  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 NfcA.get(nfcTag);
+      case 'NFC-B':
+        return NfcB.get(nfcTag);
+      case 'NFC-F':
+        return NfcF.get(nfcTag);
+      case 'NFC-V':
+        return NfcV.get(nfcTag);
+      case 'MIFARE Classic':
+        return MifareClassic.get(nfcTag);
+      case 'MIFARE Ultralight':
+        return MifareUltralight.get(nfcTag);
+      case 'Ndef':
+        isNdef.value = true;
+        return Ndef.get(nfcTag);
+      case 'Ndef Formatable':
+        return NdefFormatable.get(nfcTag);
+      case 'ISO-DEP':
+        return IsoDep.get(nfcTag);
+      default:
+        return undefined;
+    }
+  }
+
+  function innerListener() {
+    try {
+      const intent = mainActivity.getIntent();
+      if (!intent) {
+        uni.showToast({ title: 'NFC 数据解析失败', icon: 'none' });
+        return;
+      }
+
+      // 获取id
+      const id = intent.getByteArrayExtra(EXTRA_ID);
+
+      const transform = transformArrayBuffer(id);
+
+      let techs: NFC.NfcType[] = [];
+
+      let sak = 0;
+      let sakHex = '';
+      let sakType = undefined;
+      let atqaInfo = {
+        uidType: 0,
+        storageSize: 0,
+        manufacturer: 0,
+        cardFeatures: 0,
+        reserved: 0,
+      };
+      let readWriteStandard: string[] = [];
+      let sectorCount = 0;
+      let blockCount = 0;
+      let messages: any = [];
+      nfcTag = intent.getParcelableExtra(EXTRA_TAG); // 先获取 Tag 实例
+
+      if (nfcTag) {
+        // 核心方法：通过 Tag.getTechList() 获取原生技术列表数组
+        const nativeTechList = nfcTag.getTechList();
+        // 转换为可直接使用的 string 数组（兼容原生返回格式）
+        techs = Array.isArray(nativeTechList) ? nativeTechList : [];
+
+        techs = getAndroidTechs(techs);
+
+        nfcInstance = getInstance(techs, true);
+
+        if (!nfcInstance) {
+          uni.showToast({ title: 'NFC 实例获取失败', icon: 'none' });
+          return;
+        }
+
+        // 一定要连接
+        nfcInstance?.connect?.();
+
+        if (isNdef.value) {
+          const otherInstance = getInstance(techs);
+          maxTransceiveLength = otherInstance?.getMaxTransceiveLength?.() ?? 0;
+        } else {
+          maxTransceiveLength = nfcInstance?.getMaxTransceiveLength?.() ?? 0;
+        }
+
+        readWriteStandard = getReadWriteStandard(techs);
+
+        sectorCount = nfcInstance?.getSectorCount?.();
+
+        blockCount = nfcInstance?.getBlockCount?.();
+
+        const ndefMessage = intent.getParcelableArrayExtra(EXTRA_NDEF_MESSAGES);
+
+        if (ndefMessage && ndefMessage.length > 0) {
+          let records = ndefMessage?.[0]?.getRecords?.();
+
+          records = records.map((record: any) => {
+            const idObject = record?.getId?.();
+
+            const id = idObject
+              ? plus.android.invoke(idObject, 'toString')
+              : '';
+
+            const tnfObject = record?.getTnf?.();
+            const tnf = tnfObject
+              ? plus.android.invoke(tnfObject, 'toString')
+              : '';
+            const tnfDescription = getTnfDescription(tnf);
+
+            const payloadByte = record?.getPayload?.();
+
+            const typeObject = record?.getType?.();
+            const type = typeObject
+              ? (plus.android.newObject('java.lang.String', typeObject) as any)
+              : '';
+            const typeDescription = getTypeDescription(
+              type as string,
+              payloadByte,
+            );
+
+            let payload: any = payloadByte
+              ? plus.android.newObject('java.lang.String', payloadByte)
+              : '';
+            if (type === 'application/vnd.wfa.wsc') {
+              payload = parseUniversalTLV(payloadByte, wifiTLVConfig);
+            } else if (type === 'text/vcard') {
+              payload = parseVCardPayload(payload);
+            }
+
+            return {
+              id,
+              tnf,
+              tnfDescription,
+              type,
+              typeDescription,
+              payload,
+            };
+          });
+          messages = [
+            {
+              records,
+            },
+          ];
+        } else {
+          messages = [];
+        }
+
+        if (techs.includes('NFC-A')) {
+          // NFC-A 标签的 SAK 信息
+          const nfcAInstance = NfcA.get(nfcTag);
+          const sakShortObject =
+            plus.android.invoke(nfcAInstance, 'getSak') ?? 0;
+
+          const sakStr = plus.android.invoke(sakShortObject, 'toString');
+
+          sak = Number(sakStr) || 0;
+
+          sakType = getSakType(sak);
+
+          sakHex = getSakHex(sak);
+
+          const atqa = plus.android.invoke(nfcAInstance, 'getAtqa');
+
+          atqaInfo = parseAtqaAndroid(atqa);
+        }
+      }
+
+      //  返回数据
+      data.value = {
+        ...data.value,
+        ...transform,
+        ...atqaInfo,
+        id,
+        sak,
+        sakHex,
+        sakType,
+        techs,
+        messages,
+        maxTransceiveLength,
+        readWriteStandard,
+        sectorCount,
+        blockCount,
+      };
+      // 回调通知外部
+      listener(data.value);
+      // 检查链接状态
+      checkConnected();
+
+      // 可将改行去除
+      uni?.__dev_tool_nfc_collection__?.(data.value);
+    } catch (_error) {
+      console.log('error: ', _error);
+    }
+  }
+
+  function initNfcAdapter() {
+    try {
+      if (!mainActivity) {
+        uni.showToast({ title: '无法获取主 Activity 实例', icon: 'none' });
+        return;
+      }
+
+      nfcAdapter = NfcAdapter.getDefaultAdapter(mainActivity);
+
+      // 1. 设备不支持 NFC
+      if (!nfcAdapter) {
+        isSupportNFC.value = false;
+        return;
+      }
+
+      // 2. NFC 功能未开启
+      if (!nfcAdapter.isEnabled()) {
+        isSupportNFC.value = false;
+        return;
+      }
+
+      // 3. 初始化成功，注册监听
+      isSupportNFC.value = true;
+    } catch (_error) {
+      isSupportNFC.value = false;
+    }
+  }
+
+  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 适配器 NFC',
+      });
+    }
+    //
+    if (isListening.value) {
+      uni.showToast({ title: 'NFC 监听已开启，无需重复操作', icon: 'none' });
+      return Promise.reject({
+        errMsg: 'NFC 监听已开启，无需重复操作',
+      });
+    }
+
+    try {
+      // 1. 注册 newintent 事件监听
+      plus.globalEvent.addEventListener('newintent', innerListener);
+
+      plus.globalEvent.addEventListener('resume', () => {
+        if (nfcAdapter) {
+          const filters = NFC_INTENT_FILTERS.map(
+            (filter) => new IntentFilter(filter),
+          );
+          nfcAdapter?.enableForegroundDispatch(
+            mainActivity,
+            nfcPendingIntent,
+            filters,
+            NFC_TECH_LISTS,
+          );
+        }
+      });
+
+      plus.globalEvent.addEventListener('pause', () => {
+        if (nfcAdapter) {
+          nfcAdapter?.disableForegroundDispatch(mainActivity);
+        }
+      });
+
+      // 2. 构建前台调度 PendingIntent（缓存实例，避免重复创建）
+      if (!nfcPendingIntent) {
+        const intent = new Intent(mainActivity, mainActivity.getClass());
+        intent.addFlags(INTENT_FLAGS_SINGLE_TOP);
+        nfcPendingIntent = PendingIntent.getActivity(
+          mainActivity,
+          0,
+          intent,
+          PENDING_INTENT_FLAGS,
+        );
+      }
+
+      // 3. 构建 Intent 过滤器
+      const filters = NFC_INTENT_FILTERS.map(
+        (filter) => new IntentFilter(filter),
+      );
+
+      // 4. 启用前台调度（核心：App 前台优先捕获 NFC 事件）
+      nfcAdapter?.enableForegroundDispatch(
+        mainActivity,
+        nfcPendingIntent,
+        filters,
+        NFC_TECH_LISTS,
+      );
+
+      // 5. 更新监听状态
+      isListening.value = true;
+      uni.showToast({
+        title: '开始监听NFC',
+        icon: 'none',
+      });
+      return Promise.reject({
+        errMsg: '开始监听NFC',
+      });
+    } catch (_error) {
+      uni.showToast({ title: 'NFC 监听开启失败', icon: 'none' });
+      isListening.value = false;
+      return Promise.reject({
+        errMsg: 'NFC 监听开启失败',
+      });
+    }
+  }
+
+  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 监听已关闭，无需重复操作',
+      });
+    }
+
+    try {
+      // 1. 禁用前台调度
+      nfcAdapter.disableForegroundDispatch(mainActivity);
+      // 2. 更新监听状态
+      isListening.value = false;
+      isConnected.value = false;
+      uni.showToast({
+        title: '停止监听NFC',
+        icon: 'none',
+      });
+      clearInterval(checkInterval);
+      return Promise.resolve({
+        errMsg: '停止监听NFC',
+      });
+    } catch (_error) {
+      uni.showToast({ title: 'NFC 监听停止失败', icon: 'error' });
+      return Promise.resolve({
+        errMsg: 'NFC 监听停止失败',
+        error: _error,
+      });
+    }
+  }
+
+  function connect() {
+    if (!isSupportNFC.value) {
+      uni.showToast({ title: '设备不支持 NFC', icon: 'none' });
+      return Promise.reject({
+        errMsg: '设备不支持 NFC',
+      });
+    }
+
+    if (!nfcInstance) {
+      uni.showToast({ title: '请先靠近 NFC 标签', icon: 'none' });
+      return Promise.reject({
+        errMsg: '请先靠近 NFC 标签',
+      });
+    }
+
+    if (!isListening.value) {
+      uni.showToast({ title: '请先开启前台调度监听', icon: 'none' });
+      return Promise.reject({
+        errMsg: '请先开启前台调度监听',
+      });
+    }
+
+    try {
+      checkConnected();
+      if (!nfcInstance.isConnected()) {
+        // 补充连接状态判断
+        nfcInstance.connect();
+        isConnected.value = true;
+        uni.showToast({ title: 'NFC 连接成功', icon: 'none' });
+        return Promise.resolve({
+          errMsg: 'NFC 连接成功',
+        });
+      } else {
+        isConnected.value = true;
+        uni.showToast({ title: 'NFC 已处于连接状态', icon: 'none' });
+        return Promise.reject({
+          errMsg: 'NFC 已处于连接状态',
+        });
+      }
+    } catch (error) {
+      uni.showToast({ title: 'NFC 连接失败', icon: 'none' });
+      isConnected.value = false;
+      return Promise.reject({
+        errMsg: 'NFC 连接失败',
+        error,
+      });
+    }
+  }
+
+  function close() {
+    if (!isSupportNFC.value) {
+      uni.showToast({ title: '设备不支持 NFC', icon: 'none' });
+      return Promise.reject({
+        errMsg: '设备不支持 NFC',
+      });
+    }
+
+    if (!nfcInstance) {
+      uni.showToast({ title: '无连接中的 NFC 标签', icon: 'none' });
+      return Promise.reject({
+        errMsg: '无连接中的 NFC 标签',
+      });
+    }
+
+    try {
+      if (nfcInstance.isConnected()) {
+        nfcInstance.close();
+      }
+      // 清空缓存，重置状态
+      nfcTag = null;
+      nfcInstance = null;
+      isConnected.value = false;
+      isNdef.value = false;
+      clearInterval(checkInterval);
+      uni.showToast({ title: 'NFC 连接已关闭', icon: 'none' });
+      return Promise.resolve({
+        errMsg: 'NFC 连接已关闭',
+      });
+    } catch (error) {
+      uni.showToast({ title: 'NFC 连接关闭失败', icon: 'none' });
+      return Promise.reject({
+        errMsg: 'NFC 连接关闭失败',
+        error,
+      });
+    }
+  }
+
+  function offHCEMessage() {
+    try {
+      if (!isSupportNFC.value) {
+        uni.showToast({ title: '设备不支持 NFC，无需移除监听', icon: 'none' });
+        return true;
+      }
+
+      // 1. 移除 newintent 事件监听
+      plus.globalEvent.removeEventListener('newintent', innerListener);
+
+      // 2. 停止前台调度，关闭连接
+      if (nfcAdapter && isListening.value) {
+        nfcAdapter.disableForegroundDispatch(mainActivity);
+      }
+      if (nfcInstance && nfcInstance.isConnected()) {
+        nfcInstance.close();
+      }
+
+      // 3. 清空所有缓存，重置状态
+      nfcPendingIntent = null;
+      nfcTag = null;
+      nfcInstance = null;
+      isListening.value = false;
+      isConnected.value = false;
+      isNdef.value = false;
+      clearInterval(checkInterval);
+      uni.showToast({ title: 'NFC 监听已移除', icon: 'none' });
+      return true;
+    } catch (_error) {
+      uni.showToast({ title: 'NFC 监听移除失败', icon: 'none' });
+
+      return false;
+    }
+  }
+
+  /**
+   * 确保 NFC 已连接
+   * @param checkNdef 是否检查 NDEF 支持
+   */
+  function ensureConnected(checkNdef = false) {
+    if (checkNdef && !isNdef.value) {
+      uni.showToast({ title: 'NFC 标签不支持 NDEF', icon: 'none' });
+      throw { errMsg: 'NFC 标签不支持 NDEF' };
+    }
+    if (!nfcInstance) {
+      uni.showToast({ title: '请先建立连接', icon: 'none' });
+      throw { errMsg: '请先建立连接' };
+    }
+    if (!isConnected.value) {
+      uni.showToast({ title: '请先建立连接', icon: 'none' });
+      throw { errMsg: '请先建立连接' };
+    }
+  }
+
+  /**
+   * 执行 NDEF 写入操作的通用流程
+   * @param createMessage 创建 NdefMessage 的函数
+   * @returns Promise
+   */
+  async function executeNdefWrite(createMessage: () => any) {
+    try {
+      ensureConnected(true);
+
+      uni.showToast({
+        title: '开始写入数据，请勿断开连接',
+        icon: 'none',
+        duration: 3000,
+      });
+
+      const message = createMessage();
+
+      // 容量检查
+      if (maxTransceiveLength < message.getByteArrayLength()) {
+        uni.showToast({
+          title: '写入数据超出标签容量',
+          icon: 'none',
+          duration: 3000,
+        });
+        try {
+          nfcInstance.close();
+        } catch (_e) {
+          // ignore error
+        }
+        return Promise.reject({ errMsg: '写入数据超出标签容量' });
+      }
+
+      if (nfcInstance.isWritable()) {
+        nfcInstance.writeNdefMessage(message);
+        nfcInstance.close();
+
+        uni.showToast({
+          title: '数据写入成功',
+          icon: 'none',
+          duration: 3000,
+        });
+        return Promise.resolve({ errMsg: '数据写入成功' });
+      } else {
+        uni.showToast({
+          title: 'NFC 标签不允许写入',
+          icon: 'none',
+          duration: 3000,
+        });
+        nfcInstance.close();
+        return Promise.reject({ errMsg: 'NFC 标签不允许写入' });
+      }
+    } catch (_error) {
+      uni.showToast({
+        title: '数据写入失败',
+        icon: 'none',
+        duration: 3000,
+      });
+      try {
+        nfcInstance?.close();
+      } catch (_e) {
+        // ignore error
+      }
+      return Promise.reject({ errMsg: '数据写入失败', error: _error });
+    }
+  }
+
+  /**
+   * 非 ndef 数据写入
+   *
+   * TODO: 暂时无法提供通用的写入方法
+   *
+   * @param {ArrayBuffer} writeData
+   * @return {*}
+   */
+  function write(writeData: ArrayBuffer) {
+    if (isNdef.value) {
+      uni.showToast({
+        title: 'NDEF 请勿使用该方法',
+        icon: 'none',
+      });
+      return Promise.reject({
+        errMsg: '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',
+    });
+
+    try {
+      nfcInstance.connect();
+      if (!nfcInstance.isWritable()) {
+        uni.showToast({ title: 'NFC 标签不允许写入', icon: 'none' });
+        nfcInstance.close();
+        return Promise.reject({
+          errMsg: 'NFC 标签不允许写入',
+        });
+      }
+      if (nfcInstance.getMaxTransceiveLength() < writeData.byteLength) {
+        uni.showToast({ title: '写入数据超出标签容量', icon: 'none' });
+        nfcInstance.close();
+        return Promise.reject({
+          errMsg: '写入数据超出标签容量',
+        });
+      }
+      const result = nfcInstance.transceive(writeData);
+      nfcInstance.close();
+      uni.showToast({ title: '数据写入成功', icon: 'none' });
+      return Promise.resolve({
+        errMsg: '数据写入成功',
+        data: result,
+      });
+    } catch (error) {
+      uni.showToast({ title: '数据写入失败', icon: 'none' });
+      return Promise.reject({
+        errMsg: '数据写入失败',
+        error,
+      });
+    }
+  }
+
+  /**
+   * 通用的 ndef 写入方法
+   *
+   * @param {NFC.NdefData} data
+   */
+  function writeNdef(data: NFC.NdefRecord[]) {
+    return executeNdefWrite(() => {
+      const records = data?.map((item) => {
+        const tnf = stringToBytes(item.tnf + '');
+        const id = item.id ? stringToBytes(item.id) : null;
+        const type = stringToBytes(item.type);
+
+        return new NdefRecord(tnf, type, id, item.payload);
+      });
+      return new NdefMessage(records);
+    });
+  }
+
+  /**
+   * 写入 NDEF 文本数据
+   *
+   * https://developer.android.google.cn/reference/kotlin/android/nfc/NdefRecord?hl=en#createtextrecord
+   *
+   * @param {string} text
+   * @param {string} [language='zh']
+   * @return {*}
+   */
+  function writeNdefText(text: string, language: string = 'zh') {
+    return executeNdefWrite(() => {
+      return new NdefMessage([NdefRecord.createTextRecord(language, text)]);
+    });
+  }
+
+  /**
+   *  写入 NDEF URI 数据
+   * https://developer.android.google.cn/reference/kotlin/android/nfc/NdefRecord?hl=en#createuri
+   *
+   * 会自动根据
+   * https://
+   * tel:
+   * ...
+   * 进行区分
+   *
+   * @param {string} uri
+   * @return {*}
+   */
+  function writeNdefUri(uri: string) {
+    return executeNdefWrite(() => {
+      return new NdefMessage([NdefRecord.createUri(uri)]);
+    });
+  }
+
+  /**
+   *  Android 应用包名 写入
+   *
+   * @param {string} packageName - 数据
+   * @param {string} [typeName] - 类型名称，默认为 "a" (Android Application Record)
+   * @return {*}
+   */
+  function writeNdefAndroidApp(packageName: string) {
+    return executeNdefWrite(() => {
+      // 创建 Android 应用记录 (AAR - Android Application Record)
+      const appRecord = NdefRecord.createApplicationRecord(packageName);
+      return new NdefMessage([appRecord]);
+    });
+  }
+
+  /**
+   * 写入 WiFi 配置到 NFC 标签
+   *
+   * @param {NFC.WSCConfig} { ssid, password, authType }
+   * @return {*}
+   */
+  function writeNdefWifi({ ssid, password, authType }: NFC.WSCConfig) {
+    return executeNdefWrite(() => {
+      const mimeType = 'application/vnd.wfa.wsc';
+      const wifiData = generateWSCBytesForAndroid({
+        ssid,
+        password,
+        authType,
+      });
+      const wifiRecord = NdefRecord.createMime(mimeType, wifiData);
+      return new NdefMessage([wifiRecord]);
+    });
+  }
+
+  /**
+   * 写入 vCard 数据到 NFC 标签
+   *
+   * @param {NFC.VCardContactInfo} cardInfo
+   * @return {*}
+   */
+  function writeNdefVcard(cardInfo: NFC.VCardContactInfo) {
+    return executeNdefWrite(() => {
+      const mimeType = 'text/vcard';
+      const cardString = formatCardInfo(cardInfo);
+      const cardData = stringToBytes(cardString);
+      const cardRecord = NdefRecord.createMime(mimeType, cardData);
+      return new NdefMessage([cardRecord]);
+    });
+  }
+
+  onMounted(() => {
+    initNfcAdapter();
+  });
+
+  onUnmounted(() => {
+    stopHCE();
+    offHCEMessage();
+  });
+
+  return {
+    data,
+    isNdef,
+    isSupportNFC,
+    isListening,
+    isConnected,
+    nfcInstance,
+    startHCE,
+    stopHCE,
+    connect,
+    close,
+    write,
+    writeNdef,
+    writeNdefText,
+    writeNdefUri,
+    writeNdefAndroidApp,
+    writeNdefWifi,
+    writeNdefVcard,
+  };
+}