HCE卡模拟开发

于 2025-05-13 16:16:30 发布
阅读量1.4k 收藏 7
点赞数 30
分类专栏： HarmonyOS 文章标签： HarmonyOS
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/hidescold/article/details/147927486
版权

HarmonyOS 5.0.3(15) 版本的配套文档，该版本API能力级别为API 15 Release

文章目录

在这里插入图片描述
在这里插入图片描述

近场通信(Near Field Communication，NFC)是一种短距高频的无线电技术，在13.56MHz频率运行，通信距离一般在10厘米距离内。HCE(Host Card Emulation)，称为基于主机的卡模拟，表示不依赖安全单元芯片，电子设备上的应用程序模拟NFC卡片和NFC读卡器通信，实现NFC刷卡业务。

场景介绍

应用程序模拟NFC卡片，和NFC读卡器通信完成NFC刷卡业务。从使用场景上，可以分成HCE应用前台刷卡，和HCE应用后台刷卡。

  • HCE应用前台刷卡

前台刷卡是指在触碰NFC读卡器之前，用户先在电子设备上打开特定的应用程序，用户明确想使用所打开的应用程序和NFC读卡器进行刷卡操作。用户打开应用程序在前台，并且进入应用的刷卡页面之后，电子设备触碰NFC读卡器，只会把刷卡交易数据分发给前台应用。

  • HCE应用后台刷卡

后台刷卡是指不打开特定的HCE应用程序，电子设备触碰NFC读卡器后，根据NFC读卡器选择的应用ID（AID）匹配到HCE应用程序，并自动和匹配的HCE应用程序通信完成刷卡交易。如果匹配到多个HCE应用程序时，说明存在冲突，需要用户打开指定的应用才能完成刷卡。

  • HCE应用刷卡的约束条件

  1. 不管是HCE应用前台还是后台刷卡，能够完成HCE应用程序NFC刷卡的条件是电子设备需要亮屏解锁。

  2. module.json5文件中需要声明nfc卡模拟权限，具体见示例。

  3. 前台应用时需要调用start和stop注册和去注册AID，具体见示例。

接口说明

NFC卡模拟完整的JS API说明以及实例代码请参考：NFC卡模拟接口。

完成HCE卡模拟功能，可能使用到下面的接口。

接口名功能描述
start(elementName: ElementName, aidList: string[]): void启动HCE业务功能。包括设置当前应用为前台优先，动态注册AID列表。
stop(elementName: ElementName): void停止HCE业务功能。包括取消APDU数据接收的订阅，退出当前应用前台优先，释放动态注册的AID列表。
on(type: ‘hceCmd’, callback: AsyncCallback<number[]>): void订阅回调，用于接收对端读卡设备发送的APDU数据。
transmit(response: number[]): Promise发送APDU数据到对端读卡设备。

开发步骤

HCE应用前台刷卡

  1. 在module.json5文件中声明NFC卡模拟权限，以及声明HCE特定的action。
  2. import需要的NFC卡模拟模块和其他相关的模块。
  3. 判断设备是否支持NFC能力和HCE能力。
  4. 使能前台HCE应用程序优先处理NFC刷卡功能。
  5. 订阅HCE APDU数据的接收。
  6. 完成HCE刷卡APDU数据的接收和发送。
  7. 退出应用程序NFC刷卡页面时，退出前台优先功能。
    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ts",
        "description": "$string:EntryAbility_desc",
        "icon": "$media:icon",
        "label": "$string:EntryAbility_label",
        "startWindowIcon": "$media:icon",
        "startWindowBackground": "$color:start_window_background",
        "exported": true,
        "skills": [
          {
            "entities": [
              "entity.system.home"
            ],
            "actions": [
              "action.system.home",


              // actions须包含"ohos.nfc.cardemulation.action.HOST_APDU_SERVICE"
              "ohos.nfc.cardemulation.action.HOST_APDU_SERVICE"
            ]
          }
        ]
      }
    ],
    "requestPermissions": [
      {
        // 添加使用nfc卡模拟需要的权限
        "name": "ohos.permission.NFC_CARD_EMULATION",
        "reason": "$string:app_name",
      }
    ]

