הסכימה של DoorbellChime

Nest Doorbell (דור קודם) Nest Doorbell (סוללה) Nest Doorbell (עם חיבור קווי) 

sdm.devices.traits.DoorbellChime

המאפיין הזה שייך לכל מכשיר שתומך בצלצול של פעמון דלת ובאירועי לחיצה קשורים.

שדות

אין שדות זמינים למאפיין הזה.

פקודות

אין פקודות זמינות למאפיין הזה.

אירועים

צלצול פעמונים

ניתן לעדכון 

לחצו על פעמון הדלת.

האירוע הזה תומך בהתראות שניתן לעדכן. אפשר לעדכן התראות קיימות מאפליקציות שנוצרו מהאירוע הזה באמצעות התוכן של אירוע מאוחר יותר עם אותו eventThreadId.

אירוע ב-Chime

מטען ייעודי (payload)

{
  "eventId" : "40c955ec-f512-437a-ba81-4ca8dca5ad88",
"timestamp" : "2019-01-01T00:00:01Z",
"resourceUpdate" : { "name" : "enterprises/project-id/devices/device-id", "events" : { "sdm.devices.events.DoorbellChime.Chime" : { "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...", "eventId" : "cRrrfG7XSfh8Wn1Kj4ocaNGKZM..." } } } "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
"eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
"eventThreadState" : "STARTED",
"resourceGroup" : [ "enterprises/project-id/devices/device-id" ] }

שדות של אירועים ב-Chime

שדה תיאור סוג הנתונים
eventSessionId Nest Doorbell (סוללה) Nest Doorbell (עם חיבור קווי) מזהה שניתן לאירועים שמתרחשים במסגרת סשן יחיד של אירועים קשורים. יכול לשמש לאיחוד אירועים.

משתמשים בו כדי לשייך את האירוע הזה לאירוע ClipPreview הקשור של המאפיין CameraClipPreview.

string
דוגמה: 'CjY5Y3VKaTZwR3o4Y19YbTVfMF…'
eventId Nest Doorbell (קודם) מזהה שמשויך לאירוע.

משתמשים בו עם הפקודה GenerateImage כדי להוריד את התמונה מהמצלמה שקשורה לאירוע הזה.

string
דוגמה: "cRrrfG7XSfh8Wn1Kj4ocaNGKZM…"

שדות של מטען נתונים אירועים

שדה תיאור סוג הנתונים
eventId המזהה הייחודי של האירוע. string
דוגמה: ‎40c955ec-f512-437a-ba81-4ca8dca5ad88‎
timestamp השעה שבה האירוע התרחש. string
דוגמה: ‎"2019-01-01T00:00:01Z"‎
resourceUpdate אובייקט שמכיל פרטים על עדכון המשאב. object
userId מזהה ייחודי ומעוות שמייצג את המשתמש. string
דוגמה: ‎AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi‎
eventThreadId ניתן לעדכון המזהה הייחודי של שרשור האירועים. string
דוגמה: ‎"d67cd3f7-86a7-425e-8bb3-462f92ec9f59"‎
eventThreadState ניתן לעדכון הסטטוס של שרשור האירוע. string
ערכים: 'STARTED',‏ 'UPDATED',‏ 'ENDED'
resourceGroup אובייקט שמציין משאבים שעשויים לכלול עדכונים דומים לאירוע הזה. המשאב של האירוע עצמו (מהאובייקט resourceUpdate) תמיד יהיה נוכח באובייקט הזה. object

למידע נוסף על הסוגים השונים של אירועים ועל האופן שבו הם פועלים, אפשר לעיין במאמר אירועים.

שגיאות

ייתכן שתקבלו את קודי השגיאה הבאים בנוגע למאפיין הזה:

הודעת השגיאה הכנסה לקליק פתרון בעיות
התמונה מהמצלמה כבר לא זמינה להורדה. DEADLINE_EXCEEDED התוקף של תמונות האירוע יפוג 30 שניות אחרי פרסום האירוע. חשוב להוריד את התמונה לפני שתוקפה יפוג.
מזהה האירוע לא שייך למצלמה. FAILED_PRECONDITION משתמשים ב-eventID הנכון שהוחזר על ידי אירוע המצלמה.

בחומר העזר בנושא קודי שגיאה ב-API מופיעה רשימה מלאה של קודי השגיאה ב-API.