# NFC 标签打开小程序

> 安卓微信客户端 8.0.14 开始支持，iOS 现网版本均已覆盖。

基于小程序 [URL Scheme](url-scheme)，在现有短信、邮件、网页等场景外，微信还支持通过 NFC 卡片快捷拉起小程序页面的能力。可用于智能设备的快速配网、快捷控制等场景。

该能力不受 URL Scheme 30 天有效期限制，且允许多个用户访问。

## NFC 标签格式

要实现直接打开小程序，NFC 标签需要按照以下格式写入：

NFC 标签必须是 `NFC Data Exchange Format (NDEF)` 类型，标签中需要包含两条 Record ：
- URI Record
  - Type Name Format (TNF): `0x01` (Well-Known)
  - Type: `U`
  - Payload: 小程序 [URL Scheme](url-scheme)
- [Android Application Record, AAR](https://developer.android.com/guide/topics/connectivity/nfc/nfc#aar)
  - Type Name Format (TNF): `0x04` (NFC Forum external type)
  - Type: `android.com:pkg`
  - Payload: 微信安卓包名 `com.tencent.mm`

> iOS 只识别 URI Record，安卓还需要 AAR 来指定拉起微信。

## 使用流程

### 1. 设备接入

小程序想要使用 NFC 标签打开小程序能力，首先需要接入设备，详见「[设备接入](/miniprogram/dev/framework/device/device-access)」文档。
完成接入后，开发者可获得由平台分配的 model_id 。model_id 对应一种设备类型，也是调用小程序设备能力相关接口的重要凭证。

### 2. 申请能力

设备接入审核通过后，在「小程序管理后台--功能--硬件设备--设备管理」页点击“申请设备能力”，选择“NFC 标签调起小程序”。

![](https://res.wx.qq.com/op_res/7vO4JcwwOrQ79dNptK2pnlulichCklRTmvhniGU5avNwpDXsn_vLDyIGMSzuWxEp7aVVyHJj8abHBaLeneY9rA)

### 3. 申请 URL Scheme

申请能力通过后，通过 [获取NFC的小程序scheme](/miniprogram/dev/server/API/qrcode-link/url-scheme/api_generatenfcscheme.md) 接口可以获取 NFC 场景下打开小程序任意页面的 URL Scheme 。

### 4. 开始使用

1. 准备满足要求格式的 NFC 标签。
2. 使用支持 NFC 功能的设备，安装最新版本微信客户端，靠近 NFC 标签即可打开 scheme 中对应小程序的对应页面。

## 使用限制

- 需要设备支持 NFC 方可使用。iPhone 需要 XS 及以上机型。
- 需要解锁设备后才能使用。
- 在使用系统钱包、相机，或打开飞行模式时无法使用。

## 注意事项
- 安卓可以直接打开小程序，iOS 系统需要用户额外点击一次系统的通知横幅确认。
- 安卓微信 8.0.14 以下版本能够拉起微信，但无法打开小程序。

### 5. 常见问题

#### 5.1 NFC 标签无法拉起微信（安卓）

使用 AAR 标签打开应用是安卓系统提供的能力。

如果部分设备无法拉起微信，可能有下列原因

1. 设备不支持 NFC 或 NFC 功能被关闭
1. 设备未安装微信
1. 设备设置中禁用了 NFC 拉起应用的能力

如果所有设备均无法拉起微信，可能有下列原因

1. AAR 包名写入错误或未按规定格式写入

#### 5.2 NFC 标签能拉起微信，但是未拉起小程序，或是拉起了公交卡页面

- 填入的 Scheme 无效（不完整、格式错误或已失效等）或未按规定格式写入
- 微信版本过低，建议升级后再试（安卓至少要求 8.0.14）