סכימות של דגמי מכשירים ומכונות

דגם המכשיר

דגם המכשיר מוגדר בשדות שבקטע הזה.

שדות של דגמי מכשירים יכולים להכיל רק אותיות, מספרים ואת הפרמטרים הבאים סמלים: נקודה (.), מקף (-), קו תחתון (_), רווח ( ) וסימן פלוס (+). התו הראשון בשדה חייב להיות אות או מספר.

דוגמה
{
  "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: (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: (מערך<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: (מחרוזת) שדה חובה. המזהה של מכשיר הבדיקה. חייב להיות ייחודי בכל המכשירים הרשומים פרויקט למפתחים.
  • model_id: (מחרוזת) שדה חובה. מזהה של דגם המכשיר. חייב להיות זהה ל-device_model_id שמשויך למכשיר הבדיקה הזה. דגם המכשיר חייב להיות רשום בעבר.
  • nickname: (מחרוזת) אופציונלי. כינוי המכשיר. השם הזה ישמשו להתייחס למכשיר בממשקים חזותיים כמו הגדרות Assistant.
  • client_type: (מחרוזת) שדה חובה. הסוג של מכשיר הלקוח. חייב להיות אחד מהבאים: SDK_SERVICE או SDK_LIBRARY.