智慧型住宅加濕器指南

action.devices.types.HUMIDIFIER - 加濕器是指可增加空氣濕度的裝置。包括開啟或關閉這些功能、回報及調整目標濕度,而且可能有各種可調整的模式或風扇速度設定。

這個類型表示裝置會取得加濕器圖示和一些相關 同義詞和別名

請參閱 導入詳細資料,例如服務應支援的屬性和狀態,以及 建立「EXECUTE」和「QUERY」回應。

您必須具有這些特徵和指令 (如果有的話) 裝置。如果您的裝置不支援這些特徵,請輸入 在 QUERY 或 EXECUTE 回應中使用 functionNotSupported。詳情請見 詳情請參閱錯誤和例外狀況

建議您採用這些特性 (如果裝置適用的話)。 不過,您可以自由搭配運用所有可用的特徵,完美搭配 產品功能。

品質規定

  • 延遲時間:必須小於或等於 1000 毫秒
  • 可靠性:必須大於或等於 97%

範例裝置:簡易加濕器

本節包含代表常見「Humidifier」的意圖酬載範例 根據上述裝置類型和特徵建立廣告如果您在實作中新增或移除特徵, 請據此修改回應。

SYNC 回應範例

,瞭解如何調查及移除這項存取權。
{
 
"requestId": "6894439706274654512",
 
"inputs": [
   
{
     
"intent": "action.devices.SYNC"
   
}
 
]
}
{
 
"requestId": "6894439706274654512",
 
"payload": {
   
"agentUserId": "user123",
   
"devices": [
     
{
       
"id": "123",
       
"type": "action.devices.types.HUMIDIFIER",
       
"traits": [
         
"action.devices.traits.FanSpeed",
         
"action.devices.traits.HumiditySetting",
         
"action.devices.traits.OnOff"
       
],
       
"name": {
         
"name": "Simple humidifier"
       
},
       
"willReportState": true,
       
"attributes": {
         
"humiditySetpointRange": {
           
"minPercent": 30,
           
"maxPercent": 100
         
},
         
"availableFanSpeeds": {
           
"speeds": [
             
{
               
"speed_name": "low_key",
               
"speed_values": [
                 
{
                   
"speed_synonym": [
                     
"Low",
                     
"Slow"
                   
],
                   
"lang": "en"
                 
},
                 
{
                   
"speed_synonym": [
                     
"Niedrig",
                     
"Schleppend"
                   
],
                   
"lang": "de"
                 
}
               
]
             
},
             
{
               
"speed_name": "high_key",
               
"speed_values": [
                 
{
                   
"speed_synonym": [
                     
"High"
                   
],
                   
"lang": "en"
                 
},
                 
{
                   
"speed_synonym": [
                     
"Hoch"
                   
],
                   
"lang": "de"
                 
}
               
]
             
}
           
],
           
"ordered": true
         
}
       
},
       
"deviceInfo": {
         
"manufacturer": "smart-home-inc",
         
"model": "hs1234",
         
"hwVersion": "3.2",
         
"swVersion": "11.4"
       
}
     
}
   
]
 
}
}

QUERY 回應範例

,瞭解如何調查及移除這項存取權。
{
 
"requestId": "6894439706274654514",
 
"inputs": [
   
{
     
"intent": "action.devices.QUERY",
     
"payload": {
       
"devices": [
         
{
           
"id": "123"
         
}
       
]
     
}
   
}
 
]
}
{
 
"requestId": "6894439706274654514",
 
"payload": {
   
"devices": {
     
"123": {
       
"status": "SUCCESS",
       
"online": true,
       
"on": true,
       
"currentFanSpeedSetting": "low_key",
       
"humiditySetpointPercent": 50,
       
"humidityAmbientPercent": 40
     
}
   
}
 
}
}

EXECUTE 指令範例

SetFanSpeed

如要進一步瞭解指令參數 請參閱 action.devices.traits.FanSpeed 參照。

,瞭解如何調查及移除這項存取權。
{
 
"requestId": "6894439706274654516",
 
"inputs": [
   
{
     
"intent": "action.devices.EXECUTE",
     
"payload": {
       
"commands": [
         
{
           
"devices": [
             
{
               
"id": "123"
             
}
           
],
           
"execution": [
             
{
               
"command": "action.devices.commands.SetFanSpeed",
               
"params": {
                 
"fanSpeed": "high_key"
               
}
             
}
           
]
         
}
       
]
     
}
   
}
 
]
}
{
 
"requestId": "6894439706274654516",
 
"payload": {
   
"commands": [
     
{
       
"ids": [
         
"123"
       
],
       
"status": "SUCCESS",
       
"states": {
         
"online": true,
         
"currentFanSpeedSetting": "high_key"
       
}
     
}
   
]
 
}
}

SetHumidity

如要進一步瞭解指令參數 請參閱 action.devices.traits.HumiditySetting 參照。

,瞭解如何調查及移除這項存取權。
{
 
"requestId": "6894439706274654518",
 
"inputs": [
   
{
     
"intent": "action.devices.EXECUTE",
     
"payload": {
       
"commands": [
         
{
           
"devices": [
             
{
               
"id": "123"
             
}
           
],
           
"execution": [
             
{
               
"command": "action.devices.commands.SetHumidity",
               
"params": {
                 
"humidity": 60
               
}
             
}
           
]
         
}
       
]
     
}
   
}
 
]
}
{
 
"requestId": "6894439706274654518",
 
"payload": {
   
"commands": [
     
{
       
"ids": [
         
"123"
       
],
       
"status": "SUCCESS",
       
"states": {
         
"online": true,
         
"humiditySetpointPercent": 60,
         
"humidityAmbientPercent": 40
       
}
     
}
   
]
 
}
}

OnOff

如要進一步瞭解指令參數 請參閱 action.devices.traits.OnOff 參照。

,瞭解如何調查及移除這項存取權。
{
 
"requestId": "6894439706274654520",
 
"inputs": [
   
{
     
"intent": "action.devices.EXECUTE",
     
"payload": {
       
"commands": [
         
{
           
"devices": [
             
{
               
"id": "123"
             
}
           
],
           
"execution": [
             
{
               
"command": "action.devices.commands.OnOff",
               
"params": {
                 
"on": true
               
}
             
}
           
]
         
}
       
]
     
}
   
}
 
]
}
{
 
"requestId": "6894439706274654520",
 
"payload": {
   
"commands": [
     
{
       
"ids": [
         
"123"
       
],
       
"status": "SUCCESS",
       
"states": {
         
"online": true,
         
"on": true
       
}
     
}
   
]
 
}
}

裝置錯誤

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