import { cardEmulation } from '@kit.ConnectivityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { AsyncCallback } from '@kit.BasicServicesKit';
import { AbilityConstant, UIAbility, Want, bundleManager } from '@kit.AbilityKit';


let hceElementName: bundleManager.ElementName;
let hceService: cardEmulation.HceService;


const hceCommandCb : AsyncCallback<number[]> = (error : BusinessError, hceCommand : number[]) => {
  if (!error) {
    if (hceCommand == null || hceCommand == undefined) {
      hilog.error(0x0000, 'testTag', 'hceCommandCb has invalid hceCommand.');
      return;
    }
    // check the command, then transmit the response.
    hilog.info(0x0000, 'testTag', 'hceCommand = %{public}s', JSON.stringify(hceCommand));
    let responseData = [0x90, 0x00]; // change the response depend on different received command.
    hceService.transmit(responseData).then(() => {
      hilog.info(0x0000, 'testTag', 'hceService transmit Promise success.');
    }).catch((err: BusinessError) => {
      hilog.error(0x0000, 'testTag', 'hceService transmit Promise error = %{public}s', JSON.stringify(err));
    });
  } else {
    hilog.error(0x0000, 'testTag', 'hceCommandCb error %{public}s', JSON.stringify(error));
  }
}


export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');


    // 判断设备是否支持NFC能力和HCE能力
    if (!canIUse("SystemCapability.Communication.NFC.Core")) {
      hilog.error(0x0000, 'testTag', 'nfc unavailable.');
      return;
    }
    if (!cardEmulation.hasHceCapability()) {
      hilog.error(0x0000, 'testTag', 'hce unavailable.');
      return;
    }


    hceElementName = {
      bundleName: want.bundleName ?? '',
      abilityName: want.abilityName ?? '',
      moduleName: want.moduleName,
    }
    hceService = new cardEmulation.HceService();
  }


  onForeground() {
    // Ability has brought to foreground
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onForeground');
    if (hceElementName != undefined) {
      try {
        // 调用接口使能前台HCE应用程序优先处理NFC刷卡功能
        let aidList = ["A0000000031010", "A0000000031011"]; // change aid tobe correct.
        hceService.start(hceElementName, aidList);


        // 订阅HCE APDU数据的接收
        hceService.on('hceCmd', hceCommandCb);
      } catch (error) {
        hilog.error(0x0000, 'testTag', 'hceService.start error = %{public}s', JSON.stringify(error));
      }
    }
  }


  onBackground() {
    // Ability has back to background
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onBackground');
    // 退出应用程序NFC标签页面时，调用tag模块退出前台优先功能
    if (hceElementName != undefined) {
      try {
        hceService.stop(hceElementName);
      } catch (error) {
        hilog.error(0x0000, 'testTag', 'hceService.stop error = %{public}s', JSON.stringify(error));
      }
    }
  }
}

HCE应用后台刷卡

  1. 在module.json5文件中声明NFC卡模拟权限，声明HCE特定的action，声明应用能够处理的AID。
  2. import需要的NFC卡模拟模块和其他相关的模块。
  3. 判断设备是否支持NFC能力和HCE能力。
  4. 订阅HCE APDU数据的接收。
  5. 完成HCE刷卡APDU数据的接收和发送。
  6. 退出应用程序时，退出订阅功能。
    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ts",
        "description": "$string:EntryAbility_desc",
        "icon": "$media:icon",
        "label": "$string:EntryAbility_label",
        "startWindowIcon": "$media:icon",
        "startWindowBackground": "$color:start_window_background",
        "exported": true,
        "skills": [
          {
            "entities": [
              "entity.system.home"
            ],
            "actions": [
              "action.system.home",


              // Add the nfc card emulation action to filter out for this application.
              "ohos.nfc.cardemulation.action.HOST_APDU_SERVICE"
            ]
          }
        ],
        "metadata": [
          {
            "name": "payment-aid",
            "value": "A0000000031010" // change it tobe correct
          },
          {
            "name": "other-aid",
            "value": "A0000000031011" // change it tobe correct
          }
        ]
      }
    ],
    "requestPermissions": [
      {
        // Add the permission for nfc card emulation.
        "name": "ohos.permission.NFC_CARD_EMULATION",
        "reason": "$string:app_name",
      }
    ]

