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

דגם המכשיר

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

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

דוגמה

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