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: "action.devices.QUERY")

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:

SUCCESS
Sorgunun başarılı olduğunu onaylayın.
OFFLINE
Hedef cihaz çevrimdışı durumda veya erişilemez.
EXCEPTIONS
Bir sorguyla ilişkili bir sorun veya uyarı vardır. Sorgu başarılı veya başarısız olabilir. Bu durum türü, genellikle bağlı başka bir cihaz hakkında ek bilgi göndermek istediğinizde ayarlanır.
ERROR
Hedef cihaz sorgulanamadı.
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
        }
      }
    }
  }
}