Akıllı Ev Hava Soğutucusu Kılavuzu
action.devices.types.AIRCOOLER - Hava soğutucuları, sıcaklık soğutmayı ve nem kontrolünü sağlayan cihazlardır. Bu cihazlar genellikle klimalardan daha hafiftir ve taşınabilirdir, ayrıca su deposu vardır. Hava soğutucuları, ısıtma veya tam sıcaklıkların ayarlanmasını desteklemeyebilir. Hava soğutucularıyla etkileşimler, havalandırma ve nem ayarının değiştirilmesini içerebilir.
Bu tür, cihazın Hava Soğutucu simgesini ve bazı ilgili eş anlamlıları ve takma adları aldığını gösterir.
Cihaz özellikleri
Hizmetinizin desteklemesi gereken özellikler ve durumlar, EXECUTE ve QUERY yanıtlarının nasıl oluşturulacağı gibi uygulama ayrıntıları için ilgili özellik dokümanlarına bakın.
Gerekli özellikler
Cihazınız için geçerliyse bu özellikler ve komutlar gerekir.
-
action.devices.traits.FanSpeed -
action.devices.traits.HumiditySetting -
action.devices.traits.OnOff -
action.devices.traits.TemperatureSetting
Kalite gereksinimleri
- Gecikme: 1000 ms'den az veya buna eşit olmalıdır.
- Güvenilirlik: %97'den fazla veya bu değere eşit olmalıdır.
Örnek cihaz: Basit hava soğutucu
Bu bölümde, cihaz türüne ve yukarıdaki özelliklere göre ortak bir "Hava Soğutucusu"nu temsil eden örnek yük yükleri yer alır. Uygulamanıza özellik ekler veya mevcut özellikleri kaldırırsanız bu değişiklikleri yansıtacak şekilde yanıtlarınızı uygun şekilde değiştirin.
Örnek SYNC yanıtı
{
"requestId": "6894439706274654512",
"inputs": [
{
"intent": "action.devices.SYNC"
}
]
}
{
"requestId": "6894439706274654512",
"payload": {
"agentUserId": "user123",
"devices": [
{
"id": "123",
"type": "action.devices.types.AIRCOOLER",
"traits": [
"action.devices.traits.FanSpeed",
"action.devices.traits.HumiditySetting",
"action.devices.traits.OnOff",
"action.devices.traits.TemperatureSetting"
],
"name": {
"name": "Simple air cooler"
},
"willReportState": true,
"attributes": {
"humiditySetpointRange": {
"minPercent": 0,
"maxPercent": 50
},
"availableFanSpeeds": {
"speeds": [
{
"speed_name": "off_key",
"speed_values": [
{
"speed_synonym": [
"Off",
"0"
],
"lang": "en"
}
]
},
{
"speed_name": "low_key",
"speed_values": [
{
"speed_synonym": [
"Low",
"1"
],
"lang": "en"
}
]
},
{
"speed_name": "medium_key",
"speed_values": [
{
"speed_synonym": [
"Medium",
"2"
],
"lang": "en"
}
]
},
{
"speed_name": "high_key",
"speed_values": [
{
"speed_synonym": [
"High",
"3"
],
"lang": "en"
}
]
}
],
"ordered": true
},
"availableThermostatModes": [
"off",
"cool",
"on",
"fan-only",
"eco"
],
"thermostatTemperatureUnit": "C"
},
"deviceInfo": {
"manufacturer": "smart-home-inc",
"model": "hs1234",
"hwVersion": "3.2",
"swVersion": "11.4"
}
}
]
}
}
Örnek QUERY yanıtı
{
"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",
"thermostatMode": "cool",
"thermostatTemperatureAmbient": 25,
"thermostatTemperatureSetpoint": 20,
"humiditySetpointPercent": 15,
"humidityAmbientPercent": 10
}
}
}
}
Örnek EXECUTE komutları
Hızı Ayarlayın
Komut parametreleri hakkında ek ayrıntılar için
action.devices.traits.FanSpeed referansına bakın.
{
"requestId": "6894439706274654518",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.SetFanSpeed",
"params": {
"fanSpeed": "high_key"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654518",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"currentFanSpeedSetting": "high_key"
}
}
]
}
}
Nemlendirici
Komut parametreleri hakkında ek ayrıntılar için
action.devices.traits.HumiditySetting referansına bakın.
{
"requestId": "6894439706274654520",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.SetHumidity",
"params": {
"humidity": 20
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654520",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"humiditySetpointPercent": 20,
"humidityAmbientPercent": 10
}
}
]
}
}
Kapalı
Komut parametreleri hakkında ek ayrıntılar için
action.devices.traits.OnOff referansına bakın.
{
"requestId": "6894439706274654516",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.OnOff",
"params": {
"on": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654516",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"on": true
}
}
]
}
}
Termostat Sıcaklık Ayar Noktası
Komut parametreleri hakkında ek ayrıntılar için
action.devices.traits.TemperatureSetting referansına bakın.
{
"requestId": "6894439706274654522",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.ThermostatTemperatureSetpoint",
"params": {
"thermostatTemperatureSetpoint": 22
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654522",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"thermostatMode": "cool",
"thermostatTemperatureSetpoint": 22,
"thermostatTemperatureAmbient": 25.1
}
}
]
}
}
Termostat SetModu
Komut parametreleri hakkında ek ayrıntılar için
action.devices.traits.TemperatureSetting referansına bakın.
{
"requestId": "6894439706274654524",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.ThermostatSetMode",
"params": {
"thermostatMode": "cool"
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654524",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"thermostatMode": "cool",
"thermostatTemperatureSetpoint": 22,
"thermostatTemperatureAmbient": 25.1
}
}
]
}
}