读取非接触式卡片 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 中,该停靠面板处于隐藏状态。

  1. 点击插入工具栏上的 Contactless(位于 Magnetic 旁边),或选择 Insert > Contactless Smart Card...

  2. 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 步 - 选择读卡器

  1. 在 Reader: 中,保留 Automatic (first reader with a card),或从列表中选择一台读卡器。

  2. 要刷新列表,请点击 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 存储在数据库字段中、卡片上的对象中,或同时存储在两者中。

  1. Store in database field: 选择字段,或选择 * None * 表示不使用。

  2. 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 步 - 设置卡片检测超时

  1. 在 Card detection timeout: 中,设置 eMedia Cards 等待卡片放到读卡器上或天线下方的秒数。停靠面板上显示的单位为 s。

  2. 可设置的范围为 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。它不会将该值写入数据库字段或卡片对象。

  1. 点击 Test read。

  2. 状态行先显示 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: 设置的时间后结束。

  3. 读取成功后,UID 会显示在按钮旁边的框中,状态行显示 UID [UID] ([LENGTH] bytes) on [READER]。

  4. 如果等待超时,状态行显示 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 会:

  1. 读取 UID。

  2. 填写您选择的数据库字段和/或卡片对象。

  3. 重新计算依赖该值的公式。

  4. 打印卡面。

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 版或更高版本的许可证。

  1. 选择 Tools > Options...

  2. 打开 Reports 类别。

  3. 确认 Record print activity 已开启。

  4. 查看 Last 50 events 下的记录行。

  5. 如果只想显示未成功的读取,请在 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 跟踪记录:

  1. 选择 Tools > Options...

  2. 打开 Logs 类别。

  3. 在 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 不会写入这些分类日志文件。

最后审核: 2026-11-16