Cechy

trait w SDM API obejmuje pola, polecenia i zdarzenia.

Pola

Pola to wartości z typowymi typami danych, takimi jak liczba czy ciąg znaków. Na przykład pole może zawierać informacje o bieżącym trybie lub wilgotności otoczenia na urządzeniu Google Nest Thermostat.

Cechy i pola można wyświetlać za pomocą wywołania GET do wybranego punktu końcowego interfejsu API:

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"
    }
  ]
}

Typy urządzeń

Wartości sdm.devices.types.device-type zwróconej przez interfejs SDM API nie należy używać do określania działania urządzenia, do którego jest przypisane. Nie możemy zagwarantować, że dany typ urządzenia będzie działać stabilnie na danym urządzeniu, ponieważ do interfejsu SDM API będzie dodawane kolejne funkcje. Zamiast tego użyj zwróconych cech urządzenia.

parentRelations

Obiekt parentRelations reprezentuje zasób nadrzędny bieżącego zasobu, czyli strukturę lub salę. Wyświetlana nazwa odpowiada polu customName w: cechy informacyjnej urządzeń z atrybutem nadrzędnym struktur lubRoomInfo

Polecenia

Polecenia to żądania powiązane z daną cechą. Może to być na przykład zmiana bieżącego trybu lub nastawy temperatury na urządzeniu Google Nest Thermostat.

Polecenie jest wysyłane przez wywołanie interfejsu API executeCommand:

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

Większość odpowiedzi na polecenie oznacza prosty sukces lub błąd. Przykłady użycia poleceń znajdziesz w przewodnikach po poszczególnych cechach.

Wydarzenia

Zdarzenia są asynchroniczne i zarządzane przez Google Cloud Pub/Sub w 1 temacie na każdy identyfikator Project .

Zdarzenia są wysyłane domyślnie w przypadku każdej zmiany wartości pola cechy. Można je też wysyłać w odpowiedzi na określone działania na urządzeniu lub zmiany w przypisaniach zasobów. Więcej informacji znajdziesz w sekcji Zdarzenia.

Kategorie cech

Struktura

Cechy
Informacje	sdm.structures.traits.Info Ta cecha należy do każdej struktury zawierającej informacje związane z danym miejscem.
RoomInfo	sdm.structures.traits.RoomInfo Ta cecha należy do każdego pokoju, w którym można znaleźć informacje dotyczące pokoju.

Urządzenie

Cechy
Łączność	sdm.devices.traits.Connectivity Ta cecha należy do każdego urządzenia, które ma informacje o połączeniach.
Fan	sdm.devices.traits.Fan Ta cecha należy do każdego urządzenia, które ma możliwość sterowania wentylatorem.
Wilgotność	sdm.devices.traits.Humidity Ta cecha należy do każdego urządzenia z czujnikiem do pomiaru wilgotności.
Informacje	sdm.devices.traits.Info Ta cecha należy do każdego urządzenia, aby uzyskać informacje związane z tym urządzeniem.
Ustawienia	sdm.devices.traits.Settings Ta cecha jest powiązana z informacjami o ustawieniach każdego urządzenia.
Temperatura	sdm.devices.traits.Temperature Ta cecha należy do każdego urządzenia z czujnikiem do pomiaru temperatury.

Termostat

Cechy
ThermostatEco	sdm.devices.traits.ThermostatEco Ta cecha należy do typów urządzeń TERMOSTATU, które obsługują tryby ECO.
ThermostatHvac	sdm.devices.traits.ThermostatHvac Ta cecha należy do typów urządzeń TERMOSTATU, które mogą raportować szczegóły dotyczące ogrzewania/wentylacji/klimatyzacji.
ThermostatMode	sdm.devices.traits.ThermostatMode Ta cecha należy do typów urządzeń TERMOSTATU, które obsługują różne tryby termostatu.
ThermostatTemperatureSetpoint	sdm.devices.traits.ThermostatTemperatureSetpoint Ta cecha należy do typów urządzeń TERMOSTATU, które obsługują ustawianie docelowej temperatury i zakresu temperatur.

Aparat

Cechy
CameraClipPreview	sdm.devices.traits.CameraClipPreview Ta cecha jest przypisana do każdego urządzenia, które obsługuje pobieranie podglądu klipów.
CameraEventImage	sdm.devices.traits.CameraEventImage Ta cecha należy do każdego urządzenia, które obsługuje generowanie obrazów na podstawie zdarzeń.
CameraImage	sdm.devices.traits.CameraImage Ta cecha należy do każdego urządzenia, które pozwala robić zdjęcia.
CameraLiveStream	sdm.devices.traits.CameraLiveStream Ta cecha należy do każdego urządzenia, które obsługuje transmisję na żywo.
CameraMotion	sdm.devices.traits.CameraMotion Ta cecha jest przypisana do każdego urządzenia, które obsługuje zdarzenia wykrywania ruchu.
CameraPerson	sdm.devices.traits.CameraPerson Ta cecha jest przypisana do każdego urządzenia, które obsługuje zdarzenia wykrywania osób.
CameraSound	sdm.devices.traits.CameraSound Ta cecha jest przypisana do każdego urządzenia, które obsługuje zdarzenia wykrywania dźwięku.

Dzwonek

Cechy
DoorbellChime	sdm.devices.traits.DoorbellChime Ta cecha należy do każdego urządzenia, które obsługuje gong dzwonka i powiązane z nim wydarzenia prasowe.