Tips
- 智能音箱是單獨(dú)付費(fèi)模塊
- 云云對(duì)接智能音箱，目前已支持小度平臺(tái)的大部分功能
一、準(zhǔn)備工作
1. 申請(qǐng)一個(gè)百度賬號(hào)
申請(qǐng)賬號(hào)后登錄dueros開放平臺(tái)https://dueros.baidu.com/open進(jìn)行開發(fā)者認(rèn)證，必須要進(jìn)行公司認(rèn)證，才可申請(qǐng)技能。
2. 創(chuàng)建技能
認(rèn)證成功后，即可創(chuàng)建技能
Tips
因?yàn)榧寄芤蠓?wù)器地址必須是url加密（https）的。如果需要在本地啟動(dòng)服務(wù)調(diào)試，則需要在把本地后端項(xiàng)目啟動(dòng)后進(jìn)行內(nèi)網(wǎng)穿透到一個(gè)加密地址，然后把下面的服務(wù)器地址改為你穿透的地址，在代碼相應(yīng)接口打斷點(diǎn)就可以調(diào)試了。同理，如果要把技能上線，也需要保證你的服務(wù)器地址是加密的。
3. 音箱配置
系統(tǒng)管理-云云對(duì)接-音箱配置
二、音箱對(duì)接
- 產(chǎn)品關(guān)聯(lián)小度設(shè)備類型（用于小度識(shí)別設(shè)備類型）
- 產(chǎn)品物模型對(duì)接小度定義的屬性，一個(gè)物模型唯一對(duì)應(yīng)一個(gè)屬性，屬性值關(guān)聯(lián)物模型的值，并返回給小度；
- 產(chǎn)品物模型對(duì)接小度定義的動(dòng)作：一個(gè)物模型對(duì)應(yīng)多個(gè)動(dòng)作，該動(dòng)作主要用于語(yǔ)音識(shí)別控制屬性關(guān)聯(lián)的物模型；
Warning
選擇關(guān)聯(lián)屬性時(shí)，注意以下內(nèi)容
默認(rèn)屬性值直接關(guān)聯(lián)物模型的value值，使用物模型的value值作為小度的屬性值返回；
物模型單位需配置為和屬性單位一樣或者不配，優(yōu)先取物模型配置的單位，和小度屬性單位不一致會(huì)報(bào)錯(cuò)，沒(méi)有配置則取屬性默認(rèn)單位；
部分小度屬性返回值為枚舉或?qū)ο?，返回值是官方定義好的，所以需要進(jìn)行屬性值和物模型值關(guān)聯(lián)操作，需自行配置，目前支持枚舉值對(duì)應(yīng)、物模型id對(duì)應(yīng)（對(duì)象類物模型）；
枚舉值對(duì)應(yīng)：例如小度開關(guān)屬性 turnOnState，其屬性值為 "ON"（打開） 、"OFF"（關(guān)閉）；
關(guān)聯(lián)物模型 switch，其物模型值為 "1"(打開)、"0"(關(guān)閉)；
需進(jìn)行值關(guān)聯(lián)操作：{'ON':'1','OFF':0}
對(duì)象對(duì)應(yīng)：例如小度顏色屬性 color，其包含三個(gè)子屬性，分別為"hue"（色相）、"saturation"（飽和度）、"brightness"（明度）；
必須關(guān)聯(lián)對(duì)象類物模型 object，其也包含三個(gè)子物模型，子物模型id分別為"object_hue"(色相)、"object_saturation"(飽和度)、
"object_brightness"(明度)；
需進(jìn)行子屬性標(biāo)識(shí)和子物模型id對(duì)應(yīng)：{"hue":"object_hue","saturation":"object_saturation","brightness":"object_brightness"}，
然后子屬性值直接關(guān)聯(lián)子物模型值，并返回給小度；三、使用教程
獲取代碼后請(qǐng)先閱讀fastbee-speaker/目錄下README.md文件；配置前建議先閱讀項(xiàng)目fastbee-speaker/file/小度對(duì)接文檔，然后進(jìn)行配置
入口主頁(yè)面：
選擇菜單云云對(duì)接-小度音箱進(jìn)入，先點(diǎn)擊新增按鈕，選擇需要關(guān)聯(lián)的產(chǎn)品，點(diǎn)擊關(guān)聯(lián)按鈕會(huì)把產(chǎn)品下的物模型先關(guān)聯(lián)進(jìn)來(lái)；
關(guān)聯(lián)產(chǎn)品詳情頁(yè)面：
- 刷新按鈕：當(dāng)產(chǎn)品新增物模型后，可點(diǎn)擊進(jìn)行關(guān)聯(lián)，物模型如果修改過(guò)，建議先把關(guān)聯(lián)的物模型刪除，然后點(diǎn)擊刷新重新關(guān)聯(lián)進(jìn)來(lái)
- 關(guān)聯(lián)物模型編輯按鈕：進(jìn)入配置頁(yè)面：（1）參照excel文檔先選擇關(guān)聯(lián)屬性，會(huì)自動(dòng)匹配一些動(dòng)作（匹配后就不可修改動(dòng)作）；（2）部分屬性返回值需關(guān)聯(lián)物模型值，需參照屬性值然后再根據(jù)物模型值進(jìn)行配置關(guān)聯(lián)；
使用文檔：
當(dāng)以上配置做完后，參考小度對(duì)接文檔語(yǔ)音指令，就可以通過(guò)語(yǔ)音來(lái)控制設(shè)備了
四、后續(xù)更新
- 部分復(fù)雜動(dòng)作還未實(shí)現(xiàn)，后續(xù)進(jìn)行更新
- 報(bào)警模塊上報(bào)物模型值給小度音箱，后續(xù)進(jìn)行更新