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

طراز الجهاز

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

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

{
  "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: (object(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 نفسه مشروع مطوّر برامج.
• model_id: (سلسلة) مطلوبة. معرّف طراز الجهاز يجب مماثلة لـ device_model_id المرتبط بجهاز الاختبار هذا. يجب أن يكون طراز الجهاز مسجَّلاً. مسبقًا.
• nickname: (سلسلة) اختياري. اللقب الخاص بالجهاز. هذا الاسم يُستخدم للإشارة إلى الجهاز في واجهات مرئية مثل إعدادات "مساعد Google"
• client_type: (سلسلة) مطلوبة. نوع جهاز العميل. يجب أن يكون أي مما يلي: SDK_SERVICE أو SDK_LIBRARY.