Özellikler

SDM API'sindeki bir özellik, alanlardan, komutlardan ve etkinliklerden oluşur.

.

Alanlar

Alanlar, sayı veya dize gibi yaygın veri türlerine sahip değerlerdir. Örneğin, bir Google Nest Thermostat\'ın mevcut modunu veya ortam nemini içerebilir.

Özellikler ve alanlar, istenen API uç noktasına yapılan bir GET çağrısıyla görüntülenebilir:

GET /enterprises/project-id/devices/device-id
{
  "name" : "enterprises/project-id/devices/device-id",
  "type" : "sdm.devices.types.device-type",
  "traits" : { ... },
  "parentRelations" : [
    {
      "parent" : "enterprises/project-id/structures/structure-id/rooms/room-id",
      "displayName" : "Lobby"
    }
  ]
}

Cihaz türleri

SDM API tarafından döndürülen sdm.devices.types.device-type kullanılmamalıdır çalıştığı asıl cihazın işlevselliğini anlamak veya tahmin etmek için kullanılır. Garanti verilmez SDM'ye daha fazla özellik eklendikçe bir cihaz türünün belirli bir cihaz için sabit kalacağını ifade eder API'ye gidin. Bunun yerine, cihaz için döndürülen özellikleri kullanın.

parentRelations

parentRelations nesnesi, geçerli kaynağın üst kaynağını temsil eder. yapı ya da oda olur. Görünen ad,customName Bilgi özelliği yapısına sahip olan cihazlar için RoomInfo özelliği oda ebeveyni olarak düşünebilirsiniz.

Komutlar

Komutlar, bir özellikle ilişkili isteklerdir. Örneğin, mevcut modu değiştirmek veya Google Nest Thermostat\'ta istenen sıcaklık.

executeCommand API çağrısı tarafından komut gönderilir:

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "command-name",
  "params" : {
    "field" : "value"
  }
}

Bir komuta verilen çoğu yanıt basit başarılı veya başarısız olur. Özellik rehberlerini inceleyin: komut kullanım örneklerine göz atın.

Etkinlikler

Etkinlikler eşzamansız olup Google Cloud Pub/Sub tarafından her kullanıcı için tek bir konuda yönetilir Project Kimlik.

Bir özellik alanının değerinde herhangi bir değişiklik yapıldığında varsayılan olarak etkinlikler gönderilir. Ayrıca, veya kaynak atamalarındaki değişikliklere yanıt verme becerisidir. Görüntüleyin Etkinlikler konulu videomuzu izleyin.

Özellik kategorileri

Yapı

Özellikler
Bilgi
sdm.structures.traits.Info
Bu özellik, yapıyla ilgili bilgiler için herhangi bir yapıya aittir.
RoomInfo
sdm.structures.traits.RoomInfo
Bu özellik, odayla ilgili bilgiler için herhangi bir odaya aittir.

Cihaz

Özellikler
Bağlantı
sdm.devices.traits.Connectivity
Bu özellik, bağlantı bilgilerine sahip tüm cihazlara aittir.
Takipçi
sdm.devices.traits.Fan
Bu özellik, fanı kontrol edebilen sisteme sahip tüm cihazlara aittir.
Nem
sdm.devices.traits.Humidity
Bu özellik, nemi ölçen sensöre sahip tüm cihazlara aittir.
Bilgi
sdm.devices.traits.Info
Bu özellik, cihazla ilgili bilgiler için herhangi bir cihaza aittir.
Ayarlar
sdm.devices.traits.Settings
Bu özellik, cihazla ilgili ayar bilgileri için herhangi bir cihaza aittir.
Sıcaklık
sdm.devices.traits.Temperature
Bu özellik, sıcaklığı ölçen sensöre sahip tüm cihazlara aittir.

Termostat

Özellikler
ThermostatEco
sdm.devices.traits.ThermostatEco
Bu özellik, ECO modlarını destekleyen TERÖZET cihaz türlerine aittir.
ThermostatHvac
sdm.devices.traits.ThermostatHvac
Bu özellik, ısıtma, havalandırma ve soğutma ayrıntılarını raporlayabilen TERgiriş sistemlerine aittir.
ThermostatMode
sdm.devices.traits.ThermostatMode
Bu özellik, farklı termostat modlarını destekleyen TERÖZET cihaz türlerine aittir.
ThermostatTemperatureSetpoint
sdm.devices.traits.ThermostatTemperatureSetpoint
Bu özellik, hedef sıcaklık ve sıcaklık aralığının ayarlanmasını destekleyen TERARAlet cihaz türlerine aittir.

Kamera

Özellikler
CameraClipPreview
sdm.devices.traits.CameraClipPreview
Bu özellik, klip önizlemesinin indirilmesini destekleyen tüm cihazlara aittir.
CameraEventImage
sdm.devices.traits.CameraEventImage
Bu özellik, etkinliklerden resim oluşturmayı destekleyen tüm cihazlara aittir.
CameraImage
sdm.devices.traits.CameraImage
Bu özellik, resim çekmeyi destekleyen tüm cihazlara aittir.
CameraLiveStream
sdm.devices.traits.CameraLiveStream
Bu özellik, canlı yayını destekleyen tüm cihazlara aittir.
CameraMotion
sdm.devices.traits.CameraMotion
Bu özellik, hareket algılama etkinliklerini destekleyen tüm cihazlara aittir.
CameraPerson
sdm.devices.traits.CameraPerson
Bu özellik, kişi algılama etkinliklerini destekleyen tüm cihazlara aittir.
CameraSound
sdm.devices.traits.CameraSound
Bu özellik, ses algılama etkinliklerini destekleyen tüm cihazlara aittir.

Kapı zili

Özellikler
DoorbellChime
sdm.devices.traits.DoorbellChime
Bu özellik, kapı zili zilini ve ilgili basın etkinliklerini destekleyen tüm cihazlara aittir.