Özellikler

SDM API'sindeki özellik, alanlar, komutlar ve etkinlikler içerir.

Alanlar

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

Özellikler ve alanlar, istenen API uç noktasına GET çağrısı yapılarak 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, atandığı gerçek cihazın işlevini anlamak veya tahmin etmek için kullanılmamalıdır. SDM API'sine daha fazla özellik eklendikçe bir cihaz türünün belirli bir cihazda kararlı kalacağı garanti edilmez. Bunun yerine, cihaz için döndürülen özellikleri kullanın.

parentRelations

parentRelations nesnesi, geçerli kaynağın (yapı veya oda) üst kaynağını temsil eder. Görünen ad, yapı üst öğesine sahip cihazlar içinInfo özelliğinin alanına veya oda üst öğesine sahip cihazlar içinRoomInfo özelliğinin alanına karşılık gelir.

Komutlar

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

executeCommand API çağrısıyla bir komut gönderilir:

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

Bir komuta verilen yanıtların çoğu basit bir başarı veya başarısızlıktır. Belirli komut kullanım örnekleri için ilgili özellik kılavuzlarına bakın.

Etkinlikler

Etkinlikler eşzamansız olup Google Cloud Pub/Sub tarafından Project kimliği başına tek bir konuda yönetilir.

Bir özellik alanının değerinde herhangi bir değişiklik yapıldığında varsayılan olarak etkinlikler gönderilir. Ayrıca, belirli cihaz işlemlerine veya kaynak atamalarındaki değişikliklere yanıt olarak da gönderilebilirler. Daha fazla bilgi için Etkinlikler başlıklı makaleyi inceleyin.

Özellik kategorileri

Yapı

Özellikler
Bilgi
sdm.structures.traits.Info
Bu özellik, yapıyla ilgili bilgiler için tüm yapılara aittir.
RoomInfo
sdm.structures.traits.RoomInfo
Bu özellik, odalarla ilgili bilgiler için tüm odalara aittir.

Cihaz

Özellikler
Bağlantı
sdm.devices.traits.Connectivity
Bu özellik, bağlantı bilgileri olan tüm cihazlara aittir.
Takipçi
sdm.devices.traits.Fan
Bu özellik, fanı kontrol etme sistemi olan tüm cihazlara aittir.
Nem
sdm.devices.traits.Humidity
Bu özellik, nemi ölçen bir sensörü olan 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 tüm cihazlara aittir.
Sıcaklık
sdm.devices.traits.Temperature
Bu özellik, sıcaklık ölçen sensörü olan tüm cihazlara aittir.

Termostat

Özellikler
ThermostatEco
sdm.devices.traits.ThermostatEco
Bu özellik, ECO modlarını destekleyen TERMOSTAT cihaz türlerine aittir.
ThermostatHvac
sdm.devices.traits.ThermostatHvac
Bu özellik, Isıtma, Havalandırma ve Soğutma (HVAC) ayrıntılarını bildirebilen TERMOSTAT cihaz türlerine aittir.
ThermostatMode
sdm.devices.traits.ThermostatMode
Bu özellik, farklı termostat modlarını destekleyen TERMOSTAT cihaz türlerine aittir.
ThermostatTemperatureSetpoint
sdm.devices.traits.ThermostatTemperatureSetpoint
Bu özellik, hedef sıcaklık ve sıcaklık aralığı ayarını destekleyen TERMOSTAT 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.
KameraKullanıcısı
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 çalmasını ve ilgili basma etkinliklerini destekleyen tüm cihazlara aittir.