跳到主要内容

Android 自助终端设置

快速设置

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

本指南帮助你创建 Mini MDM 设备行，并注册 Android 自助终端和浏览器设备。 其中也介绍 iPhone 和 iPad 自助终端、文档摄像头默认设置以及设备级覆盖设置。 当设备提供摄像头朝向选项时，AVA 会使用你选择的朝向。 仅限本地使用的 iOS 场景请使用 Guided Access。 受监管的 iOS 自助终端请使用专用注册。 使用 Device Routing 管理房间访问编码器和支付终端。 自助终端模式支持 Android 设备、灵活的浏览器设备和 iOS 设备。 拥有 mini_mdm:read 的用户可以查看自助终端状态。 创建设备行、注册设备和执行自助终端操作需要 mini_mdm:manage。 更改浏览器设备的入住模式还需要 settings:write。 Mini MDM Device ID 是每条自助终端记录的稳定行 ID。 用它将一台实体自助终端对应到唯一的设备行。 AVA 会根据 Mini MDM Device ID 保存自助终端路由行。 如果你仍然保留旧的设备 ID 映射，保存时 AVA 会继续保留它们。 注册流程现在从 Create Device 开始。 然后选择锁定式住客自助终端、灵活的浏览器设备或 iOS 流程。

前往： Settings → Kiosk

快速参考​

设置控制内容员工用途
Kiosk access permissions控制只读或管理访问决定谁可以执行设备操作
Create Device添加未完成的逻辑自助终端行在注册前预留槽位
Choose device setup打开锁定式、浏览器或 iOS 选择器先选择正确的设备类型
Enroll Device为单个自助终端行创建一次性 QR注册一个已知设备槽位
Create locked-down device添加受管控的住客入住平板将设备锁定为自助终端模式
Create flexible browser device添加与浏览器配对的员工设备保留设备上的正常浏览器访问
Check-in mode选择 CCI 或 ACI，并重新生成浏览器链接打开所需的入住流程
iOS Guided Access显示 AVA Check-in 的本地设置教程在不使用 MDM 的情况下准备 iPhone 或 iPad
Dedicated Device Enrollment添加受监管的 iPhone 或 iPad 行通过 Apple Business Manager 管理 iOS
Setup在 iOS 行上启动 ADE 或自助终端设置完成 iPhone/iPad 配置
Verify and continue在锁定模式前检查已安装应用恢复卡住的应用安装
Setup status显示 ADE、应用和锁定进度跟踪 iOS 配置
Mini MDM Device ID显示稳定的自助终端行 ID跟踪特定自助终端槽位
Scope显示行类型区分 Per-device 行
Unlock Code显示当前解锁码恢复被锁定的设备
Device mode显示自助终端或普通手机模式确认请求的 Android 策略及已应用的策略
Devices list显示所有页面中的已注册设备状态检查健康状态和上次同步
Device routing将自助终端连接到房间访问编码器和支付终端保持路由最新
Call在警告提示后向自助终端发起视频通话员工需要帮助时联系自助终端
Auto-refreshing…在 QR 和操作后轮询设备更新确认注册或操作结果
Device actions重启、锁定、解锁、取消注册远程控制和恢复
Document camera defaults设置手机和平板扫描的第一摄像头保持不同自助终端类型的扫描一致
Connected devices统计灵活浏览器设备的活动浏览器连接数发现重复浏览器配对
Pairing code无需商户专属 URL 即可连接浏览器使用八位字符配对浏览器

设置文档摄像头默认值​

使用 Document scanner camera 设置 AVA 打开文档扫描时的第一摄像头。 分别为 Phone 和 Tablet and larger 选择默认值。 受管控的自助终端可以继承这些默认值，也可以按设备覆盖。

  1. 前往 Settings → Kiosk。

  2. 在 Document scanner camera 中选择 Phone default。

  3. 选择 Tablet and larger default。

  4. 点击 Save camera defaults。

    ✓ AVA 会保存用于文档扫描的物业默认值。

