## **插件觸發機制** 插件觸發分為：語音觸發、微信小程序觸發、視頻解碼觸發 ### **一、語音觸發** ***** 在編寫插件時需要創建一個與插件名相同的`.conf`配置文件，如你的插件名：`light.py`,那么你需要創建一個`light.conf`的插件配置文件，在插件配置文件中可以定義此插件的語音觸發詞，如以下格式： ``` { 'type':'temp', 'name':'Light', 'trigger':[ '打開{1}燈','關閉{1}燈','開燈','關燈' ] } ``` 其中 name：'Light' 的意思是：你的類名，本系統必須遵循**國際統一規范：首字母大寫**的原則。 其中`trigger`鍵值中配置的`'打開{1}燈','關閉{1}燈','開燈','關燈' `就是觸發詞，一個插件中可以定義多個觸發詞 * 觸發詞定義規則 觸發詞可分為：模糊匹配和完全匹配；模糊匹配是指無論觸發詞的位置怎樣，只要出現該詞即可；完全匹配是指只有整個字段與觸發詞相同才匹配，完全匹配是指將輸入的觸發詞當固定詞組進行查找，而模糊匹配則會自動拆分觸發詞為單元概念，并進行邏輯與運算。 以下分別是對：`打開燈`、`打開{xx}燈`、`|打開燈|`、`打開燈|`指令設定不同的觸發詞，用戶發出指令后是否被觸發可見下表 (圖中`√`表示會被觸發，`×` 表示不被觸發) | 用戶指令 | `打開燈` | `打開{xx}燈` | `|打開燈|` | `打開燈|`| | --- | --- | --- |--- | --- | | 打開燈 | √ | √ | √ | √ | | 幫我打開燈 | √ | √ | × | √ | | 幫我打開燈可以嗎？ | √ | √ | × | × | | 幫我打開客廳燈| × | √ | × | × | 指令中`{xx}`和 `|`為修飾符，`{xx}` 一般放在觸發詞的中間，可以填寫客廳、陽臺等等具體的地方，這樣可以更好的匹配多種情況，具體擺放位置可根據插件的需求來定， `|`修飾符為定界修飾符，放在觸發詞的兩邊或一邊。可舉例為： 1. 若是放在最前面，那么只能匹配以觸發詞開始的語句，如： 觸發詞是：`|打開燈` 用戶說： 打開燈可以嗎?---能匹配 但是用戶說：幫我打開燈--- 不能匹配 2. 若是放在后邊，那么只能匹配以觸發詞結束的語句，如： 觸發詞是：`打開燈|` 用戶說： 打開燈可以嗎?---不能匹配 但是用戶說：幫我打開燈--- 能匹配 3. 若是放在兩邊，那么只能匹配以觸發詞開始和結束的語句，如： 觸發詞是：`|打開燈|` 用戶說： 打開燈可以嗎?---不能匹配 幫我打開燈--- 不能匹配 但是用戶說：打開燈--- 能匹配 ### **二、在數據庫添加觸發詞** * 后期版本支持一鍵安裝插件 和一鍵卸載插件 * 現階段需要你將定義的觸發詞手動寫入/keyicx/python/data/lstm.db數據庫trigger表和dz_option表內 ### **三、微信小程序觸發** ***** 微信小程序觸發插件是由MQTT協議定義，具體協議定義規則將在下一個版本中實現，到時該文檔會同步更新。