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

مدل دستگاه

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

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

مثال

{
  "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 .