uniapp 微信小程序如何使用电子健康卡插件

在uniapp开发微信小程序时,如何接入和使用电子健康卡插件?需要哪些配置步骤?调用接口时有哪些注意事项?是否需要进行特殊的权限申请或资质审核?

2 回复

在uniapp中,先引入微信小程序的电子健康卡插件。在manifest.json中配置插件,然后在页面中调用wx.np.healthCard相关API,如获取健康卡信息。记得在微信公众平台申请插件权限。


在 UniApp 中使用微信小程序的电子健康卡插件,需通过以下步骤实现:

1. 申请插件并配置

  • 微信公众平台的“设置-第三方服务-插件管理”中搜索“电子健康卡”,添加插件并获取 pluginId(通常为 wx104a1a20c3f81f92)。
  • manifest.json 的微信小程序配置中添加插件声明:
    "mp-weixin": {
      "plugins": {
        "healthCard": {
          "version": "插件版本号", // 如 "1.0.0"
          "provider": "wx104a1a20c3f81f92"
        }
      }
    }
    

2. 引入插件

在需要使用插件的页面或组件中,通过 requirePlugin 引入:

const healthCardPlugin = requirePlugin('healthCard');

3. 调用插件功能

电子健康卡插件通常提供以下核心方法(具体以官方文档为准):

  • 获取电子健康卡
    healthCardPlugin.getHealthCard({
      success: (res) => {
        console.log('获取成功:', res.cardInfo);
      },
      fail: (err) => {
        console.error('获取失败:', err);
      }
    });
    
  • 展示健康卡页面(如适用):
    healthCardPlugin.showHealthCard({
      cardId: '用户健康卡ID'
    });
    

4. 注意事项

  • 权限申请:确保小程序已获得用户授权(如 scope.werun 或健康相关权限)。
  • 合规性:使用前需符合微信小程序规范及医疗卫生行业规定。
  • 测试:在真机调试中验证功能,因部分插件不支持模拟器。

示例代码(页面中使用)

<template>
  <view>
    <button @tap="getHealthCard">获取电子健康卡</button>
  </view>
</template>

<script>
export default {
  methods: {
    getHealthCard() {
      const healthCard = requirePlugin('healthCard');
      healthCard.getHealthCard({
        success: (res) => {
          uni.showToast({ title: '获取成功' });
        },
        fail: (err) => {
          uni.showToast({ title: '获取失败', icon: 'error' });
        }
      });
    }
  }
}
</script>

常见问题

  • 插件未找到:检查 manifest.json 配置是否正确,并确保项目已重启。
  • 权限错误:在 app.json 中补充所需权限声明。

建议参考微信官方文档获取最新插件接口说明。

回到顶部