HCE 核心概念
- Host-based Card Emulation:Android 4.4+ 引入,CPU 執行卡模擬邏輯,無需安全元件 (SE)。
- 模擬 ISO 7816-4 智能卡(APDU 指令集),適用於支付、門禁、票務、身份識別。
- 通過 AID (Application Identifier) 路由:讀卡器發送
SELECT AID,系統將對應 AID 的 APDU 轉發給注冊的 HCE 服務。
架構角色
| 角色 | 組件 | 職責 |
| 卡模擬端 | HostApduService 子類 | 聲明支援的 AID,實現 processCommandApdu() 返回響應 APDU |
| 讀卡端 | 普通 App + NfcAdapter | 啟用前台調度,IsoDep.transceive() 發送 APDU 指令 |
CardEmulation 端實現 (模擬忠誠度卡)
1. 聲明 AID 元數據 (res/xml/aid_list.xml)
<aid-filter android:name="F222222222" android:description="Sample Loyalty Card" />
2. 服務聲明 (AndroidManifest.xml)
<service android:name=".MyHostApduService" android:exported="true"
android:permission="android.permission.BIND_NFC_SERVICE">
<intent-filter>
<action android:name="android.nfc.cardemulation.action.HOST_APDU_SERVICE" />
</intent-filter>
<meta-data android:name="android.nfc.cardemulation.host_apdu_service"
android:resource="@xml/aid_list" />
</service>
3. 核心邏輯
public class MyHostApduService extends HostApduService {
private static final String TAG = "HCE_Service";
private static final byte[] SELECT_OK_SW = {(byte)0x90, (byte)0x00};
private static final String ACCOUNT = "1234567890"; // 模擬賬號
@Override
public byte[] processCommandApdu(byte[] commandApdu, Bundle extras) {
// 解析 SELECT APDU: CLA=00 INS=A4 P1=04 P2=00 Lc=xx Data=AID
if (Arrays.equals(commandApdu, BuildSelectApdu("F222222222"))) {
// 返回賬號 + 狀態字 9000
byte[] payload = ACCOUNT.getBytes(StandardCharsets.UTF_8);
byte[] response = new byte[payload.length + 2];
System.arraycopy(payload, 0, response, 0, payload.length);
response[response.length-2] = SELECT_OK_SW[0];
response[response.length-1] = SELECT_OK_SW[1];
return response;
}
return new byte[]{(byte)0x6A, (byte)0x82}; // File not found / 不支持指令
}
@Override public void onDeactivated(int reason) { /* 服務停用 */ }
// 工具方法:構建 SELECT APDU
public static byte[] BuildSelectApdu(String aid) {
// CLA=00 INS=A4 P1=04 P2=00 Lc=aid.length/2 Data=aid
return HexStringToByteArray("00A40400" + String.format("%02X", aid.length()/2) + aid);
}
// HexStringToByteArray 實現略
}
CardReader 端實現 (讀取模擬卡)
public final class CardReader {
private static final String SAMPLE_AID = "F222222222";
private static final String SELECT_APDU_HEADER = "00A40400";
private static final byte[] SELECT_OK_SW = {(byte)0x90, (byte)0x00};
public static String readCard(Tag tag) {
IsoDep isoDep = IsoDep.get(tag);
if (isoDep == null) return null;
try {
isoDep.connect();
byte[] selectApdu = BuildSelectApdu(SAMPLE_AID);
byte[] result = isoDep.transceive(selectApdu);
int len = result.length;
byte[] sw = {result[len-2], result[len-1]};
if (Arrays.equals(SELECT_OK_SW, sw)) {
String account = new String(Arrays.copyOf(result, len-2), "UTF-8");
return account; // "1234567890"
}
} catch (IOException e) { Log.e(TAG, "Communication error", e); }
return null;
}
// BuildSelectApdu 同服務端
}
啟用前台調度 (Reader 模式)
// Activity.onResume()
NfcAdapter nfc = NfcAdapter.getDefaultAdapter(this);
PendingIntent pending = PendingIntent.getActivity(this, 0, new Intent(this, getClass()).addFlags(Intent.FLAG_ACTIVITY_SINGLE_TOP), 0);
IntentFilter[] filters = new IntentFilter[] { new IntentFilter(NfcAdapter.ACTION_TECH_DISCOVERED) };
String[][] techLists = new String[][] { { IsoDep.class.getName() } };
nfc.enableForegroundDispatch(this, pending, filters, techLists);
// Activity.onPause()
nfc.disableForegroundDispatch(this);
測試驗證
- 手機 A 運行 CardEmulation App(需設為預設 NFC 支付/模擬卡應用:設置→NFC→非接觸式支付)。
- 手機 B 運行 CardReader App。
- 雙手機背靠背靠近 → Reader 顯示讀取到的賬號。
注意事項與最佳實踐
- AID 唯一性:生產環境需向 EMVCo/相關機構註冊專屬 AID(前 5 字節 RID 標識發行機構)。
- APDU 協議:嚴格遵循 ISO 7816-4,支持鏈式傳輸、安全消息、PIN 驗證等高級特性。
- 安全性:敏感密鑰存儲於 Android Keystore (TEE/StrongBox),HCE 服務僅作業務邏輯處理。
- 兼容性:Android 4.4+,需 NFC 控制器支持 HCE(絕大多數現代設備支持)。
- 低版本回退:Android 4.3- 需 SE 安全元件 (UICC/eSE),走
CardEmulation 不同路徑。