如何利用D3引擎來創(chuàng)建APP和短信推送規(guī)則

使用D3引擎，只需“拖拉拽”即可輕松創(chuàng)建APP和短信推送規(guī)則，即可將設(shè)備、用戶數(shù)據(jù)與外部第三方數(shù)據(jù)進行有機整合。使用門檻低，小白也可輕松利用D3引擎來創(chuàng)建APP和短信推送規(guī)則。01 D3規(guī)則引擎/D3 Engine

D3規(guī)則引擎（D3 Engine，全稱 Dynamic Data Director Engine），是機智云為開發(fā)者提供的傻瓜式的數(shù)據(jù)處理、開發(fā)引擎?？梢造`活定義數(shù)據(jù)的輸入，能將設(shè)備、用戶數(shù)據(jù)與外部第三方數(shù)據(jù)進行有機整合，還可以支持腳本解析與自定義數(shù)據(jù)輸入，滿足不同開發(fā)者的數(shù)據(jù)處理需要。主要特點如下：◆ 多樣的數(shù)據(jù)源。支持自定義多種數(shù)據(jù)源，第三方公共數(shù)據(jù)甚至您的ERP系統(tǒng)的數(shù)據(jù)輸入。◆ 強大的規(guī)則處理。基于決策樹算法支持靈活多重條件組合。

◆ 靈活的輸出。除了App推送、郵件、短信等服務(wù)，還可以支持回調(diào)服務(wù)以及存儲服務(wù)；存儲服務(wù)通過數(shù)據(jù)平臺的計算與開放API服務(wù)對各類應(yīng)用提供數(shù)據(jù)服務(wù)，降低各類應(yīng)用的開發(fā)成本以及面對海量數(shù)據(jù)的性能處理風(fēng)險。

02 D3 引擎申請條件?

◆ 機智云企業(yè)開發(fā)者，購買了GDCS服務(wù)包的企業(yè)客戶，可申請D3 規(guī)則引擎功能，免費使用推送100條/天。

◆ 機智云個人開發(fā)者/學(xué)生參加IoT畢設(shè)活動，即可免費申請體驗D3 規(guī)則引擎，點擊了解活動詳情。03 D3 引擎申請流程

第一步：登錄機智云新版【開發(fā)者中心】，在組織層面開通【D3 Engine】服務(wù)后，全部產(chǎn)品均可使用該服務(wù)。https://developer.gizwits.com/#/login第二步：點擊【賬號】，選擇【企業(yè)信息】頁面，選擇左側(cè)組織，點擊【服務(wù)中心】；

第三步：選擇【規(guī)則引擎】（D3 Engine），點擊【立即開通】按鈕，等待機智云審核；

第四步：待審核通過后，點擊【返回舊版】，需返回舊版開發(fā)者中心使用此功能。（由于新版功能還在完善中，部分功能仍會在舊版使用中）。

第五步：選擇產(chǎn)品，在服務(wù)列表即可看到【D3 Engine】；點擊【D3 Engine】即可開始體驗。04 D3 引擎使用說明

◆ 項目列表

進入D3 Engine，默認(rèn)進入此產(chǎn)品的項目列表頁面。

項目列表為空時，頁面顯示如上圖?！拘陆椖俊浚狐c擊后跳轉(zhuǎn)至新建項目頁面。

【APP推送配置】：點擊后跳轉(zhuǎn)至APP推送配置頁面。

項目列表不為空時，頁面顯示如上圖。本頁面顯示該產(chǎn)品所創(chuàng)建的所有項目（不包含通過調(diào)用接口創(chuàng)建的項目）。顯示字段為項目ID、項目名稱、動作類型、備注、是否開啟等。【新建項目】：點擊此按鈕跳轉(zhuǎn)至新建項目頁面，可為該產(chǎn)品創(chuàng)建新項目；

【編輯】：點擊后進入當(dāng)前項目頁面可進行修改；

【刪除】：點擊此按鈕可將當(dāng)前項目刪除。

【是否開啟】：項目是否開啟按鈕。項目創(chuàng)建成功后默認(rèn)開啟。點擊關(guān)閉后該項目將不會被觸發(fā)。

◆ 配置

進入D3 Engine，默認(rèn)進入此產(chǎn)品的【項目列表】頁面，點擊【配置】進入APP推送配置頁面。

當(dāng)前產(chǎn)品無綁定的應(yīng)用時，頁面顯示如上圖。【應(yīng)用配置】：點擊后跳轉(zhuǎn)至應(yīng)用配置頁面，可創(chuàng)建新應(yīng)用。

當(dāng)前產(chǎn)品有綁定的應(yīng)用時，頁面顯示如上圖，列出該產(chǎn)品綁定的所有應(yīng)用。

iOS和Android類型支持配置推送，微信暫不支持。【編輯推送平臺】：點擊后跳轉(zhuǎn)至APP綁定第三方推送的配置界面。

◆ 編輯推送平臺

此頁面可以為APP綁定百度推送或者極光推送?！緫?yīng)用平臺】：創(chuàng)建應(yīng)用時所選的類型iOS、Android、微信（暫不支持配置推送）

【推送平臺】：目前僅支持百度推送和極光推送兩種方式。

【推送Key和Secret】：從百度推送或極光推送平臺申請的Key和Secret。

【證書類型】：生產(chǎn)和開發(fā)兩種證書類型。iOS應(yīng)用須選擇證書類型（且應(yīng)根據(jù)所選證書類型上傳對應(yīng)證書至百度或極光推送平臺上），Android應(yīng)用無需證書。

輸入百度推送API Key、Secret Key或者極光推送App Key、Master Key綁定成功后效果如下圖：

再次點擊編輯推送平臺，可進行解綁及修改操作。

◆ 新建/編輯項目

【返回】：點擊此按鈕，返回至項目列表頁。

【保存】：點擊對當(dāng)前所編輯的項目進行保存（無法保存時會有出錯提示）。

【左側(cè)節(jié)點】：項目組成部分，不同類型的節(jié)點，使用拖拽的方式拖至中間空白區(qū)域。分為三類：輸入、處理方法、觸發(fā)動作。

【中間區(qū)域】：項目編輯區(qū)域，可拖拽頁面左側(cè)節(jié)點至此部分進行項目創(chuàng)建和修改等操作。

【右下角三個圖標(biāo)】：可對頁面進行縮小、恢復(fù)默認(rèn)及放大的操作（僅針對項目編輯區(qū)域有效）。

◆ 輸入節(jié)點

1）設(shè)備數(shù)據(jù)使用接入機智云的設(shè)備的數(shù)據(jù)作為輸入。當(dāng)有報警或故障數(shù)據(jù)點時，設(shè)備報警或設(shè)備故障選項才會顯示。

2）自定義數(shù)據(jù)

使用自定義的JSON格式的數(shù)據(jù)作為輸入。

【Schema】：描述JSON字符串內(nèi)部包含的字段結(jié)構(gòu)?？梢允褂靡韵鹿ぞ呱桑篽ttp://jsonschema.net/#/

【數(shù)據(jù)標(biāo)識名】：用于引用此請求返回的JSON標(biāo)識。

【更新間隔】：不小于5s，請求的緩存過期時間。D3會將自定義數(shù)據(jù)緩存起來，每經(jīng)過一個更新間隔會重新獲取數(shù)據(jù)。

◆ 處理方法節(jié)點

1）邏輯規(guī)則添加一個邏輯條件。比較參數(shù)可以是數(shù)據(jù)點值也可以是自定義的變量值。

2）四則運算添加一個由四則運算表達式指定的中間變量。此處只能針對數(shù)值類型的數(shù)據(jù)點進行四則表達式運算。變量標(biāo)識請不要使用中文。

◆ 觸發(fā)動作節(jié)點

1）APP推送規(guī)則觸發(fā)成功時，與設(shè)備綁定的APP用戶將收到一條推送消息。

此處可以編輯推送消息的標(biāo)題、推送內(nèi)容（可從參數(shù)中選擇自動替換的變量）、選擇推送應(yīng)用及消息類型，可以自定義推送的時間段。

2）HTTP請求規(guī)則觸發(fā)成功時，向指定的API發(fā)送一個請求。在此節(jié)點中輸入要請求API的詳細參數(shù)。

3）郵件規(guī)則觸發(fā)成功時，指定的郵箱將收到一封推送郵件。此節(jié)點定義郵件主題、郵件內(nèi)容及收件人信息。

4）短信推送規(guī)則觸發(fā)成功時，與設(shè)備綁定的APP用戶的手機號碼將收到一條短信消息。Apikey和短信模板ID可以從云片獲取，此處會進行校驗。展開屬性可自定義消息接收時間。

5）控制設(shè)備規(guī)則觸發(fā)成功時，該設(shè)備改變自己的狀態(tài)。控制內(nèi)容中以JSON格式填入，支持Raw和KV兩種格式。

◆ 舉例說明

產(chǎn)品名稱：空氣凈化器

數(shù)據(jù)點：

空氣質(zhì)量（air_quality） 枚舉型 優(yōu)秀，良好，一般，污染

溫度（temperture） 數(shù)值型 -128~128

消耗品1（consumable1） 數(shù)值型 0~100

消耗品2（consumable2） 數(shù)值型 0~100

舉例1：設(shè)備上線時，推送消息給app用戶同時推送郵件給xxxx@126.com郵箱第一步：打開【空氣凈化器】產(chǎn)品的新建項目頁面。

第二步：拖動【設(shè)備數(shù)據(jù)】節(jié)點到項目編輯區(qū)域。

第三步：雙擊【設(shè)備數(shù)據(jù)】節(jié)點進行編輯，點擊【確定】即保存。

第四步：拖動【APP推送】節(jié)點到項目編輯區(qū)域。

第五步：雙擊【APP推送】節(jié)點進行編輯（定義推送標(biāo)題、內(nèi)容、時間段等參數(shù)，可參考觸發(fā)動作節(jié)點APP推送節(jié)點說明），點擊【確定】即保存。

第六步：拖動【郵件】節(jié)點到項目編輯區(qū)域，并雙擊進行編輯（定義推送人、推送內(nèi)容、推送標(biāo)題等參數(shù)，可參考觸發(fā)動作節(jié)點郵件推送節(jié)點說明），點擊【確定】即保存

第七步：將三個節(jié)點連結(jié)起來。

第八步：點擊右上角【保存】按鈕，項目創(chuàng)建成功。

舉例2：空氣質(zhì)量等于一般且消耗品1和消耗品2的平均值小于30時，推送消息給app用戶第一步：拖動【設(shè)備數(shù)據(jù)】節(jié)點到項目編輯區(qū)域。

第二步：雙擊進行編輯，選擇設(shè)備上報狀態(tài)，點擊【確定】即保存。

第三步：拖動【邏輯規(guī)則】節(jié)點到項目編輯區(qū)域。

第四步：雙擊【邏輯規(guī)則】節(jié)點進行編輯，點擊【確定】即保存。

進入【邏輯規(guī)則】編輯框，比較參數(shù)1選擇數(shù)據(jù)點值（空氣質(zhì)量），比較符號選擇等于，比較參數(shù)2選擇值且從下拉列表中選擇具體值（一般），點擊【確定】保存。

第五步：拖動【四則運算】節(jié)點到項目編輯區(qū)域

第六步：雙擊【四則運算】節(jié)點進行編輯，點擊【確定】即保存

此步驟定義一個中間變量Avg = （消耗品1+消耗品2）/2

【算述表達式】中公式輸入步驟：點擊運算符中的左括號（，從【參數(shù)】下拉列中選擇“消耗品1”點擊添加，點擊運算符中的+，從【參數(shù)】下拉列表中選擇“消耗品2”點擊添加，點擊運算符中的右括號），點擊運算符中的除號/，輸入數(shù)字2

【變量標(biāo)識】中給變量起個名稱（例如Avg）

第七步：再拖動一個【邏輯運算】節(jié)點到項目編輯區(qū)域，并雙擊進行編輯，點擊【確定】即保存。進入【邏輯規(guī)則】編輯框，比較參數(shù)1選擇上一步定義的中間變量（Avg），中間比較符號選擇小于，比較參數(shù)2選擇值且輸入數(shù)字（30），點擊【確定】保存。

第八步：拖動【APP推送】節(jié)點到項目編輯區(qū)域，并雙擊進行編輯，點擊【確定】保存?！続PP推送】節(jié)點設(shè)置請參考觸發(fā)動作節(jié)點_APP推送節(jié)點說明。

第九步：將五個節(jié)點連接起來。

第十步：點擊右上角【保存】按鈕，項目創(chuàng)建成功。