Akıllı Ev Panjur Kılavuzu
action.devices.types.BLINDS
- Panjurlar açılıp kapanabilir, jaluzi (bir yönde açılır), panel veya dikey (sola veya sağa açılabilir) ve yukarıdan aşağıya aşağıdan yukarıya (yukarı veya aşağı açılabilir) gibi çeşitli panjurlar desteklenir. Bazı panjurların döndürülebilen panelleri olabilir.
Bu tür, cihazın panjur simgesinin yanı sıra bazı eş anlamlı kelimeleri ve 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.
Önerilen özellikler
Cihazınız için geçerliyse bu özellikler önerilir. Bununla birlikte, mevcut ürün işlevselliğinize en iyi şekilde uyması için mevcut tüm özellikleri bir arada kullanabilirsiniz.
Kalite gereksinimleri
- Gecikme: En fazla 2500 ms olmalıdır.
- Güvenilirlik: En az %97 olmalıdır.
Örnek cihaz: Sade panjur
Bu bölümde, cihaz türüne ve yukarıdaki özelliklere göre yaygın olarak kullanılan bir "Panjur"u 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.
Yukarıdan aşağıya aşağıdan yukarıya bir jaluzide, UP
yönü jalunun alt kısmını kaldırırken DOWN
yönü jalunun üst kısmını düşürür. Şekil 1'de, UP
yönü jalunun alt kısmını yüzde 50 yükselttiği ve DOWN
yönünün panjurun üst kısmını yüzde 30 düşürdüğü bir yukarıdan aşağıya aşağıdan yukarıya bir panjur örneği gösterilmektedir.
Örnek Senkronizasyon yanıtı
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.BLINDS", "traits": [ "action.devices.traits.OpenClose" ], "name": { "name": "Simple blinds" }, "willReportState": true, "attributes": { "openDirection": [ "UP", "DOWN" ] }, "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, "openState": [ { "openPercent": 30, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] } } } }
Ö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": 10, "openDirection": "DOWN" } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "openState": [ { "openPercent": 10, "openDirection": "DOWN" }, { "openPercent": 50, "openDirection": "UP" } ] } } ] } }