自助终端覆盖如何工作

在受管控的自助终端上，Use device-class default 会保留物业默认值。 选择 Back camera 或 Front camera 可为该自助终端覆盖设置。 如果首选摄像头不可用，AVA 会使用它能访问到的任何摄像头。 在同时具备前后摄像头的手机上，AVA 会在扫描开始时遵循所选朝向。

Android 精简用户代理

某些 Android 手机会在 Chrome 中隐藏 Mobile token。 AVA 会检查这些设备的最短屏幕边。 低于 768 CSS px 的手机会使用 Phone default。 更大的屏幕会保留 Tablet and larger default。

更改何时生效

自助终端会在刷新配置或重启扫描器后采用新设置。 当前扫描会话会继续运行。

摄像头选择仍然不对​

你会看到： 保存后，自助终端仍然打开旧摄像头。

解决方法：

  1. 刷新自助终端配置。

  2. 重启该设备上的扫描器。

  3. 再试一次扫描。

    ✓ 自助终端应该会使用新的默认值或覆盖设置。

自助终端权限访问​

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

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

选择注册流程​

目标使用此操作表格中显示的范围
注册一个已知的自助终端槽位先 Create Device，再选择 Locked-down check-in devicePer-device
设置共享员工浏览器先 Create Device，再选择 Flexible browser deviceFlexible
设置受监管的 iPhone 或 iPad先 Create Device，再选择 iOS → Dedicated Device EnrollmentPer-device
在 iPhone 或 iPad 上使用 Guided AccessHow to enroll → iOS → Guided Access仅本地
移除未使用的预创建槽位在未完成注册的行上点击 RemovePer-device
注册流程

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

iOS 注册

Guided Access 只保留在本地设备上。 专用注册使用 Apple Business Manager 和 Vouch MDM。

逐步：创建锁定式设备​

  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。
  6. 配对对话框打开后，选择 Self Check-In (CCI) 或 Assisted Check-In (ACI)。
  7. 选择 Connect with code、Scan QR code 或 Verification link。
  8. 按照配对浏览器中的对应步骤操作。

✓ 你会看到一条新的浏览器设备行。 ✓ 对话框会显示所选模式和配对方式。 ✓ 代码和 QR 会将浏览器连接到所选酒店和自助终端。 ✓ 对支持的恢复流程，验证链接会继续可用。

配对指定的浏览器

每个浏览器自助终端只能有一个活动的浏览器设备。 请在将要运行此自助终端的浏览器上使用代码或 QR。 如需更换浏览器，请在配对替换设备前确认 Replace device。

商户上下文

设置地址无需商户专属 URL 即可打开。 配对代码会解析已配置的酒店、自助终端和入住模式。 公开配对不会授予其他 AVA 功能的访问权限。 在完成配对期间，设置页面仍然可用。

配对浏览器​

请选择最适合实体浏览器的配对方式。

方式你要做什么适用于
Connect with code复制并打开设置地址，然后输入八位字符代码无法扫描 QR 的浏览器
Scan QR code复制并打开设置地址，然后扫描显示的 QR附近有平板或手机摄像头
Verification link在指定浏览器上打开生成的链接同一浏览器恢复或支持的旧版流程

设置地址是通用的浏览器注册页面。 它会显示在代码和 QR 操作旁边。 在任一选项卡中使用 Copy setup address，然后在实体自助终端浏览器上打开。 设置地址本身不会选择酒店或自助终端。 选择配对方式后，AVA 会在面板完成加载期间保持该方式处于选中状态。

使用代码连接​

  1. 在配对对话框中选择 Copy setup address。

  2. 在实体浏览器上打开复制的地址。

  3. 输入 Settings → Kiosk 中显示的八位字符代码。

  4. 提交代码。

    ✓ 浏览器会打开该自助终端保存的 CCI 或 ACI 模式。

