طراز الجهاز ومخططات الأجهزة الافتراضية

طراز الجهاز

يتم تحديد طراز الجهاز من خلال الحقول الواردة في هذا القسم.

لا يمكن أن تحتوي حقول طراز الجهاز إلا على أحرف وأرقام ورموز التالية: نقطة (.) وواصلة (-) وشرطة سفلية (_) ومسافة ( ) وعلامة زائد (+). يجب أن يكون الحرف الأول من الحقل حرفًا أو رقمًا.

{
  "project_id": "my-devices-project",
  "device_model_id": "my-devices-project-prototype-light-v1",
  "manifest": {
    "manufacturer": "Assistant SDK developer",
    "product_name": "Assistant SDK light",
    "device_description": "Assistant SDK light device"
  },
  "device_type": "action.devices.types.LIGHT",
  "traits": ["action.devices.traits.OnOff"]
}

{
  "project_id": string,
  "device_model_id": string,
  "manifest": {
    "manufacturer": string,
    "product_name": string,
    "device_description": string
  },
  "device_type": string,
  "traits": [ string ]
}

• project_id: (سلسلة) مطلوبة. رقم تعريف مشروع Google Cloud Platform الخاص بمشروع "وحدة تحكّم المهام" لربطه بطراز الجهاز هذا. يمكن أن يحتوي المشروع على عدة طُرز من الأجهزة.
• device_model_id: (سلسلة) مطلوبة. هو معرّف فريد عالميًا لطراز الجهاز هذا، لذا استخدِم project_id كبادئة للمساعدة في تجنب التضاربات في نطاق جميع المشاريع. يتم استخدامها في المقاييس وأثناء تسجيل الجهاز.
• manifest: (كائن(البيان)) مطلوب. بيانات التعريف التي تصف طراز الجهاز والشركة المصنعة. قد يظهر هذا التغيير في وحدة تحكُّم SDK (القادمة) ولوحات بيانات المقاييس والواجهات المرئية الأخرى ذات الصلة.
  • manifest.manufacturer: (سلسلة) مطلوبة. اسم الشركة المصنعة للجهاز.
  • manifest.product_name: (سلسلة) مطلوبة. اسم المنتج الموجّه للمستهلك لطراز الجهاز هذا.
  • manifest.device_description: (سلسلة) اختيارية. وصف طراز الجهاز هذا.
• device_type: (سلسلة) مطلوبة. تمثّل هذه السمة نوع مكوّنات الجهاز. اختر ما يلي:
  • action.devices.types.CAMERA
  • action.devices.types.DISHWASHER
  • action.devices.types.DRYER
  • action.devices.types.LIGHT
  • action.devices.types.OUTLET
  • action.devices.types.PHONE
  • action.devices.types.REFRIGERATOR
  • action.devices.types.SCENE
  • action.devices.types.SOUNDBAR
  • action.devices.types.SPEAKER
  • action.devices.types.SWITCH
  • action.devices.types.THERMOSTAT
  • action.devices.types.TV
  • action.devices.types.VACUUM
  • action.devices.types.WASHER
• traits: (Array<String>) اختياري. تضم هذه القائمة السمات التي يدعمها الجهاز. وتشمل السمات الأوامر والسمات والحالات للجهاز. لن تحتاج إلى تعريف حزمة إجراءات لاستخدام السمات المضمَّنة:

مثيل الجهاز

يتم تحديد مثيل الجهاز من خلال الحقول الواردة في هذا القسم.

يجب أن تبدأ حقول النسخة الافتراضية للجهاز بحرف أو رقم. لا يمكن أن يحتوي رقم تعريف الجهاز إلا على أحرف وأرقام ورموز التالية: النقطة (.) والواصلة (-) والشرطة السفلية (_) والجمع (+). ولا يمكن أن يتضمّن لقب الجهاز سوى أرقام وأحرف ورمز المسافة ( ).

  {
    "id": "my_led_1",
    "model_id": "my-devices-project-prototype-light-v1",
    "nickname": "My Assistant Light",
    "client_type": "SDK_LIBRARY"
  }

  {
    "id": string,
    "model_id": string,
    "nickname": string,
    "client_type": string
  }

• id: (سلسلة) مطلوبة. هو معرّف جهاز الاختبار. ويجب أن يكون فريدًا داخل جميع الأجهزة المسجَّلة ضمن مشروع Google Developers نفسه.
• model_id: (سلسلة) مطلوبة. يجب أن يكون معرّف طراز الجهاز مطابقًا لرقم التعريف device_model_id المرتبط بجهاز الاختبار هذا. يجب أن يكون تم تسجيل طراز الجهاز سابقًا.
• nickname: (سلسلة) اختيارية. لقب الجهاز سيُستخدم هذا الاسم للإشارة إلى الجهاز في الواجهات المرئية مثل إعدادات "مساعد Google".
• client_type: (سلسلة) مطلوبة. نوع جهاز العميل. يجب أن يكون أحد ما يلي: SDK_SERVICE أو SDK_LIBRARY.