Akıllı ev işlemlerinin nasıl geliştirileceğini öğrenebileceğiniz yeni adres olan Google Home Geliştirici Merkezi'ne hoş geldiniz. Not: Actions Console'da işlem derlemeye devam edersiniz.

Akıllı Ev Panjur Kılavuzu

action.devices.types.BLINDS - Panjurlar açılıp kapatılabilir. Panjur türleri (tek yönde açılır), panel veya dikey (sol ya da sağ açılabilir) ve aşağıdan yukarıya (yukarı veya aşağı açılabilir) gibi çeşitli panjur türleri desteklenir. Bazı panjurlarda döndürülebilen çıkıntılar olabilir.

Bu tür, cihazın Panjur simgesini ve ilgili bazı eş anlamlıları ve takma adları aldığını gösterir.

Cihaz özellikleri

Hizmetinizin desteklemesi gereken özellikler ve durumlar, EXECUTE ve QUERY yanıtlarının nasıl oluşturulacağı gibi uygulama ayrıntıları için ilgili özellik dokümanlarına bakın.

Gerekli özellikler

Cihazınız için geçerliyse bu özellikler ve komutlar gerekir.

Cihazınız için geçerliyse bu özellikler önerilir. Bununla birlikte, mevcut ürün işlevlerinizle en iyi şekilde eşleşmesi için mevcut tüm özelliklerle karıştırıp eşleştirebilirsiniz.

Kalite gereksinimleri

  • Gecikme: 2.500 ms.den az veya buna eşit olmalıdır.
  • Güvenilirlik: %97'den fazla veya bu değere eşit olmalıdır.

Örnek cihaz: Basit panjur

Bu bölümde, cihaz türüne ve yukarıdaki özelliklere göre ortak bir "panjur" temsil edilen örnek intent yükleri yer alır. Uygulamanıza özellik ekler veya mevcut özellikleri kaldırırsanız bu değişiklikleri yansıtacak şekilde yanıtlarınızı uygun şekilde değiştirin.

Üstten alta doğru uzanan panjurda UP yön, panjurun alt kısmını yükseltirken DOWN yön, panjurun üst kısmını düşürür. 1. Şekil'de, UP yönünün panjurun alt kısmını %50, DOWN yönünün de üst kısmı %30 oranında azalttığı yukarıdan aşağıya doğru bir panjur örneği gösterilmektedir.

Şekil 1. Üstten alta panjur

Örnek SYNC yanıtı

İstek
{
  "requestId": "6894439706274654512",
  "inputs": [
    {
      "intent": "action.devices.SYNC"
    }
  ]
}
Yanıt
{
  "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ı

İstek
{
  "requestId": "6894439706274654514",
  "inputs": [
    {
      "intent": "action.devices.QUERY",
      "payload": {
        "devices": [
          {
            "id": "123"
          }
        ]
      }
    }
  ]
}
Yanıt
{
  "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 ek ayrıntılar için action.devices.traits.OpenClose referansına bakın.

İstek
{
  "requestId": "6894439706274654516",
  "inputs": [
    {
      "intent": "action.devices.EXECUTE",
      "payload": {
        "commands": [
          {
            "devices": [
              {
                "id": "123"
              }
            ],
            "execution": [
              {
                "command": "action.devices.commands.OpenClose",
                "params": {
                  "openPercent": 10,
                  "openDirection": "DOWN"
                }
              }
            ]
          }
        ]
      }
    }
  ]
}
Yanıt
{
  "requestId": "6894439706274654516",
  "payload": {
    "commands": [
      {
        "ids": [
          "123"
        ],
        "status": "SUCCESS",
        "states": {
          "online": true,
          "openState": [
            {
              "openPercent": 10,
              "openDirection": "DOWN"
            },
            {
              "openPercent": 50,
              "openDirection": "UP"
            }
          ]
        }
      }
    ]
  }
}

Cihaz HATALARI

Hataların ve istisnaların tam listesini inceleyin.