數據類型和取值約束說明

前序系列文章>>>ide

接口列表—智能門鎖url

對各類數據類型以及平臺使用的數據作一個簡單的說明~.net

1、數據類型對象

  • 布爾型(Boolean):非真即假的二值型變量。例如,開關功能,取值爲開或關。
  • 數值型(Integer):適用於可線性調節類型的數據。例如:溫度調節,溫度範圍 20-40℃。
  • 枚舉型(Enum):有限集合值。例如:工做檔位,低檔、中檔或高檔。
  • 字符串型(String):字符串類型。
  • 對象類型(Json):下發的值是一個對象的 Json 格式,會有對應對象屬性的說明解釋。
    2、數據傳輸類型:
    blog

  • 可下發可上報:指令數據能夠下發給設備,設備數據能夠上報給雲端。
  • 只上報:數據只支持從設備上報。
  • 只下發:數據只支持從雲端下發。
    3、取值約束

(一)Integer 類型示例格式:接口

{"min":11,"unit":"s","scale":0,"max":86400,"step":1}文檔

取值約束說明字符串

  • min:最小取值。示例值:11。
  • max:最大取值。示例值:86400。
  • unit:數值的單位。示例值:s 。
  • scale:數據將以 10 的指數轉換進行傳輸。示例:0, 表示 10 的 0 次方,即1。
  • step:數據增量間距(即步長)。示例值:1。
    Scale 參數說明

如下爲當前電壓取值的取值約束示例。scale 的取值是 1。
若是查詢設備狀態獲得的值是 {"cur_voltage":2230},那麼用戶可讀值爲 2230/(10^1 )= 223V (即電壓是:223伏特)。
數據類型和取值約束說明

get

取值約束範圍說明
本文檔中在指定的取值範圍約束爲參考範圍,實際每一個設備有特定的具體取值約束範圍。

(二)String 類型示例格式


{"maxlen":255}


it

取值約束說明

maxlen:值最大長度。示例值:255。
(三)Enum 類型示例格式

{"range":["1","2","3","4","5"]}

取值約束說明

range:枚舉取值限定範圍。示例爲:"1","2","3","4","5"。

相關文章
相關標籤/搜索