跳到主要内容

ACSHotel 门卡编码设置

快速设置

大多数酒店大约 15 分钟即可完成。你需要 ACSHotel 酒店 ID 和编码器详情。

本指南帮助你在 AVA 中设置 ACSHotel 门卡编码。 内容涵盖编码器记录、kiosk 路由、Windows Agent 和测试卡。 ACSHotel 现在像 Be-Tech 一样使用共享 Windows Agent 路由。 你不需要为每个编码器创建一个独立的 agent 卡片。

ACSHotel 锁号

请使用来自房间映射或 ACSHotel SDK 的精确锁号。 AVA 接受 6 到 8 位的字母数字锁号，并会原样发送。 不要补零，也不要移除前导零。

仅限 Windows Agent

ACSHotel 在动态模式下使用 Windows Agent 套件。 只有在 ACSHotel 安装程序要求本地服务 URL 时，才使用直连。

快速参考​

设置项控制内容设置位置
Hotel ID将 AVA 连接到你的 ACSHotel 物业ACSHotel Configuration
USB / proUSB选择读卡器模式ACSHotel Configuration
Card defaults设置卡号、DAI、蜂鸣器和解锁行为ACSHotel Configuration
Encoder record注册与同一个 Windows Agent 共享的 ACSHotel 编码器Physical Encoder Devices
Service URL仅用于直连模式Encoder details
Enable guest selection允许住客在 kiosk 上选择编码器Kiosk to Encoder Routing
Kiosk routing将 kiosk 映射到特定编码器Kiosk to Encoder Routing
Windows Agent下载并注册本地 agent 套件Windows Agent
Test Connection检查第一个已配置的编码器ACSHotel Configuration

入口位置​

Settings → Room Access → Keycard Encoding

第 1 步：选择 ACSHotel​

  1. 前往 Settings → Room Access。

  2. 选择 Keycard Encoding。

  3. 将编码器类型选为 ACSHotel。

  4. 点击 Save。

    ✓ AVA 会显示 ACSHotel 已被选中。

第 2 步：设置 ACSHotel 详情​

  1. 打开 ACSHotel Configuration。

  2. 输入你的 Hotel ID。

  3. 将 USB 或 proUSB 设为与你的读卡器一致。

  4. 输入 ACSHotel 团队提供的卡片默认值。

  5. 保持解锁和蜂鸣器设置与硬件匹配。

  6. 点击 Save。

    ✓ AVA 会在保存前检查酒店 ID。

USB 模式

如果 ACSHotel 要求 USB 模式，请将 0 用于 USB、1 用于 proUSB。

第 3 步：添加每个编码器设备​

  1. 打开 Physical Encoder Devices。

  2. 为每个 ACSHotel 设备添加一条编码器记录。

  3. 为每个设备取一个清晰的 Name。

  4. 如果员工需要更清楚的标签，请添加 Location。

  5. 如果你使用直连，请添加 Service URL。

  6. 点击 Save。

    ✓ 当一个 Windows Agent 需要服务多个编码器时，每个 ACSHotel 设备都可以包含多个编码器 ID。

LockSDK 仍然一对一

LockSDK 仍然要求每个设备只对应一个编码器 ID。 请让每个 LockSDK 编码器独占一个 Windows Agent 注册。

共享 ACSHotel 路由

一个 Windows Agent 可以处理多个 ACSHotel 编码器。

直连

只有在 ACSHotel 需要直连时，才使用本地 Service URL。 该 URL 必须能从连接到编码器的电脑访问到。

第 4 步：选择路由行为​

  1. 打开 Kiosk to Encoder Routing。

  2. 如果希望住客在 kiosk 上选择编码器，请打开 Enable guest selection。

  3. 如果希望员工手动分配 kiosk，请保持关闭。

  4. 手动路由时，请从 Kiosk Management 添加 kiosk ID。

  5. 点击 Save。

    ✓ 开启住客选择后，AVA 会隐藏路由表。 ✓ 关闭住客选择后，路由表控制 kiosk 行为。

第 5 步：设置 Windows Agent​

  1. 前往 Windows Agent。

  2. 点击 Download Windows Agent 创建 agent 注册。

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

  4. 如果 agent 已存在，请改用 Reinstall。

  5. 打开 Advanced options 查看日志、轮换密钥或删除。

    ✓ agent 注册后，AVA 会在当前 ACSHotel 设置下显示一张 Windows Agent 卡片。 ✓ 直连会绕过 Windows Agent 区域。

第 6 步：测试连接和门卡​

  1. 返回 ACSHotel Configuration。

  2. 点击 Test Connection。

  3. 打开一条测试预订并编码一张门卡。

  4. 在门上试刷该门卡。

    ✓ AVA 会测试第一个已配置的编码器。 ✓ 正确的房间应该可以开门。

故障排查​

酒店 ID 被拒绝​

你会看到： AVA 不保存酒店 ID，或者测试立即失败。

解决方法：

  1. 确认酒店 ID 与你的 ACSHotel 物业一致。
  2. 删除多余空格。
  3. 再次保存设置。
  4. 再运行一次 Test Connection。

编码器没有出现​

你会看到： 编码器没有出现在 Physical Encoder Devices 中，或者路由始终为空。

解决方法：

  1. 先至少添加一条编码器记录。
  2. 如果你使用直连，请添加 Service URL。
  3. 重新保存编码器。
  4. 刷新 Settings → Room Access。

Windows Agent 一直离线​

你会看到： agent 显示未连接，或者下载按钮一直返回。

解决方法：

  1. 确认 Windows 电脑可以访问 ACSHotel 服务。
  2. 重新安装 Windows Agent 套件。
  3. 检查 agent 是否运行在编码器电脑上。
  4. 刷新 Settings → Room Access。

测试门卡失败​

你会看到： 卡片写入成功，但门无法打开。

解决方法：

  1. 确认 USB 或 proUSB 与读卡器一致。
  2. 检查 ACSHotel 提供的卡片默认值。
  3. 确认房间映射与 ACSHotel 锁号一致。
  4. 再试一张新的空白卡。

未检测到有效卡片​

你会看到： AVA 返回 -3，并显示 "No valid card detected on reader."。

原因： 编码开始前，读卡器没有检测到有效的 ACSHotel 卡片标记。

解决方法：

  1. 开始编码前先把卡片完全放到读卡器上。
  2. 在 AVA 完成写卡前保持卡片静止。
  3. 如果同样提示再次出现，请换一张卡试试。
  4. 确认读卡器处于正确的 USB 或 proUSB 模式。

锁号被拒绝​

你会看到： AVA 或 Windows Agent 拒绝了房间映射的锁号。

解决方法：

  1. 确认锁号长度为 6 到 8 个字符。
  2. 锁号中只保留字母和数字。
  3. 使用 ACSHotel SDK 的精确值，包括前导零。
  4. 保存映射前移除任何手动补零。

仍有问题？​

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

  • ❌ ACSHotel 编码器始终无法连接
  • ❌ 在确认设置后，测试卡仍然失败
  • ❌ AVA 报告缺少 ACSHotel DLL

建议附上：

  • ACSHotel 酒店 ID
  • ACSHotel Configuration 截图
  • 问题开始时间