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

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

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

02 D3 引擎申請條件?

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

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

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

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

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

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

◆ 項目列表

進入D3 Engine，默認進入此產品的項目列表頁面。

項目列表為空時，頁面顯示如上圖。【新建項目】：點擊后跳轉至新建項目頁面。

【APP推送配置】：點擊后跳轉至APP推送配置頁面。

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

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

【刪除】：點擊此按鈕可將當前項目刪除。

【是否開啟】：項目是否開啟按鈕。項目創建成功后默認開啟。點擊關閉后該項目將不會被觸發。

◆ 配置

進入D3 Engine，默認進入此產品的【項目列表】頁面，點擊【配置】進入APP推送配置頁面。

當前產品無綁定的應用時，頁面顯示如上圖。【應用配置】：點擊后跳轉至應用配置頁面，可創建新應用。

當前產品有綁定的應用時，頁面顯示如上圖，列出該產品綁定的所有應用。

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

◆ 編輯推送平臺

此頁面可以為APP綁定百度推送或者極光推送。【應用平臺】：創建應用時所選的類型iOS、Android、微信（暫不支持配置推送）

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

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

【證書類型】：生產和開發兩種證書類型。iOS應用須選擇證書類型（且應根據所選證書類型上傳對應證書至百度或極光推送平臺上），Android應用無需證書。

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

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

◆ 新建/編輯項目

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

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

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

【中間區域】：項目編輯區域，可拖拽頁面左側節點至此部分進行項目創建和修改等操作。

【右下角三個圖標】：可對頁面進行縮小、恢復默認及放大的操作（僅針對項目編輯區域有效）。

◆ 輸入節點

1）設備數據使用接入機智云的設備的數據作為輸入。當有報警或故障數據點時，設備報警或設備故障選項才會顯示。

2）自定義數據

使用自定義的JSON格式的數據作為輸入。

【Schema】：描述JSON字符串內部包含的字段結構。可以使用以下工具生成：http://jsonschema.net/#/

【數據標識名】：用于引用此請求返回的JSON標識。

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

◆ 處理方法節點

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

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

◆ 觸發動作節點

1）APP推送規則觸發成功時，與設備綁定的APP用戶將收到一條推送消息。

此處可以編輯推送消息的標題、推送內容（可從參數中選擇自動替換的變量）、選擇推送應用及消息類型，可以自定義推送的時間段。

2）HTTP請求規則觸發成功時，向指定的API發送一個請求。在此節點中輸入要請求API的詳細參數。

3）郵件規則觸發成功時，指定的郵箱將收到一封推送郵件。此節點定義郵件主題、郵件內容及收件人信息。

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

5）控制設備規則觸發成功時，該設備改變自己的狀態。控制內容中以JSON格式填入，支持Raw和KV兩種格式。

◆ 舉例說明

產品名稱：空氣凈化器

數據點：

空氣質量（air_quality） 枚舉型 優秀，良好，一般，污染

溫度（temperture） 數值型 -128~128

消耗品1（consumable1） 數值型 0~100

消耗品2（consumable2） 數值型 0~100

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

第二步：拖動【設備數據】節點到項目編輯區域。

第三步：雙擊【設備數據】節點進行編輯，點擊【確定】即保存。

第四步：拖動【APP推送】節點到項目編輯區域。

第五步：雙擊【APP推送】節點進行編輯（定義推送標題、內容、時間段等參數，可參考觸發動作節點APP推送節點說明），點擊【確定】即保存。

第六步：拖動【郵件】節點到項目編輯區域，并雙擊進行編輯（定義推送人、推送內容、推送標題等參數，可參考觸發動作節點郵件推送節點說明），點擊【確定】即保存

第七步：將三個節點連結起來。

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

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

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

第三步：拖動【邏輯規則】節點到項目編輯區域。

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

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

第五步：拖動【四則運算】節點到項目編輯區域

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

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

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

【變量標識】中給變量起個名稱（例如Avg）

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

第八步：拖動【APP推送】節點到項目編輯區域，并雙擊進行編輯，點擊【確定】保存。【APP推送】節點設置請參考觸發動作節點_APP推送節點說明。

第九步：將五個節點連接起來。

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