读取非接触式卡片 UID
本指南介绍如何在 eMedia Cards 中读取非接触式卡片的 UID(芯片返回的唯一编号),将其存储到数据库字段和/或卡片上的对象中,并打印在卡面上,或者只存储而不打印。除本指南另有说明外,以下步骤同样适用于 Windows 和 Mac。
读取非接触式 UID 是 Professional Edition 的功能。
截图将在稍后根据真实界面操作以 FHD 1920x1080 分辨率补充。截图中的服务器名称、用户名、密码和本地路径将被隐藏。
开始之前
您需要:
-
eMedia Cards Professional Edition(Windows 或 Mac)。如果您的许可证不包含此功能,在开启 Contactless 或打印时会出现下文所述的升级提示。
-
一台非接触式读卡器,或带有非接触式天线的证卡打印机(例如 Evolis Primacy 2)。桌面读卡器使用标准 PC/SC 接口。
-
一个卡片模板,处于 Design 模式,并有存储 UID 的位置:数据库字段、卡片对象(文本、条形码或 QR Code),或两者兼有。
-
此功能不适用于 Apple Wallet 模板。
已存储非接触式卡片序列号的模板仍可照常打开和保存。此功能只读取 UID,不会向芯片写入数据。
第 1 步 - 打开 Contactless 停靠面板
请在 Design 模式下操作。在 Operating mode 中,该停靠面板处于隐藏状态。
-
点击插入工具栏上的 Contactless(位于 Magnetic 旁边),或选择 Insert > Contactless Smart Card...
-
Contactless — UID 停靠面板在卡片上方打开,位置与磁条编码停靠面板相同。
工具栏按钮的名称为 Contactless。其工具提示为 Create or edit the contents of the Contactless Smart Card。
如果许可证不包含此功能,会出现标题为 eMedia Cards 的对话框:
Available with Professional Edition.
Contact your reseller for a license upgrade if required.
点击 OK。停靠面板不会打开。
截图(稍后以 FHD 1920x1080 分辨率拍摄;需遮盖服务器、用户名、密码和本地路径): Design 模式下,插入工具栏上的 Contactless 按钮处于选中状态,Contactless — UID 停靠面板在卡片上方打开。
第 2 步 - 选择读卡器
-
在 Reader: 中,保留 Automatic (first reader with a card),或从列表中选择一台读卡器。
-
要刷新列表,请点击 Reader: 右侧的按钮(工具提示:Refresh the reader list)。
选择 Automatic (first reader with a card) 时,eMedia Cards 会优先使用非接触式读卡器:即名称中包含 CL、Contactless、PICC 或 NFC 的读卡器,或者当前有非接触式卡片的读卡器。已列出但未插入的读卡器显示为 [name] (not connected)。
如果没有可用的读卡器,会显示警告:No contactless reader found. Connect a PC/SC reader, then click Refresh.
第 3 步 - 选择 UID 的存储位置
您可以将 UID 存储在数据库字段中、卡片上的对象中,或同时存储在两者中。
-
Store in database field: 选择字段,或选择 * None * 表示不使用。
-
Store in card object: 选择文本、条形码或 QR Code 对象,或选择 * None 表示不使用。对象会连同其所在的面(Front 或 Back*)一起列出。
两个列表在打开时都会刷新,因此新添加的字段和对象无需关闭停靠面板即可显示。
如果两个目标都未设置,停靠面板标题栏会显示 Not stored。在至少选择一个目标之前,Byte order: 和 Base: 保持禁用状态。
数据库字段建议使用文本字段。数字字段只能存储 4 字节及以下的 UID。如果 UID 更长,会显示以下信息:The UID is [length] bytes long. Database field "[name]" is numeric and holds UIDs of 4 bytes or less. Use a text field.
第 4 步 - 设置字节顺序和进制
Byte order: 和 Base: 位于同一行。
-
Byte order: 选择 Big endian(默认)或 Little endian。这是 UID 字节的排列顺序。
-
Base: 选择 Hexadecimal(默认)或 Decimal。这是 UID 写入字段或对象时的表示方式。
停靠面板折叠后,其标题栏会汇总显示读卡器、存储目标、字节顺序和进制。
第 5 步 - 设置卡片检测超时
-
在 Card detection timeout: 中,设置 eMedia Cards 等待卡片放到读卡器上或天线下方的秒数。停靠面板上显示的单位为 s。
-
可设置的范围为 1 到 300,默认值为 10。
所有路径都使用同一个等待时间:Test read、USB 桌面读卡器、Windows 和 Mac 上的 Evolis SDK、Windows Printers.ini 序列以及 Mac 打印队列。等待期间,文本会实时倒计时:Place a card on the reader… [SECONDS] s,例如 Place a card on the reader… 8 s。
Card detection timeout: 不是打印机配置文件中的 Contactless insertion: 设置。Contactless insertion: 只是读取前的额外延迟,在 Windows 打印机按其配置文件序列移动卡片时(不使用 SDK)使用。它不是允许检测到卡片的时间。
截图(稍后以 FHD 1920x1080 分辨率拍摄;需遮盖服务器、用户名、密码和本地路径): 停靠面板中已选择读卡器、数据库字段和卡片对象,Byte order: 和 Base: 位于同一行,Card detection timeout: 带单位 s,以及 Test read。
第 6 步 - 测试读取
Test read 用于检查读卡器能否返回 UID。它不会将该值写入数据库字段或卡片对象。
-
点击 Test read。
-
状态行先显示 Place a card on the reader…,然后实时倒计时 Place a card on the reader… [SECONDS] s,例如 Place a card on the reader… 8 s。按钮变为 Cancel。您可以点击 Cancel 停止等待;按钮会恢复为 Test read,且不会显示错误。如果没有放卡,等待会在 Card detection timeout: 设置的时间后结束。
-
读取成功后,UID 会显示在按钮旁边的框中,状态行显示 UID [UID] ([LENGTH] bytes) on [READER]。
-
如果等待超时,状态行显示 No contactless card was detected on [READER] within [SECONDS] seconds. Check that the card has a contactless chip and is placed under the antenna.([READER] 为读卡器名称,[SECONDS] 为程序等待的时长。)
如果芯片每次读取都返回不同的 UID,会出现警告:This card returns a random UID at each read. It cannot be used as a card number.
您可能还会看到以下信息:
| 信息 | 含义 |
|---|---|
| No contactless card was detected on [reader] within [n] seconds. Check that the card has a contactless chip and is placed under the antenna. | 使用 Test read 时,这是等待超时后停靠面板中显示的状态。放好卡片后再次点击 Test read。在 Test read 期间点击 Cancel 不会显示此信息。打印时,同样的文字会出现在 No contactless card detected 对话框中,对话框中有 Retry、Next card(当打印机可以移动卡片时)和 Cancel。 |
| The reader is busy. Close the other program using it, then try again. | 另一个应用程序正在使用该读卡器。 |
| The card was removed before the UID could be read. | 请将卡片保持在读卡器上,直到显示 UID。 |
| The reader did not return the card UID | 读卡器未能完成读取。请换一台读卡器,或点击刷新按钮后再次测试。 |
第 7 步 - 关闭停靠面板
点击停靠面板标题栏中的蓝色 OK 按钮。停靠面板会折叠为标题栏;此模板的 Contactless 仍保持开启。您也可以使用标题栏右侧的箭头(Collapse contactless encoding / Expand contactless encoding)。
磁条编码停靠面板也有同样的蓝色 OK 按钮(Collapse magnetic encoding)。
再次点击工具栏上的 Contactless,或再次选择 Insert > Contactless Smart Card...,即可为此模板关闭该功能。
保存模板以保留设置。停靠面板的设置会随模板一起保存。用早期版本保存的模板在打开时会自动修复。
第 8 步 - 打印卡面印有 UID 的卡片
切换到 Operating mode(左侧工具栏上的播放图标)。打开或选择要打印的记录,然后选择 File > Print > All...、Front side only...、Back side only... 或 Card only...
在 Windows 上,将使用常规打印对话框。在 Mac 上,这些命令会打开 Print 控制面板(请参阅 Print 控制面板(Mac))。
对于每张卡片,eMedia Cards 会:
-
读取 UID。
-
填写您选择的数据库字段和/或卡片对象。
-
重新计算依赖该值的公式。
-
打印卡面。
UID 可以通过 USB(PC/SC)读卡器读取,也可以通过打印机的非接触式天线读取:
-
如果开启了 Use SDK printing(在 Tools > Options... 的打印页面中),并且选择的是 Evolis 打印机,eMedia Cards 会使用 Evolis SDK 将卡片移到天线处,然后读取 UID。在 Mac 上,请在 Print 控制面板中将 Print path 设为 Direct to printer (SDK)。
-
如果不使用 SDK,eMedia Cards 会使用打印机配置文件中的非接触式命令将卡片移到天线处,然后等待读卡器。状态行可能显示 Moving the card to the contactless antenna… 您可以取消等待。在不使用 SDK 的 Evolis Primacy 2 上,使用与 Primacy 1 相同的移卡命令。等待卡片的时间使用停靠面板中的 Card detection timeout:。打印机配置文件中的 Contactless insertion: 只是读取前的额外延迟,而不是检测超时。
如果模板未开启 Contactless,打印时会显示:Turn on Contactless for this template before printing.
eMedia Cards 等待卡片期间,进度文本会实时倒计时 Place a card on the reader… [SECONDS] s,例如 Place a card on the reader… 8 s。Retry 和 Next card 会从完整的等待时间重新开始倒计时。
如果未能及时检测到非接触式卡片,会出现标题为 No contactless card detected 的对话框,显示 No contactless card was detected on [READER] within [SECONDS] seconds. Check that the card has a contactless chip and is placed under the antenna. 按钮为 Retry、Next card 和 Cancel(Windows 和 Mac 上相同)。默认按钮为 Retry。只有当此打印路径能够移动卡片时才会显示 Next card:即 Windows 和 Mac 上的 Evolis SDK,以及 Windows Printers.ini 序列。使用 USB 桌面读卡器和 Mac 打印队列(macOS print queue)时,该按钮会隐藏。
-
Retry 在同一读卡器上、对同一张卡片重新开始完整的等待。您可以根据需要多次重试。在打印机上,卡片会停留在天线处;eMedia Cards 不会退出该卡片,也不会送入新卡。
-
Next card 会拒绝当前卡片,从进卡盒送入下一张卡片到天线处,并再次读取同一条记录。该记录不会被跳过,倒计时会针对同一条记录重新开始。如果对同一条记录连续按了三次 Next card,eMedia Cards 会询问 Three cards in a row were rejected for this record. Reject another card and feed the next one? 该对话框标题为 Next card,按钮为 Yes 和 No,以免一叠有问题的卡片把进卡盒用空。
-
Cancel 会拒绝该卡片一次(在打印机路径上)。批量打印时,随后会询问 Do you want to continue printing?,按钮为 Yes 和 No,对话框标题仍为 No contactless card detected。
如果因其他原因无法读取 UID,会出现标题为 Contactless — UID 的对话框,显示 Smart card encoder error: 及原因。如果可以在没有 UID 的情况下继续,该对话框还会询问 Do you want to continue printing?,按钮为 Yes 和 No。否则只有 OK 按钮。
当所选的卡片对象不存在,或因上文未列出的其他原因读取失败时,会显示 Card rejected: the contactless UID could not be read.
第 9 步 - 只存储 UID 而不打印卡面
File > Print > Contactless Smart Card only...(在 Operating mode 中)不会打印卡面。它会读取 UID,并将其保存到您选择的数据库字段中(如果已设置字段)。
在 Windows 上,将使用常规打印对话框。在 Mac 上,它会打开与常规打印相同的 Print 控制面板(请参阅 Print 控制面板(Mac))。点击 Print 后,该作业只存储 UID。
它会读取 UID,并将格式化后的值写入:
-
当前打开的模板中的目标对象(此操作可以撤销,文档会被标记为已修改),以及
-
数据库字段(如果已设置)。该字段会保存到数据库中,方式与在记录上点击 OK 相同,记录随后返回浏览状态并显示 UID。如果无法完成保存,记录会保持在编辑状态,UID 已填入。读取失败或被取消时,不会将记录打开进行编辑。
同样会检查 Professional Edition。如果许可证不包含此功能,会出现第 1 步中所述的升级对话框,且不会存储任何内容。
Print 控制面板(Mac)
在 Mac 上,File > Print > All...、Front side only...、Back side only...、Card only... 和 Contactless Smart Card only... 都会打开 Print 控制面板。
窗口标题为 Print。它包含三个区域:
-
Printer. 选择打印机。列表下方的一行可能显示 Printer of this template、Your default printer 或 macOS default printer。打印机列表的占位文字为 Select a printer... 如果未安装任何打印机,会显示 No printers are installed on this system. 如果在未选择打印机的情况下点击 Print,会提示 Please select a printer。检查打印机期间,状态可能显示 Checking printer...,然后显示队列状态,例如 Ready、Paused、Offline、Error、Out of cards or feed problem、Printing、Cover open 或 Status unknown。在 Direct to printer (SDK) 路径下,色带信息可能显示 ~[LEFT] of [TOTAL] prints left 或 Ribbon: [PERCENT]% left。
-
Print path. 选择 Direct to printer (SDK) 或 macOS print queue。选择 macOS print queue 时,路径下方会出现说明 Bitmap only。
-
Job. 设置 Resolution(例如 Auto ([DPI] dpi) 或 [DPI] dpi)、Copies,以及可选的 Rotate 180°。Records 对当前记录显示 1 (current record),批量打印时显示 [COUNT] records。对于双面卡片,Sides 提供 Front、Back 和 Front + back。
按钮为 Print 和 Cancel。如果在作业开始前出现检查提示,提示栏标题为 Before printing [COUNT] card(s),底部显示 You can still print: press Print anyway.,按钮变为 Print anyway。
对于 Contactless Smart Card only...,控制面板外观相同。点击 Print 后,eMedia Cards 会将 UID 保存到数据库字段(如果已设置),而不打印卡面。
在活动日志中查看 UID 读取记录
每完成一次 UID 读取,都会在打印活动日志中添加一行,Windows 和 Mac 上均是如此。这包括 Test read 以及打印期间的每次读取。Retry 和 Next card 不会添加新行,而是在同一行中计数。
只有开启 Record print activity 时才会写入记录行。打印活动报告需要 Standard 版或更高版本的许可证。
-
选择 Tools > Options...
-
打开 Reports 类别。
-
确认 Record print activity 已开启。
-
查看 Last 50 events 下的记录行。
-
如果只想显示未成功的读取,请在 Show 下选择 Failed and aborted only。
非接触式记录行显示以下值:
| 列 | 值 |
|---|---|
| Kind | Contactless |
| Outcome | Success、No card、Read error 或 Cancelled |
| Record | 当前数据库记录(如有打开的记录),然后是 UID、来源和计数,以 · 分隔。例如:UID 04A1B2C3D4E5F6 · Evolis SDK · Retry 1。 |
Record 仅在成功时显示 UID [UID]。Retry [COUNT] 和 Next card [COUNT] 仅在计数大于 0 时显示。
| Outcome | 含义 |
|---|---|
| Success | 已读取 UID。 |
| No card | 在 Card detection timeout: 时间内未检测到卡片。 |
| Cancelled | 点击了 Cancel。 |
| Read error | 因其他原因读取失败,例如读卡器忙、卡片被移开或 UID 为随机值。 |
| 来源 | 读取方式 |
|---|---|
| USB reader | PC/SC 桌面读卡器,包括 Test read。 |
| Evolis SDK | 开启了 Use SDK printing 的 Evolis 打印机(Windows)。 |
| Printers.ini | 打印机配置文件中的非接触式命令(Windows)。 |
| Mac Evolis SDK | Mac 上的 Evolis 打印机。 |
非接触式记录行的 Copies 为 0,不计入份数合计。
仅在成功时存储 UID。卡片密钥、SAM 密钥和原始 UID 字节永远不会被存储。
CSV 导出
CSV 导出会在 ExtensionId 之后添加六列。列名始终为英文。
| 列 | 值 |
|---|---|
| ContactlessSource | UsbReader、EvolisSdk、PrintersIni 或 MacEvolisSdk |
| ContactlessUid | UID,按停靠面板中设置的 Byte order: 和 Base: 表示。仅在读取成功时有值。 |
| RetryCount | 点击 Retry 的次数 |
| NextCardCount | Next card 换卡的次数 |
| ContactlessDetail | success、no_card、read_error 或 cancelled |
| ContactlessMessage | 读取未成功时的简短英文原因,例如 No contactless card was detected. |
在非接触式记录行中,JobKind 为 Contactless,Outcome 为 Success、Failed 或 Aborted,PrinterName 为读卡器或打印机名称。ErrorCode 给出失败代码,例如 NO_CARD 或 READER_BUSY。
故障排除
| 问题 | 解决方法 |
|---|---|
| 出现 Available with Professional Edition. 对话框 | 读取非接触式 UID 需要 Professional Edition。点击 OK,然后升级许可证,或使用 Professional 版本的软件。 |
| 在 Apple Wallet 模板上点击 Contactless 按钮没有反应 | Apple Wallet 不支持 Contactless。请使用塑料卡片模板。 |
| No contactless reader found. Connect a PC/SC reader, then click Refresh. | 插入读卡器,必要时安装其驱动程序,然后点击 Reader: 旁边的刷新按钮。 |
| 找不到所需的读卡器,或显示 (not connected) | 点击刷新按钮。如果仍显示 (not connected),请重新连接设备。或者选择 Automatic (first reader with a card)。 |
| The reader is busy. Close the other program using it, then try again. | 关闭正在使用该读卡器的其他应用程序,然后再次尝试 Test read 或打印。 |
| 出现带有 Retry、Next card 和 Cancel 的 No contactless card detected 对话框 | 将非接触式卡片放到读卡器上或打印机天线下方,然后点击 Retry,在同一读卡器上、对同一张卡片再次等待。在打印机上,卡片会停留在天线处。Next card(如果显示该按钮)会拒绝这张卡片,并为同一条记录送入下一张卡片。连续按三次 Next card 后,eMedia Cards 会在拒绝下一张卡片前先询问。点击 Cancel 会拒绝该卡片一次;批量打印时,随后会询问 Do you want to continue printing? Test read 不会显示此对话框:超时只会显示在停靠面板的状态行中,在 Test read 期间点击 Cancel 也不会显示错误。 |
| This card returns a random UID at each read. It cannot be used as a card number. | 该芯片不提供固定的 UID。请换用其他卡片,或存储其他标识符。 |
| The UID is … bytes long. Database field "…" is numeric and holds UIDs of 4 bytes or less. Use a text field. | 在 Store in database field: 中选择文本字段,或在数字字段中使用 4 字节及以下的较短 UID。 |
| The serial number on the card can't be stored in the "…" field of the database as its type is not supported. | 选择文本字段(UID 为 4 字节及以下时,也可选择数字字段)。 |
| Turn on Contactless for this template before printing. | 在 Design 模式下开启 Contactless 并选择存储目标,然后保存,再在 Operating mode 中打印。 |
| 打印的卡面上没有显示 UID | 检查 Store in card object: 是否指向预期的对象,以及应使用 UID 的公式是否引用了该字段或对象。请先运行 Test read 确认读卡器正常。 |
| 带天线的打印机始终不把卡片送到读卡器处 | 如果您使用带 SDK 的 Evolis 打印机,请在 Tools > Options... 中勾选 Use SDK printing。如果不使用 SDK,eMedia Cards 仍会使用打印机配置文件中的非接触式命令移动卡片(在 Primacy 2 上,使用与 Primacy 1 相同的命令),然后在 Card detection timeout: 设置的时间内等待读卡器。打印机配置文件中的 Contactless insertion: 只是读取前的额外延迟。请检查线缆、打印机以及 Windows 上的 Contactless encoding 日志。 |
诊断日志(Windows)
要为技术支持捕获非接触式 UID 跟踪记录:
-
选择 Tools > Options...
-
打开 Logs 类别。
-
在 Print 组下,开启 Contactless encoding。
该选项的说明为:UID read, reader choice, and Printers.ini contactless sequences (contactlessencoding.log). Card keys are never written.
日志文件为 contactlessencoding.log,位于日志文件夹中,可通过同一页面上的 Open logs folder 打开。日志中可能包含 UID,但绝不会包含卡片密钥或 SAM 密钥。
打印等待超时时,每次点击 Retry 都会添加一行,例如 Timeout retry reader=... attempt=N(读卡器名称和尝试次数)。每次点击 Next card 会添加 Timeout next card reader=... attempt=N。点击 Cancel 会添加 Timeout cancelled 一行。
在 Mac 上,eMedia Cards 不会写入这些分类日志文件。