import { cardEmulation } from '@kit.ConnectivityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { AsyncCallback } from '@kit.BasicServicesKit';
import { AbilityConstant, UIAbility, Want, bundleManager } from '@kit.AbilityKit';


let hceElementName : bundleManager.ElementName;
let hceService: cardEmulation.HceService;


const hceCommandCb : AsyncCallback<number[]> = (error : BusinessError, hceCommand : number[]) => {
  if (!error) {
    if (hceCommand == null || hceCommand == undefined) {
      hilog.error(0x0000, 'testTag', 'hceCommandCb has invalid hceCommand.');
      return;
    }


    // check the command, then transmit the response.
    hilog.info(0x0000, 'testTag', 'hceCommand = %{public}s', JSON.stringify(hceCommand));
    let responseData = [0x90, 0x00]; // change the response depend on different received command.
    hceService.transmit(responseData).then(() => {
      hilog.info(0x0000, 'testTag', 'hceService transmit Promise success.');
    }).catch((err: BusinessError) => {
      hilog.error(0x0000, 'testTag', 'hceService transmit Promise error = %{public}s', JSON.stringify(err));
    });
  } else {
    hilog.error(0x0000, 'testTag', 'hceCommandCb error %{public}s', JSON.stringify(error));
  }
}


export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam) {
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onCreate');


    // 判断设备是否支持NFC能力和HCE能力
    if (!canIUse("SystemCapability.Communication.NFC.Core")) {
      hilog.error(0x0000, 'testTag', 'nfc unavailable.');
      return;
    }
    if (!cardEmulation.hasHceCapability()) {
      hilog.error(0x0000, 'testTag', 'hce unavailable.');
      return;
    }


    hceElementName = {
      bundleName: want.bundleName ?? '',
      abilityName: want.abilityName ?? '',
      moduleName: want.moduleName,
    }
    hceService = new cardEmulation.HceService();
    hceService.on('hceCmd', hceCommandCb);
  }


  onForeground() {
    // Ability has brought to foreground
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onForeground');
  }


  onDestroy() {
    // Ability has back to destroy
    hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onDestroy');
    // 退出应用程序NFC标签页面时，调用tag模块退出前台优先功能
    if (hceElementName != undefined) {
      try {
        hceService.stop(hceElementName);
      } catch (error) {
        hilog.error(0x0000, 'testTag', 'hceService.stop error = %{public}s', JSON.stringify(error));
      }
    }
  }
}

在这里插入图片描述