代码会在 10 分钟后过期。 如果代码过期或你重新生成配对详情，请生成新代码。

扫描 QR 码​

  1. 在配对对话框中选择 Copy setup address。

  2. 在实体浏览器上打开复制的地址。

  3. 选择 Scan QR code。

  4. 扫描 Settings → Kiosk 中显示的 QR。

    ✓ 浏览器会打开该自助终端保存的 CCI 或 ACI 模式。

QR 会在 24 小时后过期。 请使用 AVA 显示的最新 QR。

  1. 在配对对话框中选择 Verification link。

  2. 选择 Copy link 或 Download QR。

  3. 在指定浏览器上打开链接，或扫描其 QR。

    ✓ AVA 会将浏览器与所选酒店和自助终端配对。

保存的自助终端模式决定结果。 更改 URL 文本不能在 CCI 和 ACI 之间切换浏览器。

配对方式意外更改​

你会看到： 选择其他方式后，配对面板返回 Connect with code。

解决方法：

  1. 刷新 Settings → Kiosk。

  2. 再次打开配对对话框。

  3. 选择 Scan QR code 或 Verification link。

  4. 继续使用所选方式。

    ✓ 在配对详情加载期间，所选方式会保持打开。

保持浏览器所有权一致​

AVA 会将每个灵活浏览器设备关联到一个浏览器安装实例。 这样可以防止另一台计算机意外操作同一个自助终端。

情况结果你应该做什么
首次配对浏览器成为自助终端所有者。继续使用该浏览器。
在同一浏览器上重新验证自助终端保持连接。生成新链接并在该浏览器上打开。
在另一浏览器上打开新的配对AVA 会要求明确确认替换。仅针对预期替换确认 Replace device。
再次提交已使用的代码或 QRAVA 会拒绝已消费的配对尝试。从 Settings → Kiosk 生成新的代码或 QR。
更换实体浏览器受信任的替换验证会授权更换。确认替换，然后配对新浏览器。

如果 AVA 发现旧版重复绑定，最新一次成功配对会成为权威绑定。 旧的重复绑定会被清除，不再解析到该自助终端。

每个灵活浏览器设备会在其设备行中显示 Connected devices。 该计数包括同一浏览器安装实例的活动、已验证浏览器连接。 计数大于一表示该浏览器已与多个浏览器设备行配对。

存在重复连接时，AVA 会用红色突出显示计数。 页面还会显示 Affected browser devices 警告，其中包含每个别名、浏览器和最后发现时间。 Chromium Edge 会显示为 Edge，并包含正确的浏览器版本。

浏览器连接重复

不要继续为同一实体浏览器使用重复行。 创建新的灵活浏览器设备，并在指定浏览器上打开新的验证链接。 这样会移除多余绑定，让浏览器只有一个明确的自助终端所有者。

安全重新验证

你可以使用新链接重新验证已配对的浏览器。 只要链接仍然有效，就可以在同一浏览器上重放该链接。 重放会保持自助终端连接，不会轮换访问数据。 如需在另一台设备上替换浏览器绑定，请使用 Replace device。 替换期间，ACI guest-worker 配对仍保持连接。

存储丢失后恢复已配对的浏览器​

AVA 会将浏览器安装身份存储在持久浏览器存储中。 当本地副本消失时，它还会保留一个用于恢复的备用身份。

如果你清除了网站数据或本地浏览器存储，请在同一浏览器安装实例中重新打开自助终端。 AVA 可以在配对或员工验证前恢复现有身份。 恢复成功后，自助终端绑定和 ACI 授权会得到保留。

  1. 在同一设备和浏览器上重新打开自助终端。

  2. 在 AVA 检查已保存身份期间，保持配对页面或 ACI 页面打开。

  3. 等待自助终端状态或 ACI 就绪状态恢复。

  4. 如果状态保持不变，请选择 Refresh。

  5. 如果 AVA 要求验证，请使用 Verify Device 或同一浏览器验证链接。

    ✓ 当持久身份可用时，原浏览器绑定会保持连接。

