智慧住宅軟體更新特徵結構定義

action.devices.traits.SoftwareUpdate - 這項特徵屬於支援軟體更新的裝置,例如路由器。

裝置屬性

無。

裝置狀態

具有這項特徵的實體可能會回報下列狀態,做為 QUERY 作業的一部分。如要進一步瞭解如何處理 QUERY 意圖,請參閱「意圖完成」。

類型 說明
lastSoftwareUpdateUnixTimestampSec 整數

必要。

上次成功更新軟體的 Unix 時間戳記 (自 Unix 紀元起算的秒數)。Unix 紀元為世界標準時間 1970 年 1 月 1 日 00:00:00。

範例

我的裝置上次更新時間是何時?(2000/1/1)

{
  "lastSoftwareUpdateUnixTimestampSec": 946652400
}

裝置指令

具有這項特徵的裝置可能會在 EXECUTE 作業中回應下列指令。如要進一步瞭解如何處理 EXECUTE 意圖,請參閱「意圖完成」。

action.devices.commands.SoftwareUpdate

更新裝置。

參數

參數 類型 說明

沒有任何屬性

範例

更新裝置上的軟體。

{
  "command": "action.devices.commands.SoftwareUpdate",
  "params": {}
}

裝置錯誤

請參閱「錯誤和例外狀況」的完整清單。