智能导航系统AIGlasses_for_navigation的部署与使用指南
1. 概述：开启智能导航之旅
AIGlasses_for_navigation 是一款集成了AI视觉识别、语音交互和导航逻辑的智能系统，旨在为用户提供便捷的导航服务。无论是日常出行还是为视障人士提供安全保障，该系统都可以通过语音与用户实时互动，并识别盲道、斑马线、红绿灯等环境信息。
本文将详细介绍如何部署和使用此系统，包括启动服务、配置API密钥以及体验核心功能。
学完本指南后，您将能够：
- 启动并检查系统服务状态。
- 配置阿里云DashScope API密钥以实现语音交互。
- 使用网页界面测试导航与交互功能。
- 理解硬件连接与纯软件模拟两种使用方式。
2. 准备工作：部署前的必要步骤
在开始之前，需要完成以下准备工作：
2.1 获取阿里云DashScope API密钥
系统的语音识别和对话功能依赖于阿里云提供的DashScope服务。请按照以下步骤获取API密钥：
- 访问阿里云DashScope控制台。
- 登录您的账号（如无账号，请注册）。
- 在"API-KEY管理"页面创建新的API密钥。
- 复制生成的密钥（以
sk-开头）并妥善保存。
新用户享有充足的免费额度，足够进行深入测试。
2.2 硬件需求（可选）
为了获得完整的实时体验，建议准备以下硬件设备：
- ESP32-CAM模块：用于采集视频数据。
- 麦克风：接收语音指令。
- 扬声器或耳机：播放系统回复。
如果暂无硬件，系统支持"浏览器模拟模式"，可通过上传本地视频文件测试所有核心功能。
3. 快速启动指南
假设系统已部署在服务器上（例如IP地址为192.168.1.100），以下是启动步骤：
3.1 确认服务运行状态
通过SSH连接到服务器，执行以下命令检查服务状态：
supervisorctl status aiglasses
如果状态为RUNNING，表示服务正常运行；否则，启动服务：
supervisorctl start aiglasses
3.2 打开控制面板
在浏览器中访问以下地址（替换实际IP地址）：
http://192.168.1.100:8081
这将是您与系统交互的主要界面。
3.3 配置API密钥
点击右上角的齿轮图标进入API配置页面，粘贴您的DashScope密钥并保存。配置成功后，系统会激活语音和对话功能。
3.4 开始交互
- 有硬件：对着麦克风说出指令，例如"开始导航"，系统将根据摄像头画面反馈语音提示。
- 无硬件：上传本地视频文件，系统会分析内容并展示结果。
4. 核心功能体验
以下是系统的主要功能及使用方法：
4.1 盲道导航
实时识别盲道并指引方向：
- 启动：语音指令"开始导航"或"盲道导航"。
- 引导：
- 左侧盲道：提示"向左转"。
- 右侧盲道：提示"向右转"。
- 正前方盲道：提示"直行"。
- 障碍物检测：警告"前方障碍物，请注意"。
- 停止：语音指令"停止导航"。
4.2 过马路辅助
识别斑马线和红绿灯状态：
- 启动：语音指令"开始过马路"或"帮我过马路"。
- 流程：
- 调整位置对准斑马线中心。
- 持续识别交通信号灯。
- 绿灯时提示"绿灯，可以通行"。
- 停止：语音指令"过马路结束"。
4.3 物品查找
帮助定位目标物品：
- 搜索：语音指令"帮我找一下[物品名]"。
- 工作原理：分析摄像头画面，当目标出现时，提示物品方向（如"物品在你左前方"）。
- 结束：语音指令"找到了"。
4.4 实时语音交互
支持多轮对话：
- 使用：直接说话，系统自动识别并回复。
- 示例：
- 环境咨询："这是什么？"。
- 物品咨询："这个东西能吃吗？"。
- 时间查询："现在几点了？"。
5. 系统维护与问题排查
5.1 常用管理命令
通过命令行管理服务：
# 查看服务状态
supervisorctl status aiglasses
# 重启服务
supervisorctl restart aiglasses
# 停止服务
supervisorctl stop aiglasses
# 查看实时日志
tail -f /root/AIGlasses_for_navigation/logs/supervisor.log
# 查看最新日志
tail -50 /root/AIGlasses_for_navigation/logs/supervisor.log
5.2 常见问题解决
问题一：网页无法访问
- 检查服务是否运行（
status命令）。 - 如服务异常，查看日志：
tail -100 /root/AIGlasses_for_navigation/logs/supervisor.log
问题二：语音识别无反应
- 确认API密钥是否正确配置。
- 测试网络连接：
ping dashscope.aliyuncs.com。 - 检查硬件连接是否正常。
问题三：更换API密钥
- 打开Web界面。
- 点击API配置按钮。
- 删除旧密钥，粘贴新密钥并保存。
6. 总结
通过本指南，您已完成从获取API密钥到体验核心功能的完整流程。无论技术探索还是开发助残应用，AIGlasses_for_navigation都提供了强大且易用的基础。
接下来，您可以尝试：
- 深入硬件集成，体验实时交互。
- 开发手机App或专用客户端。
- 收集数据优化模型性能。
希望本系统成为您探索AI赋能社会价值的重要工具。
