> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maple.inc/llms.txt
> Use this file to discover all available pages before exploring further.

# 设置 Maple 自助点餐机

> 把 Android 平板或自助点餐机变成 Maple 自助点餐机

Maple Device 应用可以把 Android 平板或自助点餐机变成自助点餐机。顾客可以通过触摸或语音点餐，订单会像其他 Maple 订单一样发送到您的门店。

## 您需要准备什么

* **一台设备：** 运行 Android 8 或更高版本的 Android 平板或自助点餐机。
* **Wi-Fi：** 点餐机摆放位置有可用的互联网连接。
* **该门店的 Maple 控制台访问权限。**
* **打印机（可选）：** 内置小票打印机，或同一网络中的 ESC/POS 小票打印机。支持 58 mm 或 80 mm 纸张。

## 在 Maple 中开启自助点餐机

<Steps>
  <Step title="打开 Manage Kiosk">
    在 Maple 控制台中，进入 **Orders**，然后点击 **Manage Kiosk**。
  </Step>

  <Step title="启用自助点餐机">
    点击 **Enable Kiosk**。每个门店只需操作一次。
  </Step>

  <Step title="获取配对码">
    点击 **Pair a kiosk**。Maple 会显示一个 6 位数字码。请保持控制台打开，您需要在设备上输入这个码。
  </Step>
</Steps>

<Note>
  如果您在 Orders 页面上没有看到 **Manage Kiosk**，请[联系 Maple](/zh/need-help)。您的门店可能尚未开通自助点餐机功能。
</Note>

<Warning>每个码只能使用一次，10 分钟后过期。如果已过期，请再次点击 **Pair a kiosk**。</Warning>

## 安装 Maple Device 应用

