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

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

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

02 D3 引擎申請(qǐng)條件?

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

◆ 機(jī)智云個(gè)人開發(fā)者/學(xué)生參加IoT畢設(shè)活動(dòng)，即可免費(fèi)申請(qǐng)?bào)w驗(yàn)D3 規(guī)則引擎，點(diǎn)擊了解活動(dòng)詳情。03 D3 引擎申請(qǐng)流程

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

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

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

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

◆ 項(xiàng)目列表

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

項(xiàng)目列表為空時(shí)，頁(yè)面顯示如上圖。【新建項(xiàng)目】：點(diǎn)擊后跳轉(zhuǎn)至新建項(xiàng)目頁(yè)面。

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

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

【編輯】：點(diǎn)擊后進(jìn)入當(dāng)前項(xiàng)目頁(yè)面可進(jìn)行修改；

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

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

◆ 配置

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

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

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

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

◆ 編輯推送平臺(tái)

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

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

【推送Key和Secret】：從百度推送或極光推送平臺(tái)申請(qǐng)的Key和Secret。

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

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

再次點(diǎn)擊編輯推送平臺(tái)，可進(jìn)行解綁及修改操作。

◆ 新建/編輯項(xiàng)目

【返回】：點(diǎn)擊此按鈕，返回至項(xiàng)目列表頁(yè)。

【保存】：點(diǎn)擊對(duì)當(dāng)前所編輯的項(xiàng)目進(jìn)行保存（無(wú)法保存時(shí)會(huì)有出錯(cuò)提示）。

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

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

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

◆ 輸入節(jié)點(diǎn)

1）設(shè)備數(shù)據(jù)使用接入機(jī)智云的設(shè)備的數(shù)據(jù)作為輸入。當(dāng)有報(bào)警或故障數(shù)據(jù)點(diǎn)時(shí)，設(shè)備報(bào)警或設(shè)備故障選項(xiàng)才會(huì)顯示。

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

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

【Schema】：描述JSON字符串內(nèi)部包含的字段結(jié)構(gòu)。可以使用以下工具生成：http://jsonschema.net/#/

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

【更新間隔】：不小于5s，請(qǐng)求的緩存過(guò)期時(shí)間。D3會(huì)將自定義數(shù)據(jù)緩存起來(lái)，每經(jīng)過(guò)一個(gè)更新間隔會(huì)重新獲取數(shù)據(jù)。

◆ 處理方法節(jié)點(diǎn)

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

2）四則運(yùn)算添加一個(gè)由四則運(yùn)算表達(dá)式指定的中間變量。此處只能針對(duì)數(shù)值類型的數(shù)據(jù)點(diǎn)進(jìn)行四則表達(dá)式運(yùn)算。變量標(biāo)識(shí)請(qǐng)不要使用中文。

◆ 觸發(fā)動(dòng)作節(jié)點(diǎn)

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

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

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

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

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

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

◆ 舉例說(shuō)明

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

數(shù)據(jù)點(diǎn)：

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

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

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

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

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

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

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

第四步：拖動(dòng)【APP推送】節(jié)點(diǎn)到項(xiàng)目編輯區(qū)域。

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

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

第七步：將三個(gè)節(jié)點(diǎn)連結(jié)起來(lái)。

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

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

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

第三步：拖動(dòng)【邏輯規(guī)則】節(jié)點(diǎn)到項(xiàng)目編輯區(qū)域。

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

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

第五步：拖動(dòng)【四則運(yùn)算】節(jié)點(diǎn)到項(xiàng)目編輯區(qū)域

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

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

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

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

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

第八步：拖動(dòng)【APP推送】節(jié)點(diǎn)到項(xiàng)目編輯區(qū)域，并雙擊進(jìn)行編輯，點(diǎn)擊【確定】保存。【APP推送】節(jié)點(diǎn)設(shè)置請(qǐng)參考觸發(fā)動(dòng)作節(jié)點(diǎn)_APP推送節(jié)點(diǎn)說(shuō)明。

第九步：將五個(gè)節(jié)點(diǎn)連接起來(lái)。

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