私密浏览和新的浏览器配置文件

私密窗口和新的浏览器配置文件使用独立的临时存储。 它们无法从普通的自助终端浏览器恢复身份。 日常操作自助终端时，请使用原始浏览器配置文件。 使用私密配置文件或新配置文件前，请重新进行配对和验证。

多个标签页

每次只在一个新的标签页中打开自助终端设置。 AVA 会阻止相互冲突的首次身份替换已保存的浏览器身份。

浏览器配对未完成​

你会看到： 浏览器拒绝代码、QR 或验证链接。

解决方法：

  1. 确认代码生成时间未超过 10 分钟。

  2. 使用配对对话框中的最新代码或 QR。

  3. 确认你在指定浏览器上打开了设置地址。

  4. 如果正在更换浏览器，先确认 Replace device。

  5. 从 Settings → Kiosk 重试。

    ✓ AVA 应显示所选自助终端已连接。

不要重复使用已消费的代码或 QR。 只有在同一浏览器上重放验证链接，才能恢复现有绑定。 如果 localStorage 已被清除，请保持同一浏览器打开并等待身份恢复。 仅当 AVA 要求时，才使用新的验证链接。

网络故障后配对停止​

你会看到： 提交配对详情后，浏览器显示连接错误。

解决方法：

  1. 恢复浏览器的互联网连接。

  2. 保持配对页面打开。

  3. AVA 提供选项时选择 Retry。

  4. 在 Settings → Kiosk 中检查只读自助终端状态。

  5. 仅当自助终端仍未配对时，才生成新的配对详情。

    ✓ 即使响应丢失，已完成的配对仍会保持连接。

更改浏览器设备的入住模式​

当浏览器需要在住客主导和员工主导的入住之间切换时，请使用配对对话框。 更改模式会保存自助终端模式并创建新的配对详情。

  1. 前往 Settings → Kiosk。

  2. 找到灵活浏览器设备。

  3. 点击 Get verify link。

  4. 在 Check-in mode 部分选择 Self Check-In (CCI) 或 Assisted Check-In (ACI)。

  5. 选择 Connect with code、Scan QR code 或 Verification link。

    ✓ 等待替换期间，旧的配对详情会消失。 ✓ 新代码、QR 或链接与保存的入住模式一致。 ✓ 之前的配对详情会被取消。

模式更改权限

你需要同时拥有 mini_mdm:manage 和 settings:write 才能更改浏览器入住模式。 没有 settings:write 时，模式选项会被禁用。

新的配对详情出现后，打开 Copy link、Show QR 或 Download QR。 仅向目标浏览器设备分享替换用的配对详情。

选择 Copy link 后，按钮会显示复选标记和 Copied!，持续两秒。 每条自助终端行都有自己的复制状态。 如果复制失败，AVA 会显示错误通知。

对于 ACI 员工验证，请在另一块屏幕上显示 Show QR。 在指定的 ACI 浏览器上，员工选择 Verify Device 并扫描此 QR。 页面内扫描器会保持浏览器的 Web Clip、PWA 或 wrapper 上下文处于活动状态。

按权限显示的控件

拥有 mini_mdm:read 的用户可以查看自助终端状态。 创建设备和管理自助终端行需要 mini_mdm:manage。 注册操作需要 mini_mdm:enroll。 更改浏览器设备的入住模式需要 settings:write。 禁用控件或拒绝操作时，AVA 会说明缺少的权限。

逐步：创建受监管的 iPhone 或 iPad​

请先注册

创建设备行前请联系 Vouch 支持。 iPhone 或 iPad 必须先在 Apple Business Manager 中注册。

  1. 前往 Settings → Kiosk。
  2. 在注册卡片中点击 Create Device。
  3. 在 Choose device setup 中点击 iOS。
  4. 点击 Dedicated Device Enrollment。
  5. 输入可选标签以及 iPhone 或 iPad 序列号。
  6. 点击 Create and assign。

