Akıllı Ev Hava Temizleyici Kılavuzu
action.devices.types.AIRPURIFIER - Hava filtresi, açık ve kapalı olan, hava filtresinin temizlik durumunu ve hava filtresi ömrünü raporlayabilen ve çeşitli mod ayarlarına uygulanabilen cihazlardır.
Bu tür, cihazın Hava temizleyici simgesini, ilgili bazı 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. Cihazınız bu özellikleri desteklemiyorsa QUERY veya EXECUTE yanıtına functionNotSupported hata kodunu girin. Daha fazla bilgi için Hatalar ve istisnalar bölümüne bakın.
Önerilen özellikler
Cihazınız için geçerliyse bu özellikler önerilir. Bununla birlikte, mevcut ürün işlevlerinizle en iyi şekilde eşleşmesi için mevcut tüm özelliklerle karıştırıp eşleştirebilirsiniz.
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 filtresi
Bu bölümde, cihaz türüne ve yukarıdaki özelliklere göre ortak bir "Hava filtresi"ni temsil eden örnek intent 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.AIRPURIFIER",
"traits": [
"action.devices.traits.FanSpeed",
"action.devices.traits.SensorState",
"action.devices.traits.OnOff"
],
"name": {
"name": "Simple air purifier"
},
"willReportState": true,
"attributes": {
"availableFanSpeeds": {
"speeds": [
{
"speed_name": "low_key",
"speed_values": [
{
"speed_synonym": [
"Low",
"Slow"
],
"lang": "en"
},
{
"speed_synonym": [
"Low",
"Slow"
],
"lang": "de"
}
]
},
{
"speed_name": "high_key",
"speed_values": [
{
"speed_synonym": [
"High"
],
"lang": "en"
},
{
"speed_synonym": [
"High"
],
"lang": "de"
}
]
}
],
"ordered": true
},
"sensorStatesSupported": [
{
"name": "FilterCleanliness",
"descriptiveCapabilities": {
"availableStates": [
"clean",
"dirty",
"needs replacement"
]
}
}
]
},
"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",
"currentSensorStateData": [
{
"name": "FilterCleanliness",
"currentSensorState": "clean"
}
]
}
}
}
}
Ö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": "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"
}
}
]
}
}
Kapalı
Komut parametreleri hakkında ek ayrıntılar için
action.devices.traits.OnOff referansına bakın.
{
"requestId": "6894439706274654518",
"inputs": [
{
"intent": "action.devices.EXECUTE",
"payload": {
"commands": [
{
"devices": [
{
"id": "123"
}
],
"execution": [
{
"command": "action.devices.commands.OnOff",
"params": {
"on": true
}
}
]
}
]
}
}
]
}
{
"requestId": "6894439706274654518",
"payload": {
"commands": [
{
"ids": [
"123"
],
"status": "SUCCESS",
"states": {
"online": true,
"on": true
}
}
]
}
}