本文为我的 源代码阅读专栏 第一个工程的代码阅读——wukong-robot 一个优秀的开源智能音箱项目。本文解析的源代码文件为plugins文件夹中的文件
plugins相关插件介绍
plugins文件夹存放了一下相关插件,这些插件按功能分别放置不同的文件中。
- Camera。 拍照插件
- CleanCache。 清除缓存插件
- Echo。 通过网页传话插件
- Email。 查看收件箱插件
- Geek。 极客模式插件
- LocalPlayer。 沉浸式音乐播放插件
- Poem。 写诗插件
- Volume。 音量调整插件
这些插件均封装成了类,并且继承自抽象类AbstractPlugin。下面我先对AbstractPlugin进行分析,然后分别对各插件进行简单的解析
AbstractPlugin类
robot/sdk/AbstractPlugin类是作者为了统一插件调用接口而编写的抽象插件类。该抽象类提供了SLUG
属性用以标识当前对象的具体插件功能,同时提供了以下抽象方法供子类进行个性化实现:
- isValid。插件子类判断是否适合自己处理
- isValidImmersive。插件子类判断是否适合在沉浸式音乐播放模式下处理
- handle。插件子类的主处理逻辑
- pause。暂停沉浸式音乐播放任务
- restore。恢复沉浸式音乐播放任务
AbstractPlugin类同时提供了一些方法供子类实现抽象方法时调用
- play。使用当前交互终端播放
- say。输出文本到当前交互终端
- activeListen。开始聆听
- clearImmersive。退出沉浸模式
各插件解析
Camera
使用时,拍照插件首先读取摄像头的配置信息,然后根据不同的配置信息调用不同的命令行命令进行抓拍。其中,usb摄像头使用的抓拍命令为fswebcam
;树莓派专有摄像头使用的抓拍命令为raspistill
CleanCache
使用时,直接删除相应文件夹
Echo
使用时,将文本去掉echo和传话后输出到交互终端
使用时,通过imaplib库连接邮件服务器,通过email库读取邮件信息
Geek
通过标志位幅值来实现极客模式的开启和关闭
LocalPlayer
通过解析句子的意图进行沉浸式音乐的控制。解析意图…看起来高科技的东西,后续再分享哈
插件的加载
从代码中可以发现,plugins中的各文件类名都是Plugin。那实际使用时如何加载呢?
wukong-robot使用robot/plugin_loader.py中的get_plugins方法来进行插件组的加载。具体代码上使用pkgutil
库进行包的查找和加载,利用AbstractPlugin类的SLUG
属性判断插件是否重复加载了
用到的技术点
- imaplib。实现了实际的IMAP4协议。用他获取收件箱内容的代码为:
import imaplib
conn = imaplib.IMAP4_SSL("imap.exmail.qq.com")
conn.login('username','password')
t=conn.select('INBOX')
- email。电子邮件包。可以对收到的邮件进行解析
msg = email.message_from_string(msg)
,这样就可以得到主题、收件人等信息了 - pkgutil。包管理库。可以用来进行包的搜索和加载:
import pkgutil
for finder, name, ispkg in pkgutil.walk_packages(locations):
loader = finder.find_module(name)
mod = loader.load_module(name)
参考
考虑到项目源代码可能会被作者更新,致使代码与我的总结文档不一致,下面列表中会提供原始代码链接和冻结代码链接。冻结代码链到我自己fork的工程中,大家如果需要找原始源码,可以点击原始代码链接