> 插件控制按鈕在所屬插件目錄下的`config.json`中是的`control`鍵值是配置，微信小程序目前支持以下幾種控制按鈕事件： ## **全局約定：** 所有的按鍵都具有`plugin`、`data`兩個共用參數，同時這兩個參數均為（選填）參數，但這個參數可以很好的進行按鍵功能擴展， * **plugin 指定插件參數定義** plugin 參數可以指定當前按鈕事件發送和控制那一個插件，值為：插件名（字符串） * **data 數據參數定義** data 數據值參數，可以由用戶自定義一些約定值，值可以為JSON格式或字符串，如在萬能開關插件里可以用參數定義控制的設備號 ## **控制類按鍵定義:** 除以上兩個全局字段約定，不同的按鍵有不同的參數約定，開發者在配置`config.json`插件配置文件時需嚴格按以下規定方式書寫，否則微信小程序端將無法正常解析。 #### **開關按鍵：** --- 格式如下： ``` { "type":"switch", "getvalue":"light", "setvalue":{"1":"打開客廳燈","0":"關閉客廳燈"}, "text":"客戶燈" } ``` 說明： | 鍵名 | 值（舉例） | 類型 |是否必填 | 說明 | |---|---|---|---|---| | type | switch | 字符串| **必填** | 類型為開關類型 | | getvalue| light | 字符串 | 選填 | 開關初始狀態設置值 | | setvalue| 設置值 | JSON格式 | **必填** | 開關動作傳輸所帶的值 | | text| 客戶燈| 字符串 | **必填** | 顯示開關名稱 | ======================================= === #### **按鍵按鈕：** ``` { "type":"button", "setvalue":"播放兒歌", "text":"兒歌", "plugin":"Chat", "size":"mini" } ``` 說明： | 鍵名 | 值（舉例） | 類型 |是否必填 | 說明 | |---|---|---|---|--| | type | button | 字符串| **必填** | 類型為按鈕類型 | | setvalue| 設置值 | JSON或字符串 | **必填** | 按鈕動作傳輸所帶的值 | | text| 兒歌 | 字符串 | **必填** | 顯示按鈕名稱 | | size| mini | default / mini | 選填 | 按鈕大小（默認為空） | ======================================= === #### **輸入框：** ``` { "type":"input", "getvalue":"myname", "text":"姓名：" } ``` 說明： | 鍵名 | 值（舉例） | 類型 |是否必填 | 說明 | |---|---|---|---|---| | type | input | 字符串| **必填** | 類型為輸入框類型 | | text| 姓名 | 字符串 | **必填** | 輸入框標簽名稱 | | getvalue | 初始值 | 字符串 | 選填 | 由協議回傳后指定值 | | password| 1 / 0 | 布爾數值 | 選填 | 是否為密碼輸入框類型 | | placeholder | 請輸入 | 字符串 | 選填 | 輸入框為空時占位符 | ======================================= === #### **文本內容：** ``` { "type":"text", "getvalue":"temperature", "text":"當前溫度：" } ``` 說明： | 鍵名 | 值（舉例） | 類型 |是否必填 | 說明 | |---|---|---|---|---| | type | text | 字符串| **必填** | 類型為文本類型 | | getvalue | 獲得值 | JSON或字符串 | **必填** | 由協議回傳后指定值 | | text| 當前溫度： | 字符串 | **必填** | 顯示文件標題名稱 | ======================================= === #### **滑動選擇器：** ``` { "type":"slider", "min":20, "max":100, "step":1, "getvalue":50, } ```