跳到主要内容

设置门卡编码器

快速设置

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

本指南帮助你为 kiosk 或前台配置以编码器为中心的门卡编码流程。

快速参考​

任务作用点击位置
Select method启用门卡编码Room Access → Key Card Encoding (Kiosk)
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 专用路由规则Kiosk to Encoder Routing → Enable guest selection
Download Windows Agent下载并安装 agent（仅 Windows Agent）Windows Agent
Set encoding defaults每次发卡数量 + 过期时间Encoding Options

位置​

Settings → Room Access → Key Card Encoding (Kiosk)

第 1 步：选择门卡方式​

  1. 前往 Settings → Room Access。
  2. 将房间出入方式选择为 Key Card Encoding (Kiosk)。
  3. 点击 Save。

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

  1. 滚动到 Keycard Encoder Settings。

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

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

第 3 步：选择连接方式（仅 Saflok + Be-Tech + GreatLocks）​

  1. 在 Select Encoder Type 中打开 Advanced options。
  2. 打开 Enable direct communication 可绕过 Windows Agent。
  3. 关闭该开关则使用 Windows Agent（默认）。
  4. 如果你选择 PMS Integration，此步骤会跳过。

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

编码器凭证标题

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

如果你使用 Saflok
  • Direct communication
    • 输入 PMSI Server URL、Username 和 Password。
    • PMSI 服务器必须可从互联网访问。
    • 点击 Test Connection。
  • Windows Agent
    • 仅输入 Username 和 Password。
    • PMSI URL 和连接测试由 agent 处理。
  • 在 Physical Encoder Devices 中添加编码器设备（需要 Encoder ID）。
  • 可选：为每个编码器设置 Location。
  • 如果多个 kiosk 共用编码器，请添加 Kiosk to Encoder Routing 规则（Kiosk ID 来自 Kiosk Management）。
如果你使用 Be-Tech
  • Direct communication
    • 输入 Be-Tech 服务的 Base URL。
    • 该服务必须可从互联网访问。
    • 输入 Hotel Name、Chain No、Workstation 和 Reader No。
    • 如果你的 Be-Tech 配置需要，请设置 Category 和 Card Type。
    • 点击 Test Connection 确认编码器有响应。
  • Windows Agent
    • 输入 Hotel Name、Chain No、Workstation 和 Reader No。
    • Base URL 和连接测试由 agent 处理。
  • 在 Physical Encoder Devices 中添加编码器设备。
  • 如果你使用多个编码器，可选添加 Kiosk to Encoder Routing 规则。
如果你使用 GreatLocks
  • Direct communication
    • 输入 Server Name（可选）、XHLSI Server IP Address 和 TCP Port。
    • 服务器必须可从互联网访问。
    • GreatLocks 每个服务器仅支持一台编码器。
    • 点击 Test Connection。
  • Windows Agent
    • 服务器信息由 agent 处理，无需 IP/端口。
    • GreatLocks 每个服务器仅支持一台编码器。
如果你使用 PMS Integration
  • 确保 PMS 集成已启用（Cloudbeds 或 Opera）。
  • 在 Physical Encoder Devices 中，你可以：
    • 点击 Load Encoders 和 Add Selected，或
    • 点击 Add Encoder，然后输入 Encoder ID 和 PMS Encoder ID。
  • 加载后的设备会直接保留供应商的 encoder ID。
  • 使用 Active 关闭你不想使用的编码器。

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

仅在需要 kiosk 专用路由行为时使用本节：

  1. 打开 Kiosk to Encoder Routing。

  2. 打开 Enable guest selection，允许客人在 kiosk 上选择编码器。

  3. 如果关闭该开关，则为每台 kiosk 添加 Kiosk to Encoder Routing 规则。

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

Operations 中的编码器选择行为​

  • 如果恰好只有一台编码器在线，AVA 会自动选中它。
  • 如果有多台编码器在线，员工必须明确选择一台。
在线状态说明

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

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

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

  1. 前往 Windows Agent。

  2. 点击 Download Windows Agent。

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

  4. 如果状态显示 Not connected，请解压 zip 并运行 .bat 文件。

    ✓ agent 会在 Registered Agents 中显示，并附带状态详情。 ✓ AVA 在判断某个编码器是否可用时会使用这个实时状态。

可选：打开 Advanced options 以注册更多 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 截图
  • 问题开始时间

相关指南​