天貓精靈對接開發商服務

完整控制流程圖

與天貓精靈對接後，終端用戶可以通過對天貓精靈說出控制命令來調用雲端的業務邏輯，最終將正確的操作反饋給用戶。流程圖如下所示。

新技能配置

前往開發者網站(https://open.bot.tmall.com/account/login)註冊後登陸開發者平臺。
點擊"添加新技能"新增一個技能。
按照界面提示配置技能基本信息。

序號	選項	備註
1	技能名稱	可由開發者自定義
2	調用詞	使用者通過調用詞進入對應的技能，由開發者自定義，如：通過“天貓精靈+Able”可進入到創建的Able技能執行操作。
3	技能類型	選擇標準類型，目前天貓精靈僅支持標準技能。
4	技能模板	選擇智能家居。
5	技能描述	針對技能的描述說明，由開發者自定義。

按照界面提示配置服務基本信息

序號	選項	備註
1	賬戶授權連接	由AbleCloud提供，用於AbleCloud賬號爲天貓精靈授權。
2	Client ID	由AbleCloud分配用於對接天貓精靈
3	Client Secret	由AbleCloud分配用於對接天貓精靈
4	Access Token URL	由AbleCloud提供，天貓精靈通過鏈接獲取到用戶賬號的token
5	開發者網關地址	服務所在的服務器地址(由於天貓沒有提供對應的服務，所以該部分有開發者提供服務器，並部署對應的服務)

賬戶授權連接 Url 填入：

https://oauthtest.ablecloud.cn/authorize (測試環境)

https://oauth.ablecloud.cn/authorize (國內環境)

Access Token Url 填入：

https://oauthtest.ablecloud.cn/token (測試環境)

https://oauth.ablecloud.cn/token (國內環境)

協議說明

協議地址：http://doc-bot.tmall.com/docs/doc.htm?spm=0.0.0.0.ZsYBQd&treeId=393&articleId=107454&docType=1

設備發現

設備控制

 ｛
         "header":{
              "namespace":"ali_genie.Iot.Device.Discovery",
              "name":"DiscoveryDevices",
              "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
              "payLoadVersion":1
           },
           "payload":{
               "accessToken":"access token"
            ｝
          ｝

          ｛
          "header":{
              "namespace":"ali_genie.Iot.Device.Control",
              "name":"TurnOn",
              "messageId":"1bd5d003-31b9-476f-ad03-71d471922820",
              "payLoadVersion":1
           },
           "payload":{
               "accessToken":"access token",
               "deviceId":"34234",
               "deviceType":"XXX",
               "attribute":"powerstate",
               "value":"on",
               "extensions":{
                  "extension1":"",
                  "extension2":""
              }
            }
         ｝

服務開發示例URL

由於天貓本身並沒有提供託管服務，因此開發者需要準備一臺服務器用於服務程序部署運行。開發過程中建議開發者不要再服務程序中做過多的邏輯處理，而是將主要邏輯處理放在雲端UDS內部進行處理,在服務中調用sendToService接口,請求UDS進行處理具體邏輯詳見服務程序示例，該示例爲node.js開發者可選擇其他語言自行實現。至此天貓接入流程完成，可以在鎮機上針對天貓精靈進行測。示例地址: https://github.com/AbleCloudGit/tmallbot_server_demo/blob/master/tmallbot_server_demo.js