Akıllı Ev Doldurma Özelliği Şeması
action.devices.traits.Fill
: Bu özellik, küvet gibi doldurulabilen cihazlar için geçerlidir.
CİHAZ ÖZELLİKLERİ
Bu özelliğe sahip cihazlar, SYNC
işleminin bir parçası olarak aşağıdaki özellikleri bildirebilir. SYNC
amaçlarının ele alınması hakkında daha fazla bilgi edinmek için Niyet karşılama bölümüne bakın.
Özellikler | Tür | Açıklama |
---|---|---|
availableFillLevels |
Nesne |
Cihazı farklı seviyelerde doldurmayı açıklar. |
levels |
Dizi |
Zorunludur. Seviye adlarının ve dile özgü eş anlamlı kelimelerin listesi. |
[item, ...] |
Nesne |
Seviye adı ve dile özgü eş anlamlı kelimeleri. |
level_name |
String |
Zorunludur. Seviyenin dahili adı. Bu, kullanıcı dostu olmayabilir ve tüm dillerde paylaşılır. |
level_values |
Dizi |
Zorunludur. Desteklenen her dilde seviyenin eş anlamlıları. |
[item, ...] |
Nesne |
Belirli bir dilde seviyenin eş anlamlıları. |
level_synonym |
Dizi |
Zorunludur. Seviyenin eş anlamlısıdır. Bu listedeki ilk dize, ilgili dilde seviyenin standart adı olarak kullanılır. |
[item, ...] |
String |
Eş anlamlı kelime adı. |
lang |
String |
Zorunludur. Dil kodu (ISO 639-1). Desteklenen dillere bakın. |
ordered |
Boole |
Zorunludur. True (doğru) ise cihaz, |
supportsFillPercent |
Boole |
(Varsayılan: Doğru ise seviyeyi yüzde olarak ayarlama komutlarını kabul eder. |
Örnekler
Bağımsız dolum seviyelerini desteklemeyen temel dolum veya boşaltma özelliklerine sahip cihaz.
{}
Ayrı dolgu düzeylerini destekleyen cihaz.
{ "availableFillLevels": { "levels": [ { "level_name": "half_level", "level_values": [ { "level_synonym": [ "Half", "Half way", "One half" ], "lang": "en" } ] }, { "level_name": "full_level", "level_values": [ { "level_synonym": [ "Full", "All the way", "Complete" ], "lang": "en" } ] } ], "ordered": true } }
Cihaz STATES
Bu özelliğe sahip öğeler, QUERY
işlemi kapsamında aşağıdaki durumları bildirebilir. QUERY
intent'lerini ele alma hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.
Eyaletler | Tür | Açıklama |
---|---|---|
isFilled |
Boole |
Zorunludur. Cihaz herhangi bir seviyede doldurulursa doğru değerini döndürür. Cihaz tamamen boşsa yanlış değerini döndürür. |
currentFillLevel |
String |
|
currentFillPercent |
Number |
|
Örnekler
Küvet dolu mu?
{ "isFilled": true }
Küvet dolu mu? (seviyelerle).
{ "isFilled": true, "currentFillLevel": "half_level" }
Cihaz KOMUTLARI
Bu özelliğe sahip cihazlar, EXECUTE
işlemi kapsamında aşağıdaki komutlara yanıt verebilir. EXECUTE
intent'lerini ele alma hakkında daha fazla bilgi edinmek için Intent karşılama başlıklı makaleyi inceleyin.
action.devices.commands.Fill
Cihazı doldurun veya boşaltın.
Parametreler
Parametreler | Tür | Açıklama |
---|---|---|
fill |
Boole |
Zorunludur. Doldurmak için doğru, boşaltmak için yanlış değerini girin. |
fillLevel |
String |
|
fillPercent |
Number |
İstenen seviye yüzdesini belirtir. |
Örnekler
Küveti doldurun.
{ "command": "action.devices.commands.Fill", "params": { "fill": true } }
Küveti boşaltın.
{ "command": "action.devices.commands.Fill", "params": { "fill": false } }
Küveti yarısına kadar doldurun.
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "half_level" } }
Küvetin doldurma seviyesini bir artırın (ordered
özelliğinin true
olması gerekir).
{ "command": "action.devices.commands.Fill", "params": { "fill": true, "fillLevel": "full_level" } }