Smart Home SoftwareUpdate 特徵結構定義

action.devices.traits.SoftwareUpdate:這個特徵屬於支援軟體更新 (例如路由器) 的裝置。

裝置屬性

無。

裝置狀態

具有這個特性的實體可能會在 QUERY 作業中回報下列狀態。如要進一步瞭解如何處理 QUERY 意圖,請參閱「意圖執行要求」。

狀態 類型 說明
lastSoftwareUpdateUnixTimestampSec 整數

必要。

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

範例

我的裝置上次更新是什麼時候?(2000 年 1 月 1 日)

{
  "lastSoftwareUpdateUnixTimestampSec": 946652400
}

裝置指令

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

action.devices.commands.SoftwareUpdate

更新裝置。

參數

參數 類型 說明

沒有任何資源

範例

更新裝置上的軟體。

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

裝置錯誤

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