跳到主要内容

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 是每条 kiosk 记录的稳定行 ID。 用它将一台实体自助终端对应到唯一的设备行。 AVA 会根据 Mini MDM Device ID 保存自助终端路由行。 如果你仍然保留旧的设备 ID 映射，保存时 AVA 会继续保留它们。 注册流程现在从 Create Device 开始。 然后选择锁定式住客自助终端、灵活的浏览器设备或 iOS 流程。

前往： Settings → Kiosk

快速参考​

设置控制内容员工用途
Kiosk access permissions控制只读或管理访问决定谁可以执行设备操作
Create Device添加一个未完成的逻辑 kiosk 行在注册前预留一个槽位
Choose device setup打开锁定式、浏览器或 iOS 选择器先选择正确的设备类型
Enroll Device为单个 kiosk 行创建一次性 QR注册一个已知的设备槽位
Create locked-down device添加一台受管控的住客入住平板将设备锁定为 kiosk 模式
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 或 kiosk 设置完成 iPhone/iPad 配置
Verify and continue在锁定模式前检查已安装应用恢复卡住的应用安装
Setup status显示 ADE、应用和锁定进度跟踪 iOS 配置
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重启、锁定、解锁、取消注册远程控制和恢复
Document camera defaults设置手机和平板扫描的第一摄像头让不同 kiosk 类型的扫描保持一致
Connected devices统计灵活浏览器设备的活动浏览器连接数发现重复的浏览器配对

设置文档摄像头默认值​

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

  1. 前往 Settings → Kiosk。

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

  3. 选择 Tablet and larger default。

  4. 点击 Save camera defaults。

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

kiosk 覆盖如何工作

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

Android 精简用户代理

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

更改何时生效

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

摄像头选择仍然不对​

你会看到： 保存后，kiosk 仍然打开旧摄像头。

解决方法：

  1. 刷新 kiosk 配置。

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

  3. 再试一次扫描。

    ✓ kiosk 应该会使用新的默认值或覆盖设置。

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
设置受监管的 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。

✓ 你会看到一条新的浏览器设备行。 ✓ Streamliner 会提供一次性的验证链接。 ✓ 该链接包含保存的模式，例如 mode=cci 或 mode=aci。 ✓ 该链接会打开 AVA 前端，并包含 merchant ID。 ✓ 你需要在物理浏览器设备上打开该链接以完成配对。

只使用一次链接

打开链接会消耗它。 如果你在错误的设备上点击，请重新生成一个新的。 重新生成链接会撤销该 kiosk 行的所有旧浏览器链接。

merchant 上下文

验证链接现在使用的是 AVA 前端，而不是旧的 check-in 流程。 它包含 mid，这样 AVA shell 可以先加载正确的 merchant。 保存的自助终端模式决定链接内容。 更改 URL 文本不能在 CCI 和 ACI 之间切换浏览器。 该链接在你使用、替换或删除该设备行之前一直有效。

保持浏览器所有权一致​

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

情况结果你应该做什么
首次配对浏览器成为自助终端所有者。继续使用该浏览器。
在同一浏览器上重新验证自助终端保持连接。生成新链接并在该浏览器上打开。
在另一浏览器上打开链接AVA 拒绝配对。使用已经与自助终端配对的浏览器。
更换实体浏览器旧所有者仍受保护。创建新的灵活浏览器设备行。

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

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

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

浏览器连接重复

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

安全重新验证

你可以使用新链接重新验证已配对的浏览器。 当浏览器需要新会话，或需要确认其自助终端连接时，请使用此操作。

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

当浏览器需要在住客自助和员工协助入住之间切换时，请使用验证弹窗。 更改模式会保存自助终端模式，并创建新的单次使用链接。

  1. 前往 Settings → Kiosk。

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

  3. 点击 Get verify link。

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

  5. 点击 Generate Self Check-In (CCI) link 或 Generate Assisted Check-In (ACI) link。

    ✓ 等待替换链接期间，旧链接和 QR 会消失。 ✓ 新链接和 QR 与保存的入住模式一致。 ✓ 之前的一次性链接会被取消。

更改模式所需的权限

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

仅在新链接出现后，才打开 Copy link、Show QR 或 Download QR。

将替换链接只分享给目标浏览器设备。

对于 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。

✓ 弹窗会显示许可证、安装和锁定模式进度。 ✓ 当 kiosk 设置完成后，该行会变为 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”。

逐步：管理设备​

刷新列表​

  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 连接到正确的房卡访问编码器和支付终端。 Kiosk 路由现在位于这里，而不是 Room Access 页面。 如果 kiosk 没有 MDM、灵活浏览器或 kiosk-device-model 记录，旧版专用行仍会显示。 AVA 在更新旧行时，会保留现有别名、备注、编码器链接和终端链接。

  1. 滚动到 Device Routing。
  2. 确认至少有一台 kiosk 设备已注册。
  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. 如果它仍然显示为旧版行，请继续使用同一条 kiosk 记录。

故障排查​

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. 权限变更后刷新页面。

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

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

解决方法：

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

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

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

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

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

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

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

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

Auto-refreshing 不会消失​

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

解决方法：

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

Unfulfilled 行始终无法注册​

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

解决方法：

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

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

解决方法：

  1. 打开浏览器验证链接弹窗。
  2. 选择 Self Check-In (CCI) 或 Assisted Check-In (ACI)。
  3. 点击 Generate link。
  4. 确认链接包含 mode=cci 或 mode=aci。
  5. 确认链接包含 mid=<merchantId>。
  6. 在实体浏览器设备上打开新链接。
  7. 如果 Streamliner 表示模式已保存但链接生成失败，请点击 Get verify link。
  8. 如果现有链接打开了错误流程，请联系支持。

更改模式会关闭验证弹窗​

你会看到： 模式已保存，但弹窗在新链接出现前关闭。

解决方法：

  1. 返回 Settings → Kiosk。

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

  3. 确认所选模式。

  4. 点击 Generate Self Check-In (CCI) link 或 Generate Assisted Check-In (ACI) link。

  5. 将新链接或 QR 分享给目标浏览器设备。

    ✓ 替换链接使用已保存的模式。

你会看到： 在你打开一次链接后，浏览器设备显示验证错误。

解决方法：

  1. 在 Settings → Kiosk 中生成新的浏览器设备链接。
  2. 选择 Show QR，并在另一块屏幕上显示。
  3. 在目标 ACI 浏览器上选择 Verify Device，并扫描新的 QR。
  4. 测试旧链接后不要再次使用它。
  5. 如果新的 QR 仍然失败，请联系支持。

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

你会看到： "This kiosk is already connected to a different device."

解决方法：

  1. 返回 Settings → Kiosk。

  2. 打开该自助终端的 Get verify link。

  3. 在已经与该自助终端配对的浏览器上打开新链接。

  4. 如果该浏览器不可用，创建新的 Flexible browser device 行。

  5. 使用新链接配对替换浏览器。

    ✓ AVA 会保护现有自助终端，避免被意外接管。

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

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

解决方法：

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

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

  3. 生成新的验证链接。

  4. 在指定浏览器上打开链接。

  5. 点击 Refresh，确认重复警告已消失。

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

警告中的浏览器详细信息

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

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

你会看到： "This kiosk needs a new browser device in Streamliner before it can be connected again."

解决方法：

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

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

  3. 生成验证链接。

  4. 在替换浏览器上打开链接。

    ✓ 替换浏览器拥有新的受保护自助终端绑定。

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 分钟

建议附上：

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