plugins

叮当的官方插件

Table of Contents

• Echo
• Email
• Time
• Camera
• Unclear

Echo

简单的回声/传话功能。

当接入微信时，可以利用这个功能实现远程给家里发语音消息。

• 如果发送的是文本信息，用户发的内容将被转换成语音再播放；
• 如果发送的是语音消息，则用户的语音将被叮当直接播放。

触发条件

当检测到指令中包含 "echo" 或者 "传话" 时，将其余内容直接念出来。

示例

• 用户：“echo 你是最棒的”
• 叮当：“你是最棒的”

Email

检查邮件功能。

触发条件

1. 用户已在 ~/.dingdang/profile.xml 中完成了邮箱的配置。
2. 指令中有关键词 “邮件” 。

另外，叮当还有个定期消息检查机制，每 30 秒会执行一次邮件检查，如果有未读邮件，将会在当次运行会话中给用户语音播报一次。

示例

• 用户：“我有多少封邮件？”
• 叮当：“您有一封来自 m at hahack.com 的未读邮件”

Time

时间插件。询问叮当时间。

触发条件

指令中有关键词 “时间” 或 “几点”

示例

• 用户：“现在几点？”
• 叮当：“现在时间是2017年5月14日23点14分PM”

Camera

用于调起摄像头拍照（如果安装了摄像头的话）。

触发条件

指令中有关键词 “拍照” 或 “拍张照” 时。

如果接入了邮箱或微信，照片将发送到用户的邮箱或微信中（选择哪种取决于配置中 prefers_email 的值）。

示例

倒计时拍照

• 用户：“拍张照”。
• 叮当：“收到，3秒后启动拍照……咔擦（拍照声）……拍照成功！正在发送照片到您的微信……发送成功！”

无声拍照

• 用户：“偷偷地拍张照”（也可以使用微信发）。
• 叮当：“……（无声）”

配置

# 拍照
camera:
    enable: true
    dest_path: "/home/pi/camera" # 保存目录
    quality: 5              # 成像质量（0~100）
    vertical_flip: false    # 竖直翻转
    horizontal_flip: false  # 水平翻转
    count_down: 3           # 倒计时（秒），仅当开启倒计时时有效
    sendToUser: true        # 拍完照是否发送到邮箱/微信
    sound: true             # 是否有拍照音效

Unclear

用于处理未知的问题。

如果接入了对话机器人，将转交给对话机器人应对；否则将给予类似 “我没听清楚” 这样的回复。

触发条件

语音指令不符合其他的插件的触发条件。

示例

• 用户：“讲个绕口令”
• 叮当：“山上五棵树，架上五壶醋，林中五只鹿，箱里五条裤。伐了山上树，搬下架上的醋，射死林中的鹿，取出箱中的裤。”