如何使用Alexa控制Clinks Living
這篇文章獻給願意掏腰包見證台灣智慧家庭早期發展的各位。
目前此功能尚處於開發者測試階段，有些流程還不順暢，還請大家多多包涵。如果有任何問題，都歡迎在此留言，或者聯絡ＴＩＨ的Facebook粉絲專頁。
需求材料
Clinks Living：
一款由台灣新創公司SCTek宏雲電研發製造的智慧家庭中樞，可以控制電燈開關以及冷氣、電視機等用紅外線控制的東西。
Amazon Alexa：
一款由美國亞馬遜公司開發的語音助理，可以透過說話的方式查詢股票、聽新聞或者是控制家中設備。目前Alexa 支援英文以及日文、德文，尚不支援中文。
Maid White：
ＴＩＨ的服務，能將兩者串接起來。
能夠發送HTTP指令的工具：
若是新手，推薦使用Postman。
預估耗時
約三十分鐘內。
步驟
首先，在Amazon Skill Store中找到Maid White
https://www.amazon.com/gp/product/B075SM28N6
登入了Amazon帳號之後點下Enable，接著會看到登入畫面。
如果已經有Maid White的帳號密碼，可以在這邊登入（注意：不是Amazon或Clinks的帳密），若是沒有，請點擊下面的Sign Up，註冊一個帳號。
完成註冊後請重新進入Skill的頁面點下Enable。
進行OAuth 授權
這一頁是在詢問使用者是否同意「授權設備管理權限給Amazon」，在此要特別注意要授權的對象究竟是哪個單位。ＴＩＨ會負責把關可以申請權限的第三方單位，使用者自己還是要特別注意要授權的對象正不正確。
確定是Amazon Alexa之後就點下Accept同意。
將Clinks Living 加入Maid White
由於目前Maid White還在開發者預覽階段，尚無可以順暢使用的APP，因此要請大家透過API Call的方式來新增設備。
接下來的步驟會用Postman來示範，需要的人可以先到這邊下載Postman：
打開之後看到畫面，和上面圖示操作
- 選擇POST
- 網址部分填入：
https://www.tih.tw/2/token
3. 參數選項選擇Body之後點x-www-form-urlencoded
4. 在一個Key欄位輸入username，在其對應的Value欄位打你的Maid White帳號；在下一列的Key跟Value欄位分別輸入password以及你的Maid White密碼
5. 按下Send送出
之後會得到一組像是 `19730000–08d6-a425–1100–290a48fac53d` 這種格式的字串，我們叫它Access Token，是拿來判斷是否有權限操作設備的鑰匙。
選擇Clinks設備
由於目前Maid White 還在開發者預覽階段，所以還沒有可以順暢使用的APP，因此還是要請大家透過API Call的方式來進行新增設備。
- 把網址的部分改成
https://www.tih.tw/2/devices，代表我們接下來要進行設備操作 - 新增
access_token然後把剛剛的Access Token貼上去 - 新增
driver_name然後輸入tw.tih.x.tw.clinks.living.switch.two代表我們要利用clinks的Driver - 新增
action然後輸入get_devicelist代表我們要取回設備列表 - 新增
username然後輸入Clinks的使用者代號 - 新增
password然後輸入Clinks的密碼 - 按下送出
接下來會看到一串設備列表，display_name代表設備名稱，One Way代表單切的設定值，Two Way代表雙切的設定值。
差別在於單切回傳的電燈亮暗狀態有意義，雙切的沒有，因此在雙切模式下，只要說Turn On 或是Turn Off，Maid White 都會去戳一下開關（Toggle）
新增設備
終於快要結束了呢，這邊需要改的地方有三個：
- 再次確認是雙切還是單切，雙切開關代表這個電燈可以由兩個開關控制，單切就只有一個。
- 新增
display_name，輸入要讓Alexa叫它的名字。建議取個好唸的名字，像是living room light這類的；在這邊打中文沒用，但是曾經有人回報輸入漢語拼音的名字例如dian deng是會動的。 - 新增
device_id，貼上上個步驟要新增的device id - 按下Send送出
大功告成
現在可以向Alexa說：
Alexa, discover devices
Alexa 就會和Maid White要求設備清單，然後就能控制了。
到底有沒有同步成功，除了看APP以外，也可以從這個網頁看到：
https://alexa.amazon.com/spa/index.html#appliances
如果要開燈的話，可以說： (假設名稱叫做 living room light )
Alexa, turn on living room light
要關燈的話可以說：
Alexa, turn off living room light
以上。歡迎大家把設定成功的影片放上來和我們分享！
補充資料
如果要修改設備名稱的話可以把網址改成 https://www.tih.tw/2/2/devices/{device_id}
如果有其他問題的話，除了在下面留言，也可以直接到ＴＩＨ的Facebook粉絲專頁詢問。
