السمات

تتألف السمة في واجهة برمجة تطبيقات 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 في سمة المعلومات للأجهزة التي يتوفر بها أحد الوالدين للهيكل أو سمة RoomInfo للأجهزة التي تحتوي على رئيسية للغرفة.

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

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