跳到主要内容

设置 Kiosk

快速设置

先创建设备行，然后在该行上使用 Enroll Device 生成 QR。 大多数团队大约 3 分钟即可完成。

本指南帮助你创建 Mini MDM 设备行、注册 Android kiosk 和浏览器设备、将它们路由到访问设备、向 kiosk 设备发起视频通话，并从 Settings → Kiosk 进行管理。 Kiosk 模式支持 Android 设备和灵活的浏览器设备。 拥有 mini_mdm:read 权限的用户可以查看 kiosk 状态。 创建记录、注册设备和执行 kiosk 操作需要 mini_mdm:manage。 Mini MDM Device ID 是每条 kiosk 记录稳定不变的行 ID。 你可以用它将物理 kiosk 对应到唯一的一条设备行。 AVA 会根据 Mini MDM Device ID 保存 kiosk 路由行。 如果你仍然保留旧的设备 ID 映射，在保存时 AVA 会保留它们。 注册流程现在从 Create Device 开始。 然后你可以选择锁定式住客 kiosk，或者灵活的浏览器设备。

前往： Settings → Kiosk

快速参考​

设置控制内容员工用途
Kiosk access permissions控制只读或管理访问决定谁可以执行设备操作
Create Device添加一个未完成的逻辑 kiosk 行在注册前预留一个槽位
Choose device setup打开锁定式或浏览器设备选择器先选择正确的设备类型
Enroll Device为单个 kiosk 行创建一次性 QR注册一个已知的设备槽位
Create locked-down device添加一台受管控的住客入住平板将设备锁定为 kiosk 模式
Create flexible browser device添加一台与浏览器配对的员工设备保留设备上的正常浏览器访问
Mini MDM Device ID显示稳定的 kiosk 行 ID跟踪某个特定 kiosk 槽位
Scope显示行类型区分 Per-device 行
Unlock Code显示当前解锁码恢复被锁定的设备
Devices list在所有页面中显示已注册设备状态检查健康状态和上次同步时间
Device routing将 kiosk 连接到访问和支付设备保持路由配置最新
Call在警告提示后向 kiosk 设备发起视频通话当员工需要帮助时联系 kiosk
Auto-refreshing…在 QR 和操作后轮询设备更新确认注册或操作结果
Device actions重启、锁定、解锁、取消注册远程控制和恢复

Kiosk 权限访问​

权限你可以做什么你不能做什么
mini_mdm:read打开 Settings → Kiosk，查看设备列表和状态创建设备、注册、显示/复制解锁码、重启、锁定、解锁、取消注册、移除、保存路由更改
mini_mdm:manage完整的 kiosk 管理权限不适用

如果你只有 mini_mdm:read，该页面仍然可用，但只能以只读模式查看。 你还会看到一条横幅，说明需要管理权限。

选择注册流程​

目标使用此操作表格中显示的范围
注册一个已知的 kiosk 槽位先 Create Device，再选择 Locked-down check-in devicePer-device
设置共享员工浏览器先 Create Device，再选择 Flexible browser deviceFlexible
移除未使用的预创建槽位在未完成注册的行上点击 RemovePer-device
注册流程

顶部卡片现在只负责开始设备创建。 你需要先在选择器里选定设备类型，然后再创建该行。 只有锁定式设备创建完成后，才能从该行生成 QR。

逐步：创建设备​

  1. 前往 Settings → Kiosk。
  2. 在注册卡片中点击 Create Device。
  3. 在 Choose device setup 中点击 Locked-down check-in device。
  4. 可选：输入类似 Front Desk 1 的标签。
  5. 点击 Create locked-down device。

✓ 你会看到一条新行，状态为 Status: Unfulfilled。 ✓ 该行会显示 Mini MDM Device ID。 ✓ 该行只会显示 Enroll Device 和 Remove。

逐步：创建灵活浏览器设备​

  1. 前往 Settings → Kiosk。
  2. 在注册卡片中点击 Create Device。
  3. 在 Choose device setup 中点击 Flexible browser device。
  4. 可选：输入类似 Front Desk Browser 的设备别名。
  5. 点击 Create flexible browser device。

✓ 你会看到一条新的浏览器设备行。 ✓ Streamliner 会提供一次性的验证链接。 ✓ 该链接会打开 AVA 前端，并包含商户 ID。 ✓ 你需要在物理浏览器设备上打开该链接以完成配对。

商户上下文

验证链接现在使用的是 AVA 前端，而不是旧的入住流程。 它包含 mid，这样 AVA 外壳可以先加载正确的商户。

逐步：注册设备​

需要恢复出厂设置

注册要求设备已恢复出厂设置。设备上的所有数据都会被清除。

  1. 将设备恢复出厂设置。
  2. 打开设备，并连续点按屏幕 6 次以打开 QR 扫描器。
  3. 在对应的行上点击 Enroll Device。
  4. 在 Enroll Device QR Code 弹窗中扫描 QR。
  5. 完成设备设置步骤。
  6. 返回 Settings → Kiosk 并点击 Refresh。

✓ 该行会变为 Status: Enrolled。 ✓ 该行现在会显示 Restart、Lock、Unlock 和 Un-enroll。 ✓ 该 QR 只能使用一次，有效期为 3 小时。

逐步：查看解锁码​

  1. 找到 Unlock Code 卡片。
  2. 点击 Show 以显示代码。
  3. 点击 Copy code 保存代码。

✓ 你会看到 “Unlock code copied”。

逐步：管理设备​

