Panduan Pendingin Udara Smart Home
action.devices.types.AIRCOOLER - Pendingin udara adalah perangkat yang memungkinkan pendinginan suhu dan kontrol kelembapan. Perangkat ini biasanya lebih ringan dan portabel daripada AC, dan memiliki tangki air terpasang. Pendingin udara mungkin tidak mendukung pemanas atau setelan suhu yang tepat. Interaksi dengan pendingin udara dapat mencakup perubahan setelan kipas dan kecepatan kipas.
Jenis ini menunjukkan bahwa perangkat mendapatkan ikon Air Cooler serta beberapa sinonim dan alias yang terkait.
Kemampuan perangkat
Lihat dokumentasi karakteristik yang sesuai untuk detail implementasi, seperti atribut dan status yang harus didukung oleh layanan Anda, serta cara membuat respons EXECUTE dan QUERY.
Sifat yang diperlukan
Sifat dan perintah ini diperlukan, jika berlaku untuk perangkat Anda.
-
action.devices.traits.FanSpeed -
action.devices.traits.HumiditySetting -
action.devices.traits.OnOff -
action.devices.traits.TemperatureSetting
Persyaratan kualitas
- Latensi: harus kurang dari atau sama dengan 1000 md.
- Keandalan: harus lebih dari atau sama dengan 97%.
Contoh perangkat: Penyejuk udara sederhana
Bagian ini berisi contoh payload intent yang merepresentasikan "Air Cooler" umum berdasarkan jenis dan karakteristik perangkat di atas. Jika Anda menambahkan atau menghapus karakteristik dalam implementasi, ubah respons agar sesuai dengan perubahan tersebut.
Contoh respons SYNC
{
"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"
}
}
]
}
}
Contoh respons 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",
"thermostatMode": "cool",
"thermostatTemperatureAmbient": 25,
"thermostatTemperatureSetpoint": 20,
"humiditySetpointPercent": 15,
"humidityAmbientPercent": 10
}
}
}
}
Contoh perintah EXECUTE
SetFanSpeed
Untuk detail tambahan tentang parameter perintah, lihat referensi
action.devices.traits.FanSpeed.
{
"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"
}
}
]
}
}
SetHumiditas
Untuk detail tambahan tentang parameter perintah, lihat referensi
action.devices.traits.HumiditySetting.
{
"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
}
}
]
}
}
Aktif
Untuk detail tambahan tentang parameter perintah, lihat referensi
action.devices.traits.OnOff.
{
"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
}
}
]
}
}
Set SuhuSuhu Termostat
Untuk detail tambahan tentang parameter perintah, lihat referensi
action.devices.traits.TemperatureSetting.
{
"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
}
}
]
}
}
ModeTermostat
Untuk detail tambahan tentang parameter perintah, lihat referensi
action.devices.traits.TemperatureSetting.
{
"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
}
}
]
}
}