前言

在 5G 熱潮的推動下，IoT 愈發(fā)的如火如荼。越來越多品牌選擇涂鴉智能的開發(fā)者平臺實現(xiàn)產(chǎn)品智能化。在配網(wǎng)控制端，也有更多開發(fā)者希望利用好微信小程序即開即用低門檻的優(yōu)點，提高設(shè)備配網(wǎng)率以及使用頻次或?qū)崿F(xiàn)設(shè)備分享功能。業(yè)務(wù)完全可以以小程序為核心，例如小兔健康小程序，在小程序里就能實現(xiàn)產(chǎn)品購買、配網(wǎng)、控制管理的閉環(huán)。
為此，涂鴉推出了 Tuya-Weapp-CloudBase SDK（以下簡稱小程序 SDK）, 結(jié)合騰訊云函數(shù)，讓您可以快速高效的完成小程序的開發(fā)，打通從智能設(shè)備到小程序的鏈路。

---

使用步驟

? 第 1 步：獲取小程序 SDK 授權(quán)

為了獲取小程序的 SDK 及相關(guān)授權(quán)，您需要在 IoT 平臺上創(chuàng)建小程序 SDK。

1. 登錄 涂鴉 IoT 控制臺的 App 工作臺。
2. 單擊 App 工作臺，選擇 小程序 SDK。
3. 單擊 創(chuàng)建小程序。
   
4. 輸入小程序名稱（和您的小程序同名）、小程序 AppID（可在微信小程序后臺查看）、小程序描述、小程序，單擊 確定。
   創(chuàng)建成功之后，可以獲取到專屬于您 SDK 的 Schema，AccessID，AppSecret。其中 Schema 用來標(biāo)識一個您的應(yīng)用（在這里就是表示您的小程序），AccessID 和 AppSecret 用來生成 Token 信息。

? 第 2 步：啟動 Demo 項目

接下來您可以克隆 項目倉庫 里的示例代碼。

1. 克隆項目代碼。

$ git clone https://github.com/TuyaInc/tuya-miniapp-demo.git

2. 安裝相關(guān)依賴。

$ npm install

3. 開啟自動打包。

$ npm run dev:weapp

4. 啟動微信開發(fā)工具，單擊 導(dǎo)入項目，導(dǎo)入您的項目。

5. 選擇項目目錄，填寫您的 AppID，單擊 導(dǎo)入。

小程序?qū)胫?#xff0c;會自動進(jìn)入小程序的設(shè)備列表頁，如果看到 “網(wǎng)絡(luò)錯誤” 的信息提示，表明項目導(dǎo)入成功，但是未能上傳云函數(shù)，可以參考下一步來上傳云函數(shù)。

? 第 3 步：上傳云函數(shù)

您的小程序如果要訪問涂鴉云，需要通過之前獲得的 AccessID 和 AppSecret 去調(diào)涂鴉云端接口生成訪問涂鴉云的 Token。通常情況下這種操作都是由服務(wù)端完成，詳情請參考 云開發(fā)平臺方案介紹，但是也可以用更簡單方便的小程序云函數(shù)的方式，相關(guān)的代碼及 SDK 我們已準(zhǔn)備好，請根據(jù)下面的示例來操作。

1. 在小程序開發(fā)者工具中選中云函數(shù)目錄的 ty-service（該目錄是我們的涂鴉云函數(shù)目錄，主要是登錄、token 生成、統(tǒng)一接口調(diào)用等功能的封裝） 上傳上去。
   
   如果沒有開通云開發(fā)環(huán)境，單擊 “云開發(fā)” 的時候會引導(dǎo)您自助開通。
2. 項目中調(diào)用云函數(shù)的工具方法在 src/Utils/Request.ts 中，通過云函數(shù)調(diào)用涂鴉的 API 的方式可以參照下面的示例。

const params = {
	    name: 'ty-service', // 云函數(shù)名稱
	    data: {
	      action: 'hello', // 涂鴉云接口名
	      params: {} // 接口參數(shù)
	    }
	  }
	  // 調(diào)用 Request 
	  return Request(params)

? 第 4 步：騰訊云云開發(fā)配置

云開發(fā)配置主要是為了配置您之前獲得的的 Schema，AccessID，AppSecret，用于在云函數(shù)云端生成 Token 并提供給小程序使用。這些信息存儲在云開發(fā)的數(shù)據(jù)庫中，可以保證云函數(shù)能夠方便調(diào)用的同時還能最大限度的保證信息安全?？梢愿鶕?jù)下面的示例來操作。

1. 單擊 云開發(fā)，進(jìn)入 數(shù)據(jù)庫，添加名稱為 “iot-collection” 的集合，單擊 確定。
   
2. 選擇 “iot-collection” 集合，，選擇項目目錄 db/data.json 文件，單擊 導(dǎo)入 按鈕，即可導(dǎo)入相關(guān)字段。
3. 導(dǎo)入完成之后填寫涂鴉 IoT 工作臺上小程序 SDK 的 Schema、AccessID、AppSecret 的內(nèi)容。
4. 配置完成之后，刷新一下小程序，可以看到一個 “歡迎使用涂鴉云小程序云函數(shù)”，說明云函數(shù)配置成功。
   
   SDK 更多的信息和調(diào)用說明，請參考小程序 SDK 概述。

? 第 5 步：為設(shè)備配網(wǎng)

目前小程序支持 AP 模式（慢閃熱點）配網(wǎng)，后期還將支持藍(lán)牙配網(wǎng)。通過配網(wǎng)，可以將一個設(shè)備配到您的賬號下，您就有權(quán)限控制這個設(shè)備。

1. 單擊微信小程序開發(fā)工具的 預(yù)覽，在彈出的二維碼使用微信去掃碼。

2. 在手機的小程序中單擊 添加設(shè)備 按鈕，進(jìn)入配網(wǎng)頁面。
   

3. 將設(shè)備重置到 AP 配網(wǎng)模式，可以參照下面的視頻來操作。
   

   設(shè)備重置到 AP 配網(wǎng)模式（暫時存放）

4. 設(shè)備重置 AP 配網(wǎng)模式后，開始在小程序上配網(wǎng)，可以參照下面的視頻來操作。
   

   小程序配網(wǎng)（暫時存放）

5. 配網(wǎng)成功后，進(jìn)入設(shè)備控制頁，就能控制配網(wǎng)的設(shè)備。
   

小結(jié)

基于涂鴉開發(fā)平臺和小程序 SDK，可以快速實現(xiàn)一款智能小程序，搭配使用 三明治開發(fā)套件，也可以用它搭建一個產(chǎn)品原型來實現(xiàn)最后一個步驟。

擴展

如果您希望您的小程序不僅僅是配網(wǎng)、控制這些常規(guī)功能，希望結(jié)合云端算法提供更多服務(wù)，可以結(jié)合 涂鴉云開發(fā)平臺 里的開放接口做進(jìn)一步的整合。您也可以訪問我們的 案例中心 參考其他開發(fā)者的成功案例。