基于树莓派的魔镜

1 涉及知识

1.1 Linux/树莓派系统的基础使用

[解释]

部分开源项目只能在Linux系统环境下运行，并不支持在Windows环境下运行，并且树莓派原生系统也是基于Linux系统，最终的树莓派操作都会在Linux系统下运行

[建议]

建议自己手动安装一个Linux系统，推荐入门的Linux系统是Ubuntu，Ubuntu是Linux的一个比较友好的版本，有图形界面和命令行界面。然后熟悉一下命令行的基础操作，例如包管理apt-get intall，创建文件夹
mkdir my_file等命令，不需要全部精通，可以遇见问题的时候再去查找

1.2 Git/Github的使用

[解释]

因为会涉及到下载开源项目，这些项目都是托管在Github上面的，而Github是基于Git的一个代码托管平台，下载项目可以直接下载ZIP文件，或者用Git命令

[建议]

Git的学习可以参考一下网址：
https://www.liaoxuefeng.com/wiki/0013739516305929606dd18361248578c67b8067c8c017b000/
Github的使用，自行注册Github，然后熟悉一下即可

1.3 Python/C...so on基础编程

[解释]

语音合成和识别这部分的代码的需要通过编程语言控制，不管是Python还是C都需要一些基础的编程知识

[建议]

了解一下编程语言的语言逻辑控制，类的定义和函数方法的使用，多看看项目的使用文档，遇见问题多查一下资料

2 涉及项目

2.1 Snowboy

项目网址链接：https://github.com/Kitt-AI/snowboy
官方文档链接：http://docs.kitt.ai/snowboy/
项目简介：一个基于深度学习的语音控制库
作用说明：主要用于在魔镜中，做魔镜唤醒的作用
使用说明：根据项目链接的网址，把该项目的源码下载到本地以后，根据网址上的项目说明（英文），按步骤安装配置项目环境，然后在example运行Python的demo文件 注意：该项目不支持在Windows下运行
难点说明：Linux系统的基础使用，项目环境的搭建（此处最难，一定看懂那个英文文档，不行百度或者Google），Python demo的使用，需要一点基础的Python编程能力
关键字：Github，Linux，Python，Snowboy

2.2 MagicMirror2

项目网址链接：https://github.com/MichMich/MagicMirror
Wiki页面：https://github.com/MichMich/MagicMirror/wiki
FAQ页面：https://github.com/MichMich/MagicMirror/wiki/FAQ
项目简介：JavaScript编写UI控件
作用说明：用于在魔镜中做魔镜的可视化界面，即如下界面

界面设计.png
使用说明：根据项目链接的网址，把该项目的源码下载到本地以后，根据项目说明，编译运行文件，如上一项目
难点说明：编译配置
关键字：MagicMirror2

2.3 百度语音合成与识别接口

项目网址链接：http://ai.baidu.com/
官方文档地址：http://ai.baidu.com/docs#/Begin/top
项目简介：百度人工智能开放平台，提供简单免费的人工智能服务给开发者
作用说明：在魔镜中提供对语音的识别和合成
使用说明：下载项目网址链接中提供的对应语言的SDK包文件，根据文档说明，使用SDK提供的服务
难点说明：需要基础的编程能力，但代码量极少，大概可以控制在100-200行左右，建议使用Python编程，上手难度更低一点

2.4 图灵机器人接口

项目网址链接：http://www.tuling123.com/
产品帮助中心：http://www.tuling123.com/help/help_center.jhtml?nav=doc
项目简介：图灵机器人接口，提供中文语音对话服务
作用说明：在魔镜中提供魔镜的语音材料
使用说明：和百度api使用类似，直接按照api请求格式，请求相关api接口即可

3 整体流程

整体流程导图.png

4 其他

4.1伍佰工作室Python代码规范

写Python代码可以参考，地址：https://github.com/gogoforit/codestyle/blob/master/Python.md

4.2 Baidu/Google

百度不到的知识，多Google，因为涉及项目多为英文项目，国内资料比较少，可以更多地参考Google

4.3 建议

4.3.1 每个知识点不必追求深入了解，点到即止即可，有兴趣的可以以后再深入了解

4.3.2 不要钻牛角尖，一条路走不通的时候可以换其他方法，编程条条大路通罗马，只要能达到预期目标，走哪条路不重要

4.3.3 会遇见很多问题，自己做好心里准备，多查资料，多讨论，不要轻易放弃

4.3.4 遇见实在解决不了的问题，要多问，不要自己憋着，不懂就是不懂，不要怕不好意思