HCE卡模拟开发指南
RZer的博客
03-10 1215
近场通信(Near Field Communication，NFC)是一种短距高频的无线电技术，在13.56MHz频率运行，通信距离一般在10厘米距离内。HCE(Host Card Emulation)，称为基于主机的卡模拟，表示不依赖安全单元芯片，电子设备上的应用程序模拟NFC卡片和NFC读卡器通信，实现NFC刷卡业务。应用程序模拟NFC卡片，和NFC读卡器通信完成NFC刷卡业务。从使用场景上，可以分成HCE应用前台刷卡，和HCE应用后台刷卡。HCE应用前台刷卡。
鸿蒙（HarmonyOS NEXT）开发实战：HCE卡模拟开发指南
wewqeqwrqw的博客
09-13 1283
应用程序模拟NFC卡片，和NFC读卡器通信完成NFC刷卡业务。从使用场景上，可以分成HCE应用前台刷卡，和HCE应用后台刷卡。
鸿蒙开发（NEXT/API 12）【HCE卡模拟开发】网络篇
鸿蒙的技术博客
10-09 762
近场通信(Near Field Communication，NFC)是一种短距高频的无线电技术，在13.56MHz频率运行，通信距离一般在10厘米距离内。HCE(Host Card Emulation)，称为基于主机的卡模拟，表示不依赖安全单元芯片，电子设备上的应用程序模拟NFC卡片和NFC读卡器通信，实现NFC刷卡业务。
鸿蒙开发（API 12 Beta6版）【HCE卡模拟开发】 网络篇
鸿蒙的技术博客
09-10 1064
近场通信(Near Field Communication，NFC)是一种短距高频的无线电技术，在13.56MHz频率运行，通信距离一般在10厘米距离内。HCE(Host Card Emulation)，称为基于主机的卡模拟，表示不依赖安全单元芯片，电子设备上的应用程序模拟NFC卡片和NFC读卡器通信，实现NFC刷卡业务。
Android基于HCE实现模拟Ndef格式的标签卡
scyangwei的专栏
05-25 1883
当前Android NFC手机基本都能支持基于Host的卡模拟(HCE)，其实现原理上需要读卡端和模拟端互相通过校验特定AID来实现通信，这个特性就让手机模拟的普通HCE卡无法被其他手机上通用的NFC三方APP直接读取到数据，比如NFC手机通过HCE模拟出一张银行卡，只有对该HCE银行卡AID 支持的POS机或特殊定制APP才可以与该HCE 银行卡通信，完成交易。7.2 另一个支持NFC功能的手机安装NFC tool pro APP，背靠背读取另一台手机的ndef数据。，NFC三方APP基本可以直接读取。
android的nfc卡模拟开发
weixin_34400525的博客
04-22 912
这是andorid官方文档对于卡模拟方式的描述： https://developer.android.google.cn/guide/topics/connectivity/nfc/hce 有两种方式： 1、基于SE芯片的卡模拟方式 2、基于主机的卡模拟方式 HCE卡模拟方式支持的协议如下： 转载于:https://www.cnblogs.com/geekj/p/...
微信小程序 NFC HCE卡模拟
热门推荐
lambert_Lei的专栏
03-29 3万+
需要实现带模拟一张智能卡（门禁卡或者其他业务卡），使用带NFC设备根据指定协议进行读取模拟卡数据（效果图如下）： 1. 模拟卡设计 这里使用设备自带NFC模拟卡（HCE）模式，模拟出一张虚拟卡，类似华为钱包，applepay钱包等。选择添加的卡，提供读取。 1.1 数据包交互协议 类TLV数据包格式，及Tag Length Value（和银联IC卡返回数据协议类似）。......
Android-AndroidNFC任意模拟卡工具HCE
gitblog_06762的博客
04-29 237
Android-AndroidNFC任意模拟卡工具HCE 【下载地址】Android-AndroidNFC任意模拟卡工具HCE 这款开源工具是一款强大的Android NFC模拟卡应用，支持在Android设备上模拟多种NFC卡片，适用于各类NFC功能测试与开发。其界面简洁直观，操作简便，同时具备高度可定制性，能够满足不...
android NFC HCE读与模拟卡
gitblog_06726的博客
04-12 796
android NFC HCE读与模拟卡 【下载地址】androidNFCHCE读与模拟卡 这是一个基于Android平台的NFC HCE开发项目，提供了一套精简的代码，支持Android 4.4及以上版本的设备。项目包含两大核心模块：**cardEmulation**用于将手机模拟成NFC卡片，供其他设备读取；**ca...
安卓基于NFC的HCE读卡与模拟卡功能
03-17
本主题将深入探讨基于NFC的HCE（Host Card Emulation）技术，它是如何实现读卡与模拟卡功能的。对于Android开发者，尤其是对NFC感兴趣的，这部分知识至关重要。 **1. NFC技术概述** NFC是一种短距离无线通信技术，...
富文本编辑器开发：Vue3+TipTap核心功能实现.pdf
05-14
文档支持目录章节跳转同时还支持阅读器左侧大纲显示和章节快速定位，文档内容完整、条理清晰。文档内所有文字、图表、函数、目录等元素均显示正常，无任何异常情况，敬请您放心查阅与使用。文档仅供学习参考，请勿用作商业用途。 Vue 3是一款备受瞩目的JavaScript框架，它采用了基于Proxy的响应式系统，显著提升了性能和调试能力。其Composition API带来了更高效的逻辑组织方式，使代码复用变得轻而易举。Tree-shaking支持让打包后的文件体积更小，进一步优化了应用性能。Vue 3还与TypeScript深度集成，提供了更完善的类型推导，让开发过程更加顺畅。无论是构建大型应用还是小型项目，Vue 3都能凭借其出色的性能和灵活的架构，帮助开发者高效完成任务，是现代Web开发的理想选择。
分类：多类别分类.pdf
05-14
分类、阈值、混淆矩阵、准确率、召回率、精确率等教程和代码
基于OAuth2+SpringSecurity+Jwt实现身份认证和权限管理后端服务代码合集
05-14
基于OAuth2+SpringSecurity+Jwt实现身份认证和权限管理后端服务代码合集
用visio制作基本流程图.pptx
05-14
Visio学习相关文档
手绘风格小动物素材教学课件模板.pptx
最新发布
05-14
手绘风格小动物素材教学课件模板
【计算机视觉】OpenCV高频面试题解析：涵盖图像处理、特征提取与目标检测技术要点
05-14
内容概要：本文档《opencv高频面试题.docx》涵盖了OpenCV的基础概念、图像处理操作、特征提取与匹配、目标检测与机器学习、实际编程题、性能优化以及进阶问题。首先介绍了OpenCV作为开源计算机视觉库，支持图像/视频处理、目标检测、机器学习等领域，应用于安防、自动驾驶、医学影像、AR/VR等方面。接着详细讲述了图像的存储格式（如Mat类）、通道的概念及其转换方法。在图像处理部分，讲解了图像灰度化、二值化、边缘检测等技术。特征提取方面，对比了Harris和Shi-Tomasi角点检测算法，以及SIFT、SURF、ORB的特征提取原理和优缺点。目标检测部分介绍了Haar级联检测原理，并阐述了如何调用深度学习模型进行目标检测。文档还提供了几个实际编程题示例，如读取并显示图像、图像旋转、绘制矩形框并保存等。最后，探讨了性能优化的方法，如使用cv2.UMat（GPU加速）、减少循环等，以及相机标定、光流等进阶问题。 适合人群：对计算机视觉有一定兴趣，具备一定编程基础的学习者或从业者。 使用场景及目标：①帮助学习者掌握OpenCV的基本概念和技术；②为面试准备提供参考；③为实际项目开发提供技术指导。 阅读建议：由于内容涵盖广泛，建议读者根据自身需求有选择地深入学习相关章节，并结合实际编程练习加深理解。
PowerPDF for Delphi FS.7z
05-14
PowerPDF for Delphi 完整源码版 PowerPdf is a VCL component to create PDF docment visually. Like Forms, you can design PDF document easily on Delphi IDE.
机器翻译应用：Vue3+Transformer模型整合.pdf
05-14
文档支持目录章节跳转同时还支持阅读器左侧大纲显示和章节快速定位，文档内容完整、条理清晰。文档内所有文字、图表、函数、目录等元素均显示正常，无任何异常情况，敬请您放心查阅与使用。文档仅供学习参考，请勿用作商业用途。 Vue 3是一款备受瞩目的JavaScript框架，它采用了基于Proxy的响应式系统，显著提升了性能和调试能力。其Composition API带来了更高效的逻辑组织方式，使代码复用变得轻而易举。Tree-shaking支持让打包后的文件体积更小，进一步优化了应用性能。Vue 3还与TypeScript深度集成，提供了更完善的类型推导，让开发过程更加顺畅。无论是构建大型应用还是小型项目，Vue 3都能凭借其出色的性能和灵活的架构，帮助开发者高效完成任务，是现代Web开发的理想选择。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

RZer

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值