刷新列表​

  1. 点击 Devices 标题中的 Refresh。

✓ 你会看到 “Refreshed (synced X, removed Y)”。 ✓ 如果你的酒店设备很多，列表会自动加载所有页面。

重启、锁定或解锁​

  1. 找到设备行。
  2. 点击 Restart、Lock 或 Unlock。

✓ 你会看到 “Action completed”。 ✓ 页面会短暂进入 Auto-refreshing…，以确认新的设备状态。

向 kiosk 设备发起通话​

确认前请先检查

通话弹窗现在会显示琥珀色警告框。 它会提醒你，这通电话可能会打断该 kiosk 上正在进行的住客操作。

  1. 找到已注册的设备行。

  2. 点击 Call。

  3. 在弹窗中确认警告。

  4. 点击 Start call。

    ✓ Streamliner 会向该 kiosk 设备发起视频通话。 ✓ 当你需要从后台办公室联系 kiosk 时，可使用此功能。 ✓ 警告会提醒你，这可能会打断正在进行的住客操作。

取消注册设备​

取消注册会重置设备

取消注册可能会将设备恢复出厂设置。

  1. 点击 Un-enroll。
  2. 确认警告。

✓ 刷新后，设备会从列表中消失。

设备路由​

使用 Device Routing 卡片，将每台已注册的 kiosk 连接到正确的房卡访问编码器和支付终端。 已保存的路由行会使用 Mini MDM Device ID 作为规范键。 AVA 在更新旧行时，会保留现有别名、备注、编码器链接和终端链接。

  1. 滚动到 Device Routing。
  2. 确认至少有一台 kiosk 设备已注册。
  3. 展开某个设备行。
  4. 选择关联的 Room Access Encoder 和 Payment Terminals。
  5. 点击 Save mappings。

✓ 设备行会显示已关联的编码器和终端数量。 ✓ 如果还没有已注册设备，该卡片会显示空状态，而不是路由行。 ✓ 只读用户可以查看路由数据，但不能编辑或保存。

旧设备 ID 仍然显示时​

你会看到： 保存后，某一行仍然使用旧的 Android 设备 ID。

解决方法：

  1. 点击 Refresh。
  2. 再次打开同一条设备行。
  3. 再次点击 Save mappings。
  4. 确认该行现在显示 Mini MDM Device ID。

故障排查​

QR 代码无法生成​

你会看到： 点击 Enroll Device 后出现红色错误消息。

解决方法：

  1. 刷新页面。
  2. 在同一行上再次打开 Enroll Device。
  3. 如果仍然失败，请联系支持。

Devices 列表一直为空​

你会看到： 注册后仍显示 “No devices enrolled yet.”。

解决方法：

  1. 点击 Refresh。
  2. 保持页面至少打开一个自动刷新周期。
  3. 确认设备已完成设置。
  4. 如果仍然为空，再刷新一次。

Device routing 显示还没有设备​

你会看到： Device Routing 卡片显示 “No enrolled devices yet.”。

解决方法：

  1. 先注册至少一台 kiosk 设备。
  2. 在 Devices 区域点击 Refresh。
  3. 返回 Device Routing 并展开新设备行。

操作失败​

你会看到： 点击 Restart、Lock 或 Unlock 后显示 “Action failed”。

解决方法：

  1. 确认设备在线。
  2. 再试一次该操作。
  3. 刷新列表并检查状态。

通话不可用​

你会看到： Call 按钮缺失或被禁用。

解决方法：

  1. 确认该行已注册。
  2. 确认你有 mini_mdm:manage。
  3. 刷新页面并重试。

行只显示 Enroll Device 和 Remove​

你会看到： 某一行上只有 Enroll Device 和 Remove。

解决方法：

  1. 查看该行的 Status。
  2. 如果状态是 Unfulfilled，这是正常的。
  3. 点击 Enroll Device 并完成设置。
  4. 点击 Refresh，确认状态变为 Enrolled。

Kiosk 按钮被禁用​

你会看到： Create Device、Show、Copy code 或设备操作按钮被禁用。

解决方法：

  1. 确认你的角色包含 mini_mdm:manage。
  2. 如果你只有 mini_mdm:read，请让管理员更新角色权限。
  3. 权限变更后刷新页面。

Auto-refreshing 无法消失​

你会看到： Auto-refreshing… 持续显示的时间比预期更长。

解决方法：

  1. 等待 45 秒，让轮询窗口结束。
  2. 点击一次 Refresh。
  3. 如果反复出现，请检查 kiosk 设备的网络稳定性。

Unfulfilled 行始终无法注册​

你会看到： 扫描 QR 后，该行仍然保持 Unfulfilled。

解决方法：

  1. 点击 Refresh。
  2. 在同一行上再次打开 Enroll Device。
  3. 确认你使用的是正确的设备行。
  4. 如果仍然失败，请联系支持。

验证链接没有打开 AVA​

你会看到： 浏览器设备打开了错误的应用，或显示商户错误。

解决方法：

  1. 重新生成浏览器设备链接。
  2. 确认链接包含 mid=<merchantId>。
  3. 在物理浏览器设备上打开新链接。
  4. 如果仍然打开错误的流程，请联系支持。

仍然卡住？​

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

  • ❌ 多次尝试后 QR 仍然无法生成
  • ❌ 注册后设备始终不出现
  • ❌ 操作失败持续超过 10 分钟

建议附上：

  • 设备型号和序列号
  • 错误信息截图
  • 问题开始时间

相关指南​