<Steps>
  <Step title="下载应用">
    在设备上，用浏览器打开 [device-apks.maple.inc/latest.apk](https://device-apks.maple.inc/latest.apk)。
  </Step>

  <Step title="打开文件">下载完成后打开该文件。</Step>

  <Step title="允许安装">
    当 Android 询问时，允许从此来源安装。由于该应用不是来自 Play 商店，Android 只会提示这一次。
  </Step>

  <Step title="安装并打开">点击 **Install**，然后点击 **Open**。</Step>

  <Step title="允许权限">
    允许蓝牙、通知和麦克风。顾客需要麦克风才能语音点餐。
  </Step>
</Steps>

## 配对设备

<Steps>
  <Step title="输入配对码">
    在 **Pair this device** 屏幕上，输入控制台中的 6 位数字码，然后点击 **Pair**。
  </Step>

  <Step title="选择 Kiosk 模式">
    设备会打开设置。在 **Mode** 卡片中选择 **Kiosk**。保持 **Kiosk address** 不变，然后点击 **Save mode**。
  </Step>

  <Step title="完成设置">
    自助点餐机会打开，并显示一个包含若干检查项的设置屏幕。点击 **Finish setup and open kiosk**。您只会在第一次看到这个屏幕。
  </Step>
</Steps>

回到控制台，该设备现在会出现在 **Manage Kiosk** 下的 **Devices** 列表中，并标记为 **Online**。

## 检查声音

顾客要与点餐机对话，所以请确认它能听到也能被听到。

<Steps>
  <Step title="打开设置">按住屏幕左上角 5 秒，然后点击 **Open settings**。</Step>

  <Step title="检查麦克风">
    在 **Sound** 卡片中，**Microphone** 应显示 **Allowed**。如果不是，请点击 **Allow microphone**（如果 Android 已阻止，则点击 **Open app settings**）并开启。
  </Step>

  <Step title="播放测试音">
    点击 **Test sound**。您应该能从扬声器听到三声提示音。如果听不到，请调高通话音量后重试。
  </Step>

  <Step title="返回">点击 **Return to kiosk**。</Step>
</Steps>

## 设置打印机（可选）

<Steps>
  <Step title="打开设置">按住屏幕左上角 5 秒，然后点击 **Open settings**。</Step>

  <Step title="选择打印机">
    在 **Printer settings** 中，如果设备带有内置打印机，请选择 **Built-in printer**，否则选择 **Network printer**。对于网络打印机，请在 **Address** 下输入其 IP 地址，并将 **Port** 保持为 9100。打印机的自检单上会显示其地址。
  </Step>

  <Step title="选择纸张宽度">根据纸卷选择 **58 mm** 或 **80 mm**。</Step>

  <Step title="保存并测试">
    点击 **Save settings**，然后点击 **Test print**。
  </Step>

  <Step title="返回">点击 **Return to kiosk**。</Step>
</Steps>

测试结果的含义：

| 提示信息 | 处理方法 |
| - | - |
| **Test ticket sent.** | 打印机已确认，设置完成。 |
| **Sent to the printer, but it didn't confirm.** | 检查是否出纸。如果已出纸，设置完成。 |
| 其他任何信息 | 应用会说明出了什么问题。解决后，再次点击 **Test print**。 |

## 返回设置

点餐机会全屏显示，Android 返回键不起作用。要进入设置：

1. 按住屏幕左上角 5 秒。
2. 点击 **Open settings**。
3. 完成后，点击 **Return to kiosk**。

若要把点餐机改回仅作为小票打印机，请在 **Mode** 卡片中选择 **Printer**，然后点击 **Save mode**。

## 更新

小的应用更新会自动下载。点餐机会在夜间凌晨 2 点到 5 点之间安装，因此不会打扰顾客。

应用本身偶尔会发布新版本。此时，设置屏幕会显示 **A new version of Maple Device is ready**。点击 **Download**，打开文件，然后点击 **Install**。配对和设置保持不变。该提示只显示在设置中，不会出现在顾客看到的点餐机屏幕上，因此请时常打开设置查看。

## 在控制台中管理自助点餐机

在 **Orders** > **Manage Kiosk** 下，**Devices** 列表会显示每台已配对的设备，包括：

* **Online** 或 **Offline**，以及 Maple 最后一次收到其信号的时间
* 其模式（**Kiosk** 或 **Printer**）、应用版本和打印机状态
* 它最后打印的小票

点击 **Unpair** 可移除设备。在您用新的码重新配对之前，它将无法工作。同一页面还可以设置点餐机的颜色、待机画面图片、欢迎语、语音和语言。

## 故障排查

<AccordionGroup>
  <Accordion title="没有声音">
    打开设置，点击 **Sound** 卡片中的 **Test sound**。如果听不到三声提示音，请用设备的音量键调高通话音量。如果 **Microphone** 没有显示 **Allowed**，请点击 **Allow microphone** 或 **Open app settings** 并开启麦克风。
  </Accordion>

  <Accordion title="配对码无效">
    配对码只能使用一次，10 分钟后过期。请在控制台中点击 **Pair a kiosk** 获取新码，并立即输入。请确认您输入了全部 6 位数字。
  </Accordion>

  <Accordion title="点餐机显示离线">
    请确认设备已连接 Wi-Fi，且网络可以访问互联网。打开设置：在 **Status** 卡片中，**Connection** 应显示 **Connected**。应用在离线时会持续尝试，因此网络恢复后会自动重新连接。如果一直离线，请重启设备。
  </Accordion>

  <Accordion title="打印机不出单">
    打开设置并点击 **Test print**。检查打印机是否开机、是否有纸，以及是否与设备在同一网络。对于网络打印机，请对照打印机的自检单核对 IP 地址，并确认端口是 9100。当打印机报告问题时，**Status** 卡片会显示 **Out of paper** 或 **Error**。
  </Accordion>

  <Accordion title="点餐机屏幕无法加载">
    先检查 Wi-Fi。然后打开设置，确认 **Mode** 卡片中的 **Kiosk address** 已填写。点击 **Return to kiosk** 重试。
  </Accordion>
</AccordionGroup>

仍然解决不了？[联系 Maple](/zh/need-help)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.