विशेषताएं

SDM API में मौजूद ट्रेट में फ़ील्ड, कमांड, और इवेंट शामिल होते हैं.

फ़ील्ड

फ़ील्ड, सामान्य डेटा टाइप वाली वैल्यू होती हैं. जैसे, कोई संख्या या स्ट्रिंग. उदाहरण के लिए, किसी फ़ील्ड में Google Nest Thermostat का मौजूदा मोड या कमरे में मौजूद नमी की जानकारी हो सकती है.

GET कॉल करके, किसी भी एपीआई एंडपॉइंट के लिए, एट्रिब्यूट और फ़ील्ड देखे जा सकते हैं:

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

Device types

एसडीएम एपीआई से मिले sdm.devices.types.device-type का इस्तेमाल, उस डिवाइस के काम करने के तरीके का पता लगाने के लिए नहीं किया जाना चाहिए जिसे यह असाइन किया गया है. इस बात की कोई गारंटी नहीं है कि किसी डिवाइस के लिए डिवाइस टाइप स्थिर रहेगा, क्योंकि SDM API में ज़्यादा सुविधाएं जोड़ी जाती हैं. इसके बजाय, डिवाइस के लिए दिखाए गए ट्रेट का इस्तेमाल करें.

parentRelations

parentRelations ऑब्जेक्ट, मौजूदा संसाधन के पैरंट संसाधन को दिखाता है. यह स्ट्रक्चर या कमरा हो सकता है. डिसप्ले नेम, स्ट्रक्चर पैरंट वाले डिवाइसों के लिएInfo trait या रूम पैरंट वाले डिवाइसों के लिएRoomInfo trait से मेल खाता है.

निर्देश

कमांड, किसी ट्रेट से जुड़े अनुरोध होते हैं. उदाहरण के लिए, Google Nest Thermostat का मौजूदा मोड या तापमान सेटपॉइंट बदलना.

executeCommand एपीआई कॉल से एक कमांड भेजी जाती है:

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

किसी निर्देश के जवाब में, ज़्यादातर मामलों में यह बताया जाता है कि निर्देश पूरा हुआ या नहीं. कमांड के इस्तेमाल के उदाहरणों के लिए, अलग-अलग ट्रेट की गाइड देखें.

इवेंट

इवेंट एसिंक्रोनस होते हैं. इन्हें Google Cloud Pub/Sub मैनेज करता है. हर Project आईडी के लिए एक विषय होता है.

किसी भी ट्रेट फ़ील्ड की वैल्यू में बदलाव होने पर, इवेंट डिफ़ॉल्ट रूप से भेजे जाते हैं. इन्हें डिवाइस से जुड़ी खास कार्रवाइयों या संसाधन असाइनमेंट में हुए बदलावों के जवाब में भी भेजा जा सकता है. ज़्यादा जानकारी के लिए, इवेंट देखें.

ट्रेट कैटगरी

बनावट

विशेषताएं
जानकारी
sdm.structures.traits.Info
यह ट्रेट, स्ट्रक्चर से जुड़ी जानकारी के लिए किसी भी स्ट्रक्चर से जुड़ी होती है.
RoomInfo
sdm.structures.traits.RoomInfo
यह लक्षण, कमरे से जुड़ी जानकारी के लिए किसी भी कमरे से जुड़ा होता है.

डिवाइस

विशेषताएं
कनेक्टिविटी
sdm.devices.traits.Connectivity
यह ट्रेट, कनेक्टिविटी की जानकारी देने वाले किसी भी डिवाइस से जुड़ी होती है.
Fan
sdm.devices.traits.Fan
यह ट्रेट, ऐसे किसी भी डिवाइस से जुड़ी होती है जिसमें पंखे को कंट्रोल करने की सुविधा होती है.
नमी
sdm.devices.traits.Humidity
यह ट्रेट, ऐसे डिवाइस से जुड़ी होती है जिसमें नमी को मेज़र करने के लिए सेंसर होता है.
जानकारी
sdm.devices.traits.Info
यह ट्रेट, डिवाइस से जुड़ी जानकारी के लिए किसी भी डिवाइस से जुड़ी होती है.
सेटिंग
sdm.devices.traits.Settings
यह ट्रेट, डिवाइस से जुड़ी सेटिंग की जानकारी के लिए किसी भी डिवाइस से जुड़ी होती है.
तापमान
sdm.devices.traits.Temperature
यह विशेषता, तापमान मापने के लिए सेंसर वाले किसी भी डिवाइस की होती है.

थर्मोस्टैट

विशेषताएं
ThermostatEco
sdm.devices.traits.ThermostatEco
यह ट्रेट, थर्मोस्टैट के उन डिवाइस टाइप से जुड़ी है जिनमें ईको मोड की सुविधा काम करती है.
ThermostatHvac
sdm.devices.traits.ThermostatHvac
यह ट्रेट, थर्मोस्टैट डिवाइस टाइप से जुड़ी है. यह एचवीएसी की जानकारी दे सकती है.
ThermostatMode
sdm.devices.traits.ThermostatMode
यह डिवाइस की THERMOSTAT टाइप की उन सुविधाओं से जुड़ी होती है जो थर्मोस्टैट के अलग-अलग मोड के साथ काम करती हैं.
ThermostatTemperatureSetpoint
sdm.devices.traits.ThermostatTemperatureSetpoint
यह विशेषता, THERMOSTAT डिवाइस टाइप की है. यह टारगेट तापमान और तापमान की सीमा सेट करने की सुविधा देती है.

कैमरा

विशेषताएं
CameraClipPreview
sdm.devices.traits.CameraClipPreview
यह ट्रेट, उस डिवाइस से जुड़ी होती है जिस पर क्लिप के प्रीव्यू को डाउनलोड किया जा सकता है.
CameraEventImage
sdm.devices.traits.CameraEventImage
यह ट्रेट, ऐसे किसी भी डिवाइस से जुड़ी होती है जो इवेंट से इमेज जनरेट करने की सुविधा देता है.
CameraImage
sdm.devices.traits.CameraImage
यह ट्रेट, इमेज कैप्चर करने की सुविधा वाले किसी भी डिवाइस के लिए उपलब्ध है.
CameraLiveStream
sdm.devices.traits.CameraLiveStream
यह ट्रेट, लाइव स्ट्रीमिंग की सुविधा वाले किसी भी डिवाइस के लिए उपलब्ध है.
CameraMotion
sdm.devices.traits.CameraMotion
यह ट्रेट, मोशन डिटेक्शन इवेंट की सुविधा वाले किसी भी डिवाइस से जुड़ी होती है.
CameraPerson
sdm.devices.traits.CameraPerson
यह ट्रेट, ऐसे डिवाइस से जुड़ी होती है जो लोगों का पता लगाने की सुविधा वाले इवेंट को सपोर्ट करता है.
CameraSound
sdm.devices.traits.CameraSound
यह ट्रेट, ऐसे किसी भी डिवाइस से जुड़ी होती है जिस पर आवाज़ का पता लगाने की सुविधा काम करती है.

दरवाज़े की घंटी

विशेषताएं
DoorbellChime
sdm.devices.traits.DoorbellChime
यह ट्रेट, ऐसे किसी भी डिवाइस से जुड़ी होती है जिस पर डोरबेल की आवाज़ सुनाई देती है और उससे जुड़े प्रेस इवेंट होते हैं.