السمات

تتضمّن السمة في واجهة برمجة التطبيقات SDM حقولاً وأوامر وأحداثًا.

الحقول

الحقول هي قيم ذات أنواع بيانات شائعة، مثل رقم أو سلسلة. على سبيل المثال، قد يحتوي أحد الحقول على الوضع الحالي أو الرطوبة المحيطة بجهاز 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"
    }
  ]
}

أنواع الأجهزة

يجب عدم استخدام sdm.devices.types.device-type الذي تعرضه واجهة برمجة التطبيقات SDM API لاستنتاج وظائف الجهاز الفعلي الذي تم تعيينه إليه. ولا يمكن ضمان بقاء نوع الجهاز ثابتًا لجهاز معيّن مع إضافة المزيد من الميزات إلى واجهة برمجة التطبيقات SDM. بدلاً من ذلك، استخدِم السمات التي تم إرجاعها للجهاز.

parentRelations

يمثّل العنصر parentRelations المورد الرئيسي للمورد الحالي، سواء كان بنية أو غرفة. يتطابق الاسم المعروض مع الحقل customName في Info trait للأجهزة التي لها عنصر رئيسي من النوع "بنية" أو RoomInfo trait للأجهزة التي لها عنصر رئيسي من النوع "غرفة".

الطلبات الصوتية

الطلبات هي طلبات مرتبطة بسمة. على سبيل المثال، تغيير الوضع الحالي أو نقطة ضبط درجة الحرارة في ترموستات Google Nest.

يتم إرسال أمر من خلال طلب بيانات من واجهة برمجة التطبيقات 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 تنتمي هذه السمة إلى أنواع الأجهزة من نوع THERMOSTAT التي تتوافق مع أوضاع ECO.
ThermostatHvac	sdm.devices.traits.ThermostatHvac تنتمي هذه السمة إلى أنواع الأجهزة من نوع THERMOSTAT التي يمكنها إرسال تفاصيل نظام التدفئة والتهوية وتكييف الهواء.
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 تنتمي هذه السمة إلى أي جهاز يتيح استخدام رنين الجرس وأحداث الضغط ذات الصلة.