סכימת DoorbellChime

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

sdm.devices.traits.DoorbellChime

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

שדות

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

פקודות

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

אירועים

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

עדכונים 

פעמון הדלת נלחץ.

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

אירוע צלצול

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

{
  "eventId" : "113972b7-f320-47d4-8809-cc5dbf8bbffc",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.DoorbellChime.Chime" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "jgvvpY3PJY41FcJfxhGjsLF8Mx..."
      }
    }
  }
  "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
דוגמה: "jgvvpY3PJY41FcJfxhGjsLF8Mx..."

שדות מטען ייעודי (payload) של אירועים

שדה תיאור סוג הנתונים
eventId המזהה הייחודי של האירוע. string
לדוגמה: '113972b7-f320-47d4-8809-cc5dbf8bbffc'
timestamp השעה שבה התרחש האירוע. string
לדוגמה: '2019-01-01T00:00:01Z'
resourceUpdate אובייקט שמכיל מידע על עדכון המשאב. object
userId מזהה ייחודי ומעורפל שמייצג את המשתמש. string
דוגמה: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
eventThreadId ניתן לעדכון המזהה הייחודי של השרשור של האירוע. string
דוגמה: 'd67cd3f7-86a7-425e-8b3-462f92ec9f59'
eventThreadState ניתן לעדכון מצב השרשור של האירוע. string
ערכים: "STARTED", "UPDATED", "ENDED"
resourceGroup אובייקט שמציין משאבים שייתכן שיש להם עדכונים דומים לאירוע הזה. המשאב של האירוע עצמו (מהאובייקט resourceUpdate) תמיד יופיע באובייקט הזה. object

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

שגיאות

יכול להיות שיוחזר קודי השגיאה הבאים בקשר לתכונה הזו:

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

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