1. 实际应用场景与痛点
场景
现代人点外卖频率很高，尤其是上班族、学生、家庭用户。外卖到达后，骑手会在门口打电话或发短信告知取餐码，但经常出现：
- 手里提着东西，不方便看手机
- 环境嘈杂听不清骑手说的取餐码
- 多个订单同时到达，容易混淆取餐码
- 手动输入取餐码到 APP 查找订单很麻烦
痛点
1. 多单混乱：同时收到多个取餐码，容易记错或找不到对应订单。
2. 手忙脚乱：一手拿外卖，一手翻手机，还要找订单。
3. 语音识别不准：部分手机自带 TTS 语速太快或太慢，影响听取。
4. 操作复杂：现有工具往往需要打开网页或 APP，步骤繁琐。
2. 核心逻辑讲解
1. 输入取餐码
- 支持手动输入或从剪贴板读取（手机端可用输入框）。
2. 语音合成播报
- 使用
"pyttsx3"（跨平台离线 TTS）进行语音播报。
3. 语速自定义
- 用户可以调整语速（单词/分钟），适应不同听力习惯。
4. 适配手机端
- 使用
"Kivy" 框架开发跨平台 GUI，支持 Android/iOS（打包后）。
5. 一键播报
- 只有一个输入框和一个按钮，操作简单。
6. 防报错机制
- 输入校验（数字+字母组合），避免空值或非法字符。
3. 项目结构
takeaway_voice_notifier/
├── main.py # Kivy 主程序入口
├── voice_engine.py # 语音播报模块
├── config.json # 配置语速等参数
├── README.md
└── USAGE.md
4. 核心代码
"voice_engine.py"
import pyttsx3
import json
class VoiceEngine:
def __init__(self, config_file="config.json"):
self.engine = pyttsx3.init()
self.load_config(config_file)
def load_config(self, file):
try:
with open(file, "r", encoding="utf-8") as f:
cfg = json.load(f)
rate = cfg.get("rate", 150) # 默认语速
self.engine.setProperty("rate", rate)
except FileNotFoundError:
self.engine.setProperty("rate", 150)
def speak(self, text):
self.engine.say(text)
self.engine.runAndWait()
"main.py"（Kivy GUI）
from kivy.app import App
from kivy.uix.boxlayout import BoxLayout
from kivy.uix.textinput import TextInput
from kivy.uix.button import Button
from kivy.uix.label import Label
from voice_engine import VoiceEngine
class TakeawayApp(App):
def build(self):
self.voice = VoiceEngine()
layout = BoxLayout(orientation='vertical', padding=20, spacing=15)
layout.add_widget(Label(text="请输入取餐码", font_size=24))
self.code_input = TextInput(multiline=False, font_size=32, size_hint_y=None, height=60)
layout.add_widget(self.code_input)
btn_layout = BoxLayout(size_hint_y=None, height=50, spacing=10)
btn_speak = Button(text="播报取餐码")
btn_speak.bind(on_press=self.on_speak)
btn_layout.add_widget(btn_speak)
btn_speed_up = Button(text="加快语速")
btn_speed_up.bind(on_press=self.on_speed_up)
btn_layout.add_widget(btn_speed_up)
btn_speed_down = Button(text="减慢语速")
btn_speed_down.bind(on_press=self.on_speed_down)
btn_layout.add_widget(btn_speed_down)
layout.add_widget(btn_layout)
self.status_label = Label(text="", font_size=18)
layout.add_widget(self.status_label)
return layout
def on_speak(self, instance):
code = self.code_input.text.strip().upper()
if not code:
self.status_label.text = "❌ 请输入取餐码"
return
if not code.isalnum():
self.status_label.text = "❌ 取餐码应为字母和数字"
return
text = f"您的取餐码是 {code}"
self.voice.speak(text)
self.status_label.text = f"✅ 已播报: {text}"
def on_speed_up(self, instance):
self.voice.engine.setProperty("rate", self.voice.engine.getProperty("rate") + 20)
self.status_label.text = f"语速加快至 {self.voice.engine.getProperty('rate')}"
def on_speed_down(self, instance):
self.voice.engine.setProperty("rate", max(80, self.voice.engine.getProperty("rate") - 20))
self.status_label.text = f"语速减慢至 {self.voice.engine.getProperty('rate')}"
if __name__ == "__main__":
TakeawayApp().run()
5. README.md
# 🍔 外卖取餐码语音播报工具
一个极简的跨平台工具，输入取餐码即可语音播报，支持自定义语速，解决多单混乱、手忙脚乱的问题。
## 功能
- 输入取餐码，一键语音播报
- 支持语速调整
- 跨平台（Windows/macOS/Linux/Android/iOS）
- 无复杂操作，适配手机端
## 安装
bash
pip install kivy pyttsx3
## 运行
bash
python main.py
6. USAGE.md
# 使用说明
1. 打开程序，在输入框输入取餐码（如 A123）。
2. 点击“播报取餐码”即可听到语音。
3. 可点击“加快语速”或“减慢语速”调整。
4. 支持手机端运行（需打包 APK）。
7. 核心知识点卡片
知识点 说明
Kivy 跨平台 GUI 一套代码运行在手机和电脑
pyttsx3 离线 TTS 不依赖网络，语音稳定
JSON 配置 存储语速等参数
输入校验 防止非法字符导致播报错误
事件绑定 按钮点击触发语音和语速调整
移动端适配 大字体、少按钮，适合手机操作
8. 总结
这个工具解决了多单混乱、手忙脚乱、语音识别不准、操作复杂四大痛点，通过极简 UI + 离线 TTS + 语速可调，让用户在任何环境下都能快速、准确地获取取餐码。
它非常适合：
- 外卖高频用户
- 老年人或视力不佳者
- 需要双手操作其他事情的场景
如果你需要，可以在下一步：
- 打包成 Android APK（用 Buildozer）
- 增加 剪贴板自动读取 功能
- 增加 多语言播报（中英文切换）
利用AI解决实际问题，如果你觉得这个工具好用，欢迎关注长安牧笛！
