> ## 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 中开启自助点餐机

1. ### 打开 Manage Kiosk

   在 Maple 控制台中，进入 **Orders**，然后点击 **Manage Kiosk**。

2. ### 启用自助点餐机

   点击 **Enable Kiosk**。每个门店只需操作一次。

3. ### 获取配对码

   点击 **Pair a kiosk**。Maple 会显示一个 6 位数字码。请保持控制台打开，您需要在设备上输入这个码。

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

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

## 安装 Maple Device 应用

1. ### 下载应用

   在设备上，用浏览器打开 [device-apks.maple.inc/latest.apk](https://device-apks.maple.inc/latest.apk)。

2. ### 打开文件
   下载完成后打开该文件。

3. ### 允许安装

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

4. ### 安装并打开
   点击 **Install**，然后点击 **Open**。

5. ### 允许权限

   允许蓝牙、通知和麦克风。顾客需要麦克风才能语音点餐。

## 配对设备

1. ### 输入配对码

   在 **Pair this device** 屏幕上，输入控制台中的 6 位数字码，然后点击 **Pair**。

2. ### 选择 Kiosk 模式

   设备会打开设置。在 **Mode** 卡片中选择 **Kiosk**。保持 **Kiosk address** 不变，然后点击 **Save mode**。

3. ### 完成设置

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

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

## 检查声音

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

1. ### 打开设置
   按住屏幕左上角 5 秒，然后点击 **Open settings**。

2. ### 检查麦克风

   在 **Sound** 卡片中，**Microphone** 应显示 **Allowed**。如果不是，请点击 **Allow microphone**（如果 Android 已阻止，则点击 **Open app settings**）并开启。

3. ### 播放测试音

   点击 **Test sound**。您应该能从扬声器听到三声提示音。如果听不到，请调高通话音量后重试。

4. ### 返回
   点击 **Return to kiosk**。

## 设置打印机（可选）

1. ### 打开设置
   按住屏幕左上角 5 秒，然后点击 **Open settings**。

2. ### 选择打印机

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

3. ### 选择纸张宽度

   根据纸卷选择 **58 mm** 或 **80 mm**。**Built-in (Kozen)** 打印机不显示此设置。

4. ### 保存并测试

   点击 **Save settings**，然后点击 **Test print**。

5. ### 返回
   点击 **Return to kiosk**。

测试结果的含义：

| 提示信息                                            | 处理方法                                 |
| ----------------------------------------------- | ------------------------------------ |
| **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** 可移除设备。在您用新的码重新配对之前，它将无法工作。同一页面还可以设置点餐机的颜色、待机画面图片、欢迎语、语音和语言。

## 故障排查

**没有声音**

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

**配对码无效**

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

**点餐机显示离线**

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

**打印机不出单**

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

**点餐机屏幕无法加载**

先检查 Wi-Fi。然后打开设置，确认 **Mode** 卡片中的 **Kiosk address** 已填写。点击 **Return to kiosk** 重试。

仍然解决不了？[联系 Maple](https://docs.maple.inc/zh/need-help.md)。