דגם המכשיר
דגם המכשיר מוגדר בשדות שבקטע הזה.
שדות של דגמי מכשירים יכולים להכיל רק אותיות, מספרים ואת הפרמטרים הבאים סמלים: נקודה (.), מקף (-), קו תחתון (_), רווח ( ) וסימן פלוס (+). התו הראשון בשדה חייב להיות אות או מספר.
{ "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
.