Akıllı Ev Çekmece Kılavuzu
action.devices.types.DRAWER
- Çekmeceler birden fazla yönde açılıp kapatılabilir.
Bu tür, cihazın Çekmece simgesi ve ilgili bazı eş anlamlılar ile takma adları aldığını belirtir.
Cihaz özellikleri
Hizmetinizin desteklemesi gereken özellikler ve durumlar ile EXECUTE ve QUERY yanıtlarının nasıl oluşturulacağı gibi uygulama ayrıntıları için ilgili özellik belgelerine bakın.
Gerekli özellikler
Bu özellikler ve komutlar, cihazınız için geçerliyse gereklidir. Cihazınız bu özellikleri desteklemiyorsa bir QUERY veya EXECUTE yanıtına functionNotSupported
hata kodunu girin. Daha fazla bilgi için Hatalar ve istisnalar bölümüne bakın.
Kalite gereksinimleri
- Gecikme: En fazla 2500 ms olmalıdır.
- Güvenilirlik: En az %97 olmalıdır.
Örnek cihaz: Basit çekmece
Bu bölümde, cihaz türüne ve yukarıdaki özelliklere göre ortak bir "Çekmece"yi temsil eden örnek amaç yükleri yer alır. Uygulamanızda özellik ekler veya kaldırırsanız yanıtlarınızı bu değişiklikleri yansıtacak şekilde değiştirin.
Örnek Senkronizasyon yanıtı
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.DRAWER", "traits": [ "action.devices.traits.OpenClose" ], "name": { "name": "Simple drawer" }, "willReportState": true, "attributes": { "discreteOnlyOpenClose": true }, "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, "openPercent": 100 } } } }
Örnek EXECUTE komutları
OpenClose
Komut parametreleri hakkında daha ayrıntılı bilgi için
action.devices.traits.OpenClose
referansına bakın.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.OpenClose", "params": { "openPercent": 0 } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "openPercent": 0 } } ] } }