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