مدل دستگاه و طرح‌واره‌های نمونه

مدل دستگاه

مدل دستگاه با فیلدهای این قسمت تعریف می شود.

فیلدهای مدل دستگاه فقط می توانند شامل حروف، اعداد و نمادهای زیر باشند: نقطه (.)، خط فاصله (-)، خط زیر خط (_)، فاصله ( ) و بعلاوه (+). اولین کاراکتر یک فیلد باید یک حرف یا عدد باشد.

مثال

{
  "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 پروژه Actions Console برای ارتباط با این مدل دستگاه. یک پروژه می تواند شامل چندین مدل دستگاه باشد.
• 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 Developer منحصربه‌فرد باشد.
• model_id : (رشته) الزامی است. شناسه مدل دستگاه؛ باید همان device_model_id مرتبط با این دستگاه آزمایشی باشد. مدل دستگاه باید قبلا ثبت شده باشد.
• nickname : (رشته) اختیاری. نام مستعار دستگاه این نام برای اشاره به دستگاه در رابط های بصری مانند تنظیمات دستیار استفاده می شود.
• client_type : (رشته) مورد نیاز است. نوع دستگاه مشتری باید یکی از موارد زیر باشد: SDK_SERVICE یا SDK_LIBRARY .