跳到主要内容

设置门卡编码器

快速设置

先选择编码器类型，再按需选择连接方式并添加编码器。 建议预留约 15 分钟。

本指南帮助你为 kiosk 或前台配置以编码器为中心的门卡编码流程。 它也涵盖了 Be-Tech Windows Agent 的设置。 除非你配置了直连 Base URL，否则 Be-Tech 默认使用 Windows Agent。 Kiosk 路由现在位于 Settings → Kiosk。

快速参考​

任务作用点击位置
Select method启用门卡编码Room Access → Keycard Encoding
Choose encoder type选择你的锁系统Encoder Type
Choose connection method直连或 Windows Agent（Saflok/Be-Tech/GreatLocks）Advanced options → Enable direct communication
Configure encoder添加服务器或凭据信息各类型对应字段
Add encoders注册带有真实 encoder ID 的物理设备Physical Encoder Devices
Choose kiosk routing控制 kiosk 专用路由规则Settings → Kiosk → Device Routing
Download Windows Agent下载 agent 的引导包Windows Agent
Check agent version查看已安装和最新版本状态Windows Agent
Update agent打开更新说明弹窗Update
Manage agent cards主卡片提供安装、更新或重装操作Windows Agent
Advanced agent actions查看日志、轮换密钥或删除 agentAdvanced options
Set encoding defaults每次发卡数量 + 过期时间Encoding Options

在哪里找到它​

Settings → Room Access → Keycard Encoding

第 1 步：选择门卡方法​

  1. 前往 Settings → Room Access。
  2. 将房卡访问方式设为 Keycard Encoding。
  3. 点击 Save。

第 2 步：选择编码器类型​

  1. 滚动到 Keycard Encoder Settings。

  2. 选择 Saflok、Be-Tech、LockSDK、GreatLocks 或 PMS Integration。

    ✓ AVA 只会保留你所选的编码器类型为启用状态。

第 3 步：选择连接方式​

  1. 在 Select Encoder Type 中打开 Advanced options。
  2. 对于 Saflok、GreatLocks 或 LockSDK，打开 Enable direct communication 以绕过 Windows Agent。
  3. 保持关闭则使用 Windows Agent（默认）。
  4. Be-Tech 默认使用 Windows Agent，除非你已经配置了直连 Base URL。
  5. PMS Integration 只使用直连，因此会跳过此步骤。

第 4 步：配置编码器系统​

Encoder Credentials 标题

如果你使用多台编码器，该区域标题会显示为 Encoder Credentials & Devices。

如果你使用 Saflok
  • Direct communication
    • 输入 PMSI Server URL、Username 和 Password。
    • PMSI 服务器必须可从互联网访问。
    • 点击 Test Connection。
  • Windows Agent
    • 仅输入 Username 和 Password。
    • PMSI URL 和连接测试由 agent 处理。
    • AVA 会持续检查 Saflok PMSI 的就绪状态，因此启动缓慢或重启后通常会自动恢复。
  • 在 Physical Encoder Devices 中添加编码器设备（需要 Encoder ID）。
  • 可选：为每个编码器设置 Location。
  • 如果多个 kiosk 共用编码器，请添加 Settings → Kiosk → Device Routing 中的路由。
如果你使用 Be-Tech
  • Direct communication
    • 输入 Be-Tech 服务的 Base URL。
    • 该服务必须可从互联网访问。
    • 输入 Hotel Name、Chain No、Workstation 和 Reader No。
    • 如果你的 Be-Tech 配置需要，请设置 Category 和 Card Type。
    • 如果保存了 Base URL，AVA 会让 Be-Tech 保持直连模式。
    • 点击 Test Connection 确认编码器有响应。
  • Windows Agent
    • 在连接到 Be-Tech 工作站的 Windows 电脑上安装 agent。
    • 输入 Hotel Name、Chain No、Workstation 和 Reader No。
    • agent 会处理本地 Be-Tech 适配器并代理厂商流量。
    • AVA 每 5 分钟会在 /check 上检查 agent。
    • 重启后状态可能需要几分钟才会更新。
    • 如果没有保存 Base URL，AVA 会回退到 Windows Agent 流程。
  • 在 Physical Encoder Devices 中添加编码器设备。
  • 如果使用多个编码器，可选添加 Settings → Kiosk → Device Routing 规则。
如果你的编码器支持电梯权限
  • Direct communication
    • 输入 Server Name（可选）、XHLSI Server IP Address 和 TCP Port。
    • 服务器必须可从互联网访问。
    • GreatLocks 每个服务器只支持一台编码器。
    • 点击 Test Connection。
  • Windows Agent
    • 服务器信息由 agent 处理，无需 IP/端口。
    • GreatLocks 每个服务器只支持一台编码器。

注意： AVA 会使用你在 Room Access 中保存的 GreatLocks 服务器记录。 如果你更新的是旧配置，请先点击 Save 再点击 Test Connection。 如果启用了库存同步，AVA 会通过活动的 agent 隧道读取建筑、楼层和房间数据。 请保持 agent 在线，以便房间列表保持最新。 如果你的编码器支持电梯权限，请打开 Enable lift access。 然后选择供应商支持的模式：

  • Room floor mapping 使用你房间映射中的建筑和楼层值。
  • Access code groups 使用 Common access codes 处理共享门或电梯分组。

AVA 每张卡只发送一种电梯选项类型。 使用 access code groups 时，AVA 会把单个数字保存为两位数代码。 你可以输入 1,2,3 或 01,02,03。 代码要保持在供应商支持的范围内。

