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中补充所需权限声明。
建议参考微信官方文档获取最新插件接口说明。

