السمات

تتكوّن السمة في واجهة برمجة تطبيقات 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 لاستنتاج أو استنتاج وظيفة الجهاز الفعلي الذي تم تخصيصه له. وما من ضمانة بأنّ نوع الجهاز سيظل ثابتًا على جهاز معيّن، إذ تتم إضافة المزيد من الميزات إلى واجهة برمجة تطبيقات SDM. بدلاً من ذلك، استخدِم السمات المعروضة للجهاز.

parentRelations

يمثل الكائن parentRelations المورد الرئيسي للمورد الحالي، سواء بنية أو غرفة. يتوافق الاسم المعروض مع الحقل customName في سمة المعلومات للأجهزة ذات البنية الرئيسية أو سمة معلومات الغرفة {20.

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

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

الكاميرا

السمات
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 تنتمي هذه السمة إلى أي جهاز متوافق مع رنين جرس الباب والأحداث الصحفية ذات الصلة.