✓ Streamliner 会创建逻辑设备行。 ✓ iOS 设置模态框会打开并开始 ADE 设置。 ✓ 你会看到 ADE Connected、ADE Synced、ADE Profile Assigned 和 Ready to Erase iPhone/iPad。

逐步：使用 Guided Access​

仅限本地

Guided Access 会将设备保留在本地。 Streamliner 无法远程安装、锁定、解锁、重启或抹除它。

  1. 前往 Settings → Kiosk。
  2. 点击 How to enroll。
  3. 点击 iOS。
  4. 点击 Guided Access。
  5. 按照 Home Screen、Guided Access 和 AVA Check-in 的教程卡片操作。

✓ 你可以在本地单应用设置中使用 AVA Check-in。 ✓ 设备会保持在受监管的 MDM 管理范围之外。

逐步：完成已注册设备的 iOS 设置​

  1. 找到 iOS 设备行。
  2. 点击 Setup。
  3. 点击 Start kiosk setup 或 Start setup ADE。
  4. 等待状态卡片逐步更新。
  5. 如果应用安装停滞，点击 Verify and continue。

✓ 模态框会显示许可证、安装和锁定模式进度。 ✓ 自助终端设置完成后，该行会达到 Ready 状态。

逐步：注册设备​

需要恢复出厂设置

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

  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”。

在不同模式间切换 Android 设备​

在锁定式自助终端模式和普通手机模式之间切换已注册的 Android 设备。 切换期间设备仍保持注册状态。

准备好自助终端 PIN

你需要自助终端 PIN 才能批准模式更改。 请勿将 PIN 分享给住客。

  1. 前往 Settings → Kiosk。

  2. 找到已注册的 Android 设备。

  3. 打开设备模式控件。

  4. 选择 Kiosk mode 或 Normal-phone mode。

  5. 出现提示时输入自助终端 PIN。

  6. 确认更改。

  7. 点击 Refresh 并检查设备模式状态。

    ✓ AVA 会记录请求的模式并发送匹配的 Android 策略。 ✓ 设备仍处于 Android Enterprise 注册状态。 ✓ 切换模式不会取消注册或将设备恢复出厂设置。

策略状态

设备离线时，请求的模式和 Android 应用的模式可能会短暂不同。 等待设备重新连接，然后刷新 Settings → Kiosk。

理解策略状态​

点击设备行或其展开控件以显示策略状态详情。

状态含义你应该做什么
RequestedAVA 已将所选模式发送到 Android。等待设备接收策略。
PendingAndroid 尚未确认策略。保持设备在线，然后点击 Refresh status。
AppliedAndroid 已确认请求的模式。继续使用设备。
Retry neededAndroid 尚未确认更改。点击 Refresh status，或点击 Restart device 后再次刷新。

状态面板会在短时间内自动检查待处理的更改。 超过该时间后，在设备在线时使用 Refresh status。

请求的策略与已应用的策略

设备可能会在 Android 应用策略之前显示请求的策略。 请将 Applied 视为设备已完成模式更改的确认。

模式更改被拒绝​

你会看到： AVA 拒绝模式更改，或提示自助终端 PIN 无效。

解决方法：

  1. 确认你选择了正确的已注册 Android 设备。
  2. 输入 Unlock Code 卡片中的当前自助终端 PIN。
  3. 管理员更改 PIN 后，不要重复使用旧 PIN。
  4. 重试模式更改。
  5. 如果当前 PIN 仍然失败，请联系支持人员。

设备保持在之前的模式​

你会看到： 请求的模式已更改，但 Android 设备仍处于锁定或灵活模式。

