طرحواره زنگ درب

زنگ درب نست (قدیمی) زنگ درب نست (باتری) زنگ درب نست (سیمی)

sdm.devices.traits.DoorbellChime

این ویژگی متعلق به هر دستگاهی است که از زنگ در و رویدادهای مطبوعاتی مرتبط پشتیبانی می‌کند.

فیلدها

هیچ فیلدی برای این ویژگی موجود نیست.

دستورات

هیچ دستوری برای این ویژگی موجود نیست.

رویدادها

زنگ

قابل به‌روزرسانی

زنگ در فشرده شده است.

این رویداد از اعلان‌های قابل به‌روزرسانی پشتیبانی می‌کند. اعلان‌های برنامه‌ی موجود که از این رویداد ایجاد شده‌اند، می‌توانند با استفاده از محتوای یک رویداد بعدی با همان eventThreadId به‌روزرسانی شوند.

رویداد Chime

بار مفید 

{
  "eventId" : "7468df4e-e5af-4eea-84fb-ec1630e2afa5",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.DoorbellChime.Chime" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "7GcOH5Dc-6LLUek_31bnGrTjYi..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "eventThreadId" : "d67cd3f7-86a7-425e-8bb3-462f92ec9f59",
  "eventThreadState" : "STARTED",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

فیلدهای رویداد Chime

میدان توضیحات نوع داده
eventSessionId زنگ درب نست (باتری) زنگ درب نست (سیمی) شناسه‌ای که به رویدادهایی که به عنوان بخشی از یک جلسه رویدادهای مرتبط رخ می‌دهند، داده می‌شود. ممکن است برای تجمیع رویدادها استفاده شود.

از آن برای مرتبط کردن این رویداد با رویداد مرتبط ClipPreview از ویژگی CameraClipPreview استفاده کنید.

 string
مثال: "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
eventId زنگ درب Nest (قدیمی) شناسه‌ای مرتبط با رویداد.

برای دانلود تصویر دوربین مربوط به این رویداد، از آن به همراه دستور GenerateImage استفاده کنید.

 string
مثال: "7GcOH5Dc-6LLUek_31bnGrTjYi..."

فیلدهای بار رویداد

میدان توضیحات نوع داده
eventId شناسه منحصر به فرد برای رویداد. string
مثال: "7468df4e-e5af-4eea-84fb-ec1630e2afa5"
timestamp زمانی که رویداد رخ داده است. string
مثال: "2019-01-01T00:00:01Z"
resourceUpdate شیء‌ای که اطلاعات مربوط به به‌روزرسانی منابع را شرح می‌دهد. object
userId یک شناسه منحصر به فرد و مبهم که نمایانگر کاربر است. string
مثال: "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi"
eventThreadId قابل به‌روزرسانی شناسه منحصر به فرد برای رشته رویداد. string
مثال: "d67cd3f7-86a7-425e-8bb3-462f92ec9f59"
eventThreadState قابل به‌روزرسانی وضعیت نخ رویداد. string
مقادیر: "شروع"، "به‌روزرسانی"، "پایان"
resourceGroup شیء‌ای که منابعی را نشان می‌دهد که ممکن است به‌روزرسانی‌های مشابهی با این رویداد داشته باشند. منبع خود رویداد (از شیء resourceUpdate ) همیشه در این شیء وجود خواهد داشت. object

برای اطلاعات بیشتر در مورد انواع مختلف رویدادها و نحوه عملکرد آنها، به بخش رویدادها مراجعه کنید.

خطاها

کد(های) خطای زیر ممکن است در رابطه با این ویژگی برگردانده شوند:

پیام خطا آر پی سی عیب‌یابی
تصویر دوربین دیگر برای دانلود در دسترس نیست. DEADLINE_EXCEEDED تصاویر رویداد ۳۰ ثانیه پس از انتشار رویداد منقضی می‌شوند. حتماً قبل از انقضا، تصویر را دانلود کنید.
شناسه رویداد متعلق به دوربین نیست. FAILED_PRECONDITION از eventID صحیح برگردانده شده توسط رویداد دوربین استفاده کنید.

برای مشاهده لیست کامل کدهای خطای API به مرجع کدهای خطای API مراجعه کنید.