如果你使用 LockSDK
  • Direct communication
    • 在 Physical Encoder Devices 中添加每台 LockSDK 编码器。
    • 为每台编码器输入 Encoder ID 和 Service URL。
    • 添加编码器条目后点击 Test Connection。
  • Windows Agent
    • 在 Physical Encoder Devices 中添加每台 LockSDK 编码器。
    • 为每台 LockSDK 编码器注册一个 Windows Agent。
    • agent 卡片会显示匹配的编码器和实时状态。
  • 如果使用多个编码器，可选添加 Settings → Kiosk → Device Routing 规则。
  • 对于合并房间，LockSDK 最多支持 4 个房间，并要求 RF50/Mifare lock type 5。
如果你使用 PMS Integration
  • 确保 PMS 集成处于启用状态（Cloudbeds 或 Opera）。
  • 在 Physical Encoder Devices 中，你可以：
    • 点击 Load Encoders 和 Add Selected，或者
    • 点击 Add Encoder 并输入 Encoder ID 和 PMS Encoder ID。
  • 加载后的设备会直接保留提供商的 encoder ID。
  • 使用 Active 关闭你不想使用的编码器。
路由已迁移

AVA 现在在 Settings → Kiosk → Device Routing 中管理 kiosk 路由。 Room Access 页面保留编码器设置，并在路由方面指向这里。

第 5 步：设置 kiosk 路由（可选）​

仅在 kiosk 专用路由场景下使用此部分：

  1. 前往 Settings → Kiosk。

  2. 打开 Device Routing。

  3. 打开 Enable guest selection，让客人在 kiosk 上选择编码器。

  4. 保持关闭则为每个 kiosk 添加路由规则。

  5. AVA 会将这些 kiosk 规则保存到 Mini MDM Device ID 上。

  6. 保存时，旧的设备 ID 映射会自动更新。

    ✓ 开启客人选择后，AVA 会隐藏手动路由规则。 ⚠️ 你仍然需要在 Physical Encoder Devices 中至少添加一个编码器设备。 ✓ AVA 可以直接使用 encoderId 发送编码请求，无需 kiosk 映射。

运营中的编码器选择行为​

  • 如果恰好只有一台编码器在线，AVA 会自动选择它。
  • 如果有多台编码器在线，员工必须显式选择一台。
实时在线状态

Online 表示编码器的设备和可达的 agent 隧道都处于健康状态。 只有当连接真实可用后，Status: 一行才会显示 online。 如果编码器掉线，请先修复 agent 或隧道。

第 6 步：设置 Windows Agent（仅 Windows Agent）​

如果你没有启用 Direct communication，请安装 Windows Agent：

  1. 前往 Windows Agent。

  2. 在新卡片上点击 Download Windows Agent，或在已有卡片上点击 Reinstall。

  3. 将 agent 安装到连接编码器的 Windows 电脑上。

  4. 如果卡片显示 Not connected 或 Never online，请解压下载的 zip，然后运行 download-installer.bat。

  5. 下载完成后，运行它保存的安装程序 .exe。

    ✓ agent 会在 Registered Agents 下显示状态详情。 ✓ AVA 在判断编码器是否可用时会使用这个实时状态。 ✓ 每张卡片都会显示 Installed version，并在可用时显示 Latest version。 ✓ 如果 agent 已是最新，你会看到 Latest version installed。 ✓ 如果 agent 版本过旧，请先点击 Update 再 Reinstall。

Be-Tech、Saflok、GreatLocks 和 LockSDK 都可以使用 Windows Agent。 当 agent 版本过旧时，主卡片上的 Update 会出现在 Reinstall 之前。 打开 Advanced options 可执行 View Logs、Rotate Secret 或 Delete。 Rotate Secret 现在会先打开确认对话框，然后 AVA 才会断开当前 agent。

服务控制

当你需要控制服务时，可以在 Windows Agent 托盘中使用 Start、Stop 或 Restart。 如果 Windows 请求权限，请在 UAC 提示中批准后继续。 如果你取消了提示，请重新执行操作并批准它。

版本过期时会看到什么​

你会看到： 卡片显示 Outdated，或者显示 heartbeat 没有上报安装版本。

解决方法：

  1. 点击 Update。
  2. 阅读更新弹窗。
  3. 打开 Windows Agent 应用。
  4. 点击 Check for Update。
  5. 安装提供的更新。
  6. 刷新 Settings → Room Access 并确认版本状态已更新。

LockSDK agent 卡片也会显示相同的版本状态。

第 7 步：设置编码默认值​

  1. 设置 Number of Cards to Encode（通常为 1–2）。
  2. 设置 Keycard Expiration Time（默认：11:00 AM）。 该时间会在手动编码门卡时预填到 Valid Until。

可选：展开 Advanced options 以启用 Heartbeat Monitor。

可选：将 PMS 房间映射到编码器名称​

如果你的编码器使用的房间名与 PMS 不同：

故障排查​

如果编码器没有响应或门卡无法编码，请使用完整清单：

仍然卡住？​

如果出现以下情况，请联系 success@vouch-technologies.com：

  • ❌ 编码器设置已保存，但设备仍保持离线
  • ❌ 任何房间都无法编码门卡
  • ❌ agent 在 Registered Agents 中始终不在线

建议附上：

  • 编码器类型和型号
  • Keycard Encoder Settings 截图
  • 问题开始时间