action.cihazlar.QUERY
Bu niyet, cihaz online ve erişilebilir olup olmadığı da dahil olmak üzere mevcut cihaz durumunuzu karşılamanızı sağlar.
QUERY
yanıtınız yalnızca durum bilgilerini döndürmelidir.
Özelliklerin ve özelliklerin güncellenmesi SYNC
yanıtı tarafından gerçekleştirilir.
Daha fazla bilgi için Sorgu ve yürütme bölümünü inceleyin.
İstek biçimi
Alanlar | Tür | Açıklama |
---|---|---|
requestId |
Dize |
Zorunludur. İsteğin kimliği. |
inputs |
Dizi |
Zorunludur. Amaç isteğiyle eşleşen girişlerin listesi. |
[item, ...] |
Nesne |
Amaç isteğiyle ilişkili tür ve yük. |
intent |
Zorunludur. (Sabit değer: Amaç istek türü. |
|
payload |
Nesne |
Zorunludur. QUERY isteği yükü. |
devices |
Dizi |
Zorunludur. Hedef cihazların listesi. |
[item, ...] |
Nesne |
Sorgulanacak cihaz hedefleri. |
id |
Dize |
Zorunludur. SYNC'te sağlanan kimliğe göre cihaz kimliği. |
customData |
Nesne |
Opak customData nesnesi SYNC'de sağlanmışsa buraya gönderilir. |
Örnekler
QUERY intent isteği
{ "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123", "customData": { "fooValue": 74, "barValue": true, "bazValue": "foo" } }, { "id": "456", "customData": { "fooValue": 12, "barValue": false, "bazValue": "bar" } } ] } } ] }
Yanıt biçimi
Alanlar | Tür | Açıklama |
---|---|---|
requestId |
Dize |
Zorunludur. İlgili isteğin kimliği. |
payload |
Nesne |
Zorunludur. Intent yanıt yükü. |
errorCode |
Dize |
Kimlik doğrulama hataları ve geliştirici sisteminin kullanılamaması ile ilgili işlemin tamamı için hata kodu. Bağımsız cihaz hataları için cihaz nesnesindeki errorCode'u kullanın. |
debugString |
Dize |
Kullanıcılara hiçbir zaman sunulmayacak, ancak geliştirme sırasında günlüğe kaydedilebilecek veya kullanılabilecek ayrıntılı hata. |
devices |
Nesne |
Zorunludur. Cihaz haritası. Geliştirici cihaz kimliğini durum mülklerinin nesnesiyle eşler. |
<string> |
Nesne |
Cihaz durumu. |
online |
Boole |
Zorunludur. Cihazın online (yani erişilebilir) olup olmadığını belirtir. |
status |
Dize |
Zorunludur. Sorgu işleminin sonucu. Desteklenen değerler:
|
errorCode |
Dize |
Gerektiğinde, kullanıcılara sunulan hataları eşleyecek hazır hata hata kodlarından kaynaklanan ERROR durumu genişletiliyor. |
Örnekler
QUERY intent yanıtı
{ "requestId": "ff36a3cc-ec34-11e6-b1a0-64510650abcf", "payload": { "devices": { "123": { "on": true, "online": true, "status": "SUCCESS" }, "456": { "on": true, "online": true, "status": "SUCCESS", "brightness": 80, "color": { "spectrumRgb": 16711935 } } } } }