解决方法：

  1. 确认设备在线且电量充足。
  2. 保持设备连接到互联网。
  3. 等待设备接收更新后的策略。
  4. 在 Devices 部分点击 Refresh。
  5. 比较请求的模式和 Android 应用的模式。
  6. 如果设备重新连接后两者仍不一致，请联系支持人员。

逐步：管理设备​

刷新列表​

  1. 点击 Devices 标题中的 Refresh。

✓ 你会看到“已刷新（已同步 X，已移除 Y）”。 ✓ 如果你的物业有很多设备，列表会自动加载所有页面。

确认旧版自助终端仍已注册​

AVA 可以识别通过旧版注册流程创建的活跃自助终端。 刷新设备列表后，这些设备行仍然可用。

  1. 在 Devices 标题中点击 Refresh。

  2. 使用 Mini MDM Device ID 或实体设备 ID 查找自助终端。

  3. 确认其状态仍为 Enrolled。

    ✓ 活跃的旧版自助终端仍可执行受支持的设备操作。

请勿仅因为设备行缺少较新的注册元数据，就移除或重新注册该行。

重启、锁定或解锁​

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

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

点击 Lock 或 Unlock 后，两个操作都会继续可用。 只有当前正在发送的操作会被禁用。 这样无需等待第一个请求完成，即可从较新的模式请求中恢复。

如果模式请求仍处于待处理状态，请展开其策略状态行。 先点击 Refresh status；如果状态没有变化，再点击 Restart device。

向自助终端设备发起通话​

确认前

通话模态框现在会显示琥珀色警告框。 它会提醒你，通话可能会中断该自助终端上的住客活动。

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

  2. 点击 Call。

  3. 在模态框中确认警告。

  4. 点击 Start call。

    ✓ Streamliner 会向该自助终端设备发起视频通话。 ✓ 当你需要从后台联系自助终端时使用此功能。 ✓ 警告会提醒你，通话可能中断正在进行的住客活动。

取消设备注册​

取消注册会重置设备

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

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

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

移除过时的受管控自助终端设置​

当 Mini MDM 不再显示设备已注册，但受管控的自助终端设置仍然存在时，请使用 Remove this device。 这会移除旧的 Check-in Connect 设置，并断开其 Guest Tablet 配对。

移除前，请清除该自助终端的编码器路由。 AVA 会在移除前立即检查最新的 Mini MDM 状态和可见的 Room Access 映射。

  1. 打开 Settings → Kiosk。
  2. 刷新受管控设备列表。
  3. 确认设备不再处于注册状态。
  4. 打开设备的 Settings。
  5. 确认设备不再为住客提供服务。
  6. 打开 Device Routing。
  7. 清除自助终端的编码器映射，然后点击 Save mappings。
  8. 返回设备设置，点击 Remove this device。
  9. 查看警告，然后点击 Remove。

✓ 移除刷新后，旧的自助终端设置会消失。 ✓ Guest Tablet 配对会断开。

移除前会先检查路由

如果发现自助终端存在编码器路由，AVA 会阻止移除。 如果无法验证 Room Access 路由，AVA 也会阻止移除。

旧版自助终端行不会显示 Remove this device。 请在 Device Routing 中清除其编码器路由，然后保存该行。 浏览器设备仍通过现有的浏览器移除流程移除。

设备路由​

使用 Device Routing 卡片，将每个已注册的自助终端连接到正确的房间访问编码器和支付终端。 自助终端路由现在位于此处，而不再位于 Room Access 页面。 当自助终端没有 MDM、灵活浏览器或 kiosk-device-model 记录时，仍会显示仅旧版行。 更新旧行时，AVA 会保留已有别名、备注、编码器链接和终端链接。

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

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

仍显示旧设备 ID 时你会看到什么​

你会看到： 保存后，某行仍使用旧 Android 设备 ID，或显示 Legacy kiosk 标签。

解决方法：

  1. 点击 Refresh。
  2. 再次打开同一设备行。
  3. 再次点击 Save mappings。
  4. 确认该行现在显示 Mini MDM Device ID。
  5. 如果仍显示旧版行，继续使用同一条自助终端记录。

