跳到主要内容

门卡房间映射

快速设置

先启用映射，选择一个 PMS 房间，再输入编码器房间名。大约 5 分钟即可完成。

本指南帮助你将 PMS 房间映射到编码器系统所使用的准确房间名称。 AVA 会本地化此映射页面，因此标签和提示会跟随你选择的语言显示。

ACSHotel 房号

如果你使用 ACSHotel，请输入来自 SDK 或房间映射的精确锁号。 AVA 接受 6 到 8 位的字母数字锁号，并会原样发送。 请保留前导零，不要手动补零。

组合房间是分开的

当编码器房间名与 PMS 房间名不同时，请使用本页面。 当一个 PMS 房间需要打开多个实体房间时，请使用 Combined Rooms。 在需要编辑别名时，可从页面标题打开 Combined Rooms。 组合房间会在房间列表中显示 Combined 徽标和 Opens N rooms 标签。 如果你选择的编码器不支持多房间门卡，且已经存在别名，Combined Rooms 可能会切换为 Reset only。 切换编码器后，你可以移除旧别名，但不能为不受支持的供应商添加新的别名。

快速参考​

任务作用点击位置
启用映射打开或关闭映射Keycard Encoder Room Mapping → Enabled/Disabled
选择房间选择要映射的 PMS 房间PMS Rooms 列表
输入编码器名称保存准确的编码器房间名Encoder Room Name 字段
编辑或移除更新或删除映射Edit 或 Remove 图标
组合房间让一个 PMS 房间打开多个实体房间Set Up Combined Rooms

组合房间按钮状态​

状态你可以做什么出现条件
Full可添加、编辑和重置别名你选择的编码器支持多房间门卡
Reset only只能移除已有别名你选择的编码器不支持多房间门卡，但已有别名仍被保存
Disabled无法进行组合房间操作你选择的编码器不支持多房间门卡，且没有别名

入口位置​

Settings → Room Access → Keycard Encoder Room Mapping

需要 keycard:mapping 权限，并且房间访问方式必须是 Keycard Encoding。

第 1 步：启用房间映射​

  1. 打开 Keycard Encoder Room Mapping。

  2. 切换 Enabled。

    ✓ 房间列表会变得可用。

第 2 步：选择 PMS 房间​

  1. 如有需要，使用 Search rooms...。

  2. 在 PMS Rooms 列表中点击一个房间。

    ✓ 右侧面板会显示 Encoder Mapping for: [Room Name]。

第 3 步：输入编码器房间名​

  1. 在 Encoder Room Name 中输入编码器实际使用的名称（例如 101 或 SUITE-A）。

  2. 可选：添加 Description。

  3. 点击 Save Mapping。

    ✓ 该房间会在列表中显示为 Mapped。

如果你在设置像 306 → 306A, 306B 这样的组合房间，请映射实体目标房间。 通常不需要为 306 本身创建编码器映射。

第 4 步：编辑或移除映射​

  1. 选择一个已映射的房间。
  2. 点击 Edit 修改编码器名称，或点击 Remove 删除它。

故障排查​

房间映射已禁用​

你会看到： 房间列表是灰色的。

解决方法： 在页面顶部切换 Enabled。

没有房间显示​

你会看到： 列表为空。

解决方法： 确认 AVA 已加载 PMS 房间，并刷新页面。

没有可用的 PMS 房间​

你会看到： 显示 "No PMS rooms available yet."

解决方法：

  1. 前往 Settings → Essentials。

  2. 打开你的 PMS Integration 设置。

  3. 连接 PMS，然后返回此页面。

    ✓ AVA 会显示 PMS 房间，供你映射编码器名称。

Combined Rooms 只显示 Reset only​

你会看到： Combined Rooms 按钮只显示 Reset only。

原因： 你选择的门卡编码器不支持多房间编码，但已有别名仍然被保存。

解决方法：

  1. 打开 Combined Rooms。
  2. 移除你不再需要的旧别名。
  3. 如果你需要新的组合房间，请在 Settings → Room Access 中切换到受支持的编码器。

仍有问题？​

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

  • ❌ 映射已保存，但没有生效
  • ❌ 映射列表始终加载不到房间

建议附上：

  • 映射页面截图
  • 编码器供应商和型号
  • 问题开始时间