Özellikler

SDM API'deki bir özellik; alanlar, komutlar ve etkinliklerden oluşur.

Alanlar

Alanlar, sayı veya dize gibi ortak veri türlerine sahip değerlerdir. Örneğin, bir alan, 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'si tarafından döndürülen sdm.devices.types.device-type, atandığı gerçek cihazın işlevselliğini anlamak veya tahmin etmek için kullanılmamalıdır. SDM API'ye daha fazla özellik eklendikçe belirli bir cihaz türünün belirli bir cihaz için sabit kalacağı garanti edilmez. Bunun yerine, cihaz için döndürülen özellikleri kullanın.

parentRelations

parentRelations nesnesi, geçerli kaynağın üst kaynağını (yapı veya oda) temsil eder. Görünen ad, yapı üst öğesi olan cihazlar içinInfo trait 'e ya da oda üst öğesi olan cihazlar içinRoomInfo trait 'e karşılık gelir.

Komutlar

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

Bir komut, executeCommand API çağrısıyla gönderildiğinde:

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 tek tek özellik kılavuzlarına bakın.

Etkinlikler

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

Özellik alanının değerindeki herhangi bir değişiklik için 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 herhangi bir yapıya aittir.
RoomInfo
sdm.structures.traits.RoomInfo
Bu özellik, odalarla ilgili bilgiler için herhangi bir odaya aittir.

Cihaz

Özellikler
Bağlantı
sdm.devices.traits.Connectivity
Bu özellik, bağlantı bilgileri olan tüm cihazlara aittir.
Fan
sdm.devices.traits.Fan
Bu özellik, fanı kontrol etme sistemine sahip tüm cihazlara aittir.
Nem
sdm.devices.traits.Humidity
Bu özellik, nemi ölçmek için 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 herhangi bir cihaza aittir.
Sıcaklık
sdm.devices.traits.Temperature
Bu özellik, sıcaklığı ölçmek için 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, 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ığı ayarlanması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 cihazlarda kullanılabilir.
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 sesi ve ilgili basma etkinliklerini destekleyen tüm cihazlara aittir.