智慧型住宅填入特徵

action.devices.traits.Fill - 此特徵適用於支援填充式裝置 (例如浴缸)。

裝置屬性

具備這項特徵的裝置可能會回報下列資料： 在 SYNC 作業中使用屬性變更。學習 如要進一步瞭解如何處理 SYNC 意圖，請參閱 意圖執行要求。

屬性	類型	說明
availableFillLevels	物件	說明填充裝置的不同濃度。
levels	陣列	必要。 等級名稱和特定語言的同義詞清單。
[item, ...]	物件	等級名稱和其語言對應的同義詞。
level_name	String	必要。 關卡的內部名稱。這項功能不容易使用，且可供所有語言共用。
level_values	陣列	必要。 各種支援語言中等級的同義詞。
[item, ...]	物件	特定語言等級的同義詞。
level_synonym	陣列	必要。 關卡的同義詞。這份清單中的第一個字串會做為該語言等級的標準名稱。
[item, ...]	String	同義詞名稱。
lang	String	必要。 語言代碼 (ISO 639-1)。查看支援的語言。
ordered	布林值	必要。 如果為 true，裝置會處理增加或減少邏輯的額外文法，以 levels 陣列表示 (例如半層)。
supportsFillPercent	布林值	(預設值：false) 如果為 true，接受將等級調整為百分比的指令。

範例

裝置具備基本填充或耗盡功能，不支援離散的填滿程度。

{}

支援獨立填充等級的裝置。

{
  "availableFillLevels": {
    "levels": [
      {
        "level_name": "half_level",
        "level_values": [
          {
            "level_synonym": [
              "Half",
              "Half way",
              "One half"
            ],
            "lang": "en"
          }
        ]
      },
      {
        "level_name": "full_level",
        "level_values": [
          {
            "level_synonym": [
              "Full",
              "All the way",
              "Complete"
            ],
            "lang": "en"
          }
        ]
      }
    ],
    "ordered": true
  }
}

裝置狀態

具有此特徵的實體可能會回報下列資料： 做為 QUERY 作業的一部分。學習 如要進一步瞭解如何處理 QUERY 意圖，請參閱 意圖執行要求。

州	類型	說明
isFilled	布林值	必要。 如果裝置填滿任何層級，則為「是」。如果裝置已耗盡，則為 False。
currentFillLevel	String	如果已設定 availableFillLevels 屬性，則為必要屬性。指出目前來自裝置填入的 availableFillLevels 屬性的 level_name。
currentFillPercent	Number	如果已設定 supportsFillPercent 屬性，則為必要屬性。指出目前的填滿程度百分比。

範例

浴缸裡有滿滿了嗎？

{
  "isFilled": true
}

浴缸裡有滿滿了嗎？分為兩個等級。

{
  "isFilled": true,
  "currentFillLevel": "half_level"
}

裝置指令

具備這種特徵的裝置可能會回應下列問題 做為 EXECUTE 作業的一部分。學習 如要進一步瞭解如何處理 EXECUTE 意圖，請參閱 意圖執行要求。

action.devices.commands.Fill

填滿裝置或讓裝置充滿電。

參數

參數	類型	說明
fill	布林值	必要。 設為 True 以填滿，設為 false 時可清空。
fillLevel	String	指出 availableFillLevels 屬性中要設定的 level_name。如果未指定，則會填入預設層級。
fillPercent	Number	指出要求的等級百分比。

範例

輸入浴缸。

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true
  }
}

清空浴缸。

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": false
  }
}

將浴缸填滿一半。

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "half_level"
  }
}

將浴缸的填充值調高一 (必須將 ordered 屬性設為 true)。

{
  "command": "action.devices.commands.Fill",
  "params": {
    "fill": true,
    "fillLevel": "full_level"
  }
}

裝置錯誤

查看完整清單 錯誤和例外狀況。