故障排除​

QR 码无法生成​

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

解决方法：

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

设备列表保持为空​

你会看到： 注册后出现“尚未注册设备。”。

解决方法：

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

活跃的旧版自助终端显示为未完成​

你会看到： 在当前注册流程之前创建的自助终端显示了错误的注册状态。

解决方法：

  1. 在 Devices 部分点击 Refresh。

  2. 使用 Mini MDM Device ID 或实体设备 ID 匹配该行。

  3. 确认自助终端在线并可以接收设备操作。

  4. 只要该行仍处于活动状态，就不要移除或重新注册。

  5. 如果刷新后状态仍不正确，请联系支持人员。

    ✓ AVA 应保留活动的自助终端行及其可用操作。

无法使用 Remove this device​

你会看到： 无法移除受管控的自助终端设置。

解决方法：

  1. 刷新受管控设备列表。

  2. 确认 Mini MDM 不再将设备显示为 Enrolled。

  3. 打开 Device Routing，清除自助终端的编码器映射。

  4. 点击 Save mappings。

  5. 再次打开设备设置。

    ✓ 只有 AVA 确认设置已过时时，才会显示 Remove this device。

如果无法检查路由，AVA 会保留该设置。 请将自助终端名称和显示的错误信息提供给支持人员。

移除被编码器路由阻止​

你会看到： 移除操作提示必须先移除编码器路由。

解决方法：

  1. 打开 Settings → Kiosk → Device Routing。

  2. 展开受影响的自助终端。

  3. 清除其 Room Access Encoder 选择。

  4. 点击 Save mappings。

  5. 打开设备设置，然后重试 Remove this device。

    ✓ 路由不再与自助终端匹配后，AVA 会移除过时的设置。

设备路由显示尚无设备​

你会看到： Device Routing 卡片显示“尚未注册设备。”。

解决方法：

  1. 先至少注册一台自助终端设备。
  2. 在 Devices 部分点击 Refresh。
  3. 返回 Device Routing，展开新的设备行。

操作失败​

你会看到： Restart、Lock 或 Unlock 后出现“操作失败”。

解决方法：

  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。

自助终端按钮被禁用​

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

解决方法：

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

自助终端访问或权益不可用​

你会看到： AVA 显示自助终端管理不可用，或某项操作返回权益错误。

解决方法：

  1. 确认你选择了正确的酒店上下文。

  2. 确认你的角色包含 mini_mdm:read，以便查看自助终端设备。

  3. 确认你的角色包含 mini_mdm:manage，以便管理设备。

  4. 确认你的角色包含 mini_mdm:enroll，以便执行注册操作。

  5. 确认你的角色包含 settings:write，以便更改浏览器入住模式。

  6. 请管理员确认酒店方案包含自助终端功能。

  7. 刷新 Settings → Kiosk，然后重试操作。

    ✓ 页面会显示当前访问权限允许使用的控件。

自动刷新未结束​

你会看到： Auto-refreshing… 或 Refresh 长时间保持禁用状态。

最近一次完成的刷新会清除加载状态，即使手动刷新与自动轮询重叠也是如此。

解决方法：

  1. 等待 45 秒，让轮询窗口完成。
  2. 控件恢复可用后，点击一次 Refresh。
  3. 如果控件仍然被禁用，请重新加载 Settings → Kiosk。
  4. 如果问题重复出现，检查自助终端设备的网络稳定性。

未完成的行始终无法注册​

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

解决方法：

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

你会看到： 浏览器设备打开错误流程或显示配对错误。

解决方法：

  1. 打开浏览器配对对话框。
  2. 选择 Self Check-In (CCI) 或 Assisted Check-In (ACI)。
  3. 选择 Verification link。
  4. 选择 Copy link 或 Download QR。
  5. 在实体浏览器设备上打开新链接。
  6. 如果链接仍然打开错误流程，请联系支持人员。

模式更改关闭验证模态框​

你会看到： 模式已保存，但对话框在新的配对详情出现前关闭。

解决方法：

  1. 返回 Settings → Kiosk。

  2. 点击同一浏览器设备的 Get verify link。

  3. 确认所选模式。

  4. 选择 Connect with code、Scan QR code 或 Verification link。

  5. 使用新的代码、QR 或链接配对目标浏览器。

    ✓ 替换用的配对详情使用已保存的模式。

你会看到： 浏览器设备拒绝代码、QR 或验证链接。

解决方法：

  1. 从 Settings → Kiosk 生成新的配对详情。
  2. 在目标浏览器上打开设置地址。
  3. 输入新代码、扫描新 QR 或打开新链接。
  4. 不要重复使用已消费的代码或 QR。
  5. 如果新的配对详情仍然失败，请联系支持人员。

自助终端已连接到其他设备​

你会看到： “此自助终端已连接到其他设备。”

解决方法：

  1. 返回 Settings → Kiosk。

  2. 打开该自助终端的配对对话框。

  3. 选择 Replace device 并确认替换。

  4. 在应该运行该自助终端的浏览器上打开设置地址。

  5. 输入新代码、扫描新 QR 或打开新链接。

  6. 配对后刷新自助终端页面。

    ✓ AVA 会用新授权的浏览器替换旧浏览器绑定。

替换需要确认

普通代码、QR 或链接不能接管现有的自助终端绑定。 配对替换浏览器前，请确认 Replace device。

浏览器已连接到多个自助终端​

你会看到： Connected devices 计数大于一，或看到 Affected browser devices 警告。

解决方法：

  1. 在 Settings → Kiosk 中创建新的 Flexible browser device 行。

  2. 选择所需的入住模式。

  3. 生成新的配对详情。

  4. 在指定浏览器上打开设置地址。

  5. 配对浏览器，然后点击 Refresh。

  6. 确认重复警告已消失。

    ✓ 新浏览器行拥有一个明确的自助终端所有者。

警告中的浏览器详情

警告会列出受影响的别名、检测到的浏览器和最后发现时间。 使用这些详情确定应该继续使用的浏览器。

自助终端需要新的浏览器设备​

你会看到： “此自助终端需要先在 Streamliner 中创建新的浏览器设备，才能再次连接。”

解决方法：

  1. 返回 Settings → Kiosk。

  2. 打开现有浏览器设备的配对对话框。

  3. 选择 Self Check-In (CCI) 或 Assisted Check-In (ACI)。

  4. 选择 Replace device 并确认替换。

  5. 在替换浏览器上打开设置地址。

  6. 输入新代码、扫描新 QR 或打开新链接。

    ✓ 替换浏览器会获得自助终端绑定。

如果替换配对仍然失败，请创建新的 Flexible browser device 行。

iOS 设置失败​

你会看到： iOS 设置模态框显示 Setup failed 或 Apple 许可证错误。

解决方法：

  1. 确认 Apple Business Manager 已连接。
  2. 确认 Vouch MDM 分配处于活动状态。
  3. 检查 Apple Apps and Books 是否有可用许可证。
  4. 修复问题后点击 Retry setup。

应用一直处于安装中​

你会看到： iOS 模态框停留在 Installing app。

解决方法：

  1. 直接检查 iPhone 或 iPad。
  2. 确认已安装 ava.kiosk，或该应用可以安装。
  3. 点击 Verify and continue。
  4. 等待 Starting lock mode。

缺少 Setup 按钮​

你会看到： iOS 行显示 Setup required，但没有 Setup 按钮。

解决方法：

  1. 点击 Refresh，等待 Apple 注册完成。
  2. 确认序列号正确。
  3. 确认设备已在 Apple Business Manager 中注册。
  4. 如果添加了错误设备，请移除该行。

仍然无法解决？​

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

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

建议附上：

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