تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

جرس باب (قديم)

تتوفّر جميع أجراس Nest Doorbell القديمة في واجهة برمجة التطبيقات Smart Device Management (SDM). يعرض هذا الجهاز نوع الجهاز DOORBELL:

sdm.devices.types.DOORBELL

يتضمّن Google Nest Doorbell (القديم) كاميرا تعمل بالطريقة نفسها التي يعمل بها نوع الجهاز CAMERA.

السمات

مَراجع

السمات أو الأوامر أو الأحداث التالية مرتبطة بهذا الجهاز:

السمة	الوصف	الطلبات الصوتية	الفعاليات
CameraEventImage	تنتمي هذه السمة إلى أي جهاز يتيح إنشاء صور من الأحداث.	GenerateImage
CameraImage	تنتمي هذه السمة إلى أي جهاز يتيح التقاط الصور.
CameraLiveStream	تنطبق هذه السمة على أي جهاز يتيح البث المباشر.	GenerateRtspStream ExtendRtspStream StopRtspStream
CameraMotion	تنتمي هذه السمة إلى أي جهاز يتيح أحداث رصد الحركة.		الحركة
CameraPerson	تنتمي هذه السمة إلى أي جهاز يتيح أحداث رصد الأشخاص.		الشخص
CameraSound	تنتمي هذه السمة إلى أي جهاز يتيح أحداث رصد الصوت.		الصوت
DoorbellChime	تنتمي هذه السمة إلى أي جهاز يتيح رنين جرس الباب وأحداث الضغط ذات الصلة.		Chime
المعلومات	تنتمي هذه السمة إلى أي جهاز للحصول على معلومات ذات صلة بالجهاز.

JSON

يشير عدم توفّر سمة في استجابة GET إلى أنّ السمة أو الميزة غير متاحة حاليًا للجهاز. اطّلِع على أنواع الأجهزة للحصول على المزيد من المعلومات.

{
  "type" : "sdm.devices.types.DOORBELL",
  "traits" : {
    "sdm.devices.traits.CameraEventImage" : {},
    "sdm.devices.traits.CameraImage" : {
      "maxImageResolution" : {
        "width" : 1280,
        "height" : 960
      }
    },
    "sdm.devices.traits.CameraLiveStream" : {
      "maxVideoResolution" : {
        "width" : 640,
        "height" : 480
      },
      "videoCodecs" : ["H264"],
      "audioCodecs" : ["AAC"],
      "supportedProtocols" : ["WEB_RTC"]
    },
    "sdm.devices.traits.CameraMotion" : {},
    "sdm.devices.traits.CameraPerson" : {},
    "sdm.devices.traits.CameraSound" : {},
    "sdm.devices.traits.DoorbellChime" : {},
    "sdm.devices.traits.Info" : {
      "customName" : "My device"
    }
  }
}

التعامل مع أحداث جرس الباب والكاميرا

قد يتم بدء الأحداث التالية من نوع جهاز DOORBELL :

النوع	العنصر	الوصف
الحدث	حدث الحركة لسمة CameraMotion	رصدت الكاميرا حركة.
الحدث	حدث شخص لسمة CameraPerson	رصدت الكاميرا شخصًا.
الحدث	حدث الصوت لسمة CameraSound	رصدت الكاميرا صوتًا.
الحدث	حدث الرنين لسمة DoorbellChime	تم الضغط على جرس الباب.

على سبيل المثال، تم الضغط على زر جرس الباب:

الحمولة

{
  "eventId" : "48d37271-301c-486f-9266-edcb53982e06",
  "timestamp" : "2019-01-01T00:00:01Z",
  "resourceUpdate" : {
    "name" : "enterprises/project-id/devices/device-id",
    "events" : {
      "sdm.devices.events.DoorbellChime.Chime" : {
        "eventSessionId" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
        "eventId" : "B_NM_J0fhsbLeJBLdjLJmvlFmS..."
      }
    }
  }
  "userId" : "AVPHwEuBfnPOnTqzVFT4IONX2Qqhu9EJ4ubO-bNnQ-yi",
  "resourceGroup" : [
    "enterprises/project-id/devices/device-id"
  ]
}

تحتوي الحمولة لهذا الحدث على eventId يمكن استخدامه مع الأمر GenerateImage. يعرض هذا الأمر عنوان URL لتنزيل صورة الكاميرا ذات الصلة بال الحدث:

الطلب

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraEventImage.GenerateImage",
  "params" : {
    "eventId" : "TLJkb40AC62FKKrZvfBe1DPbhD..."
  }
}

الردّ

{
  "results" : {
    "url" : "https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...",
    "token" : "g.0.eventToken"
  }
}

تنزيل صورة من الكاميرا

يمكنك إجراء طلب GET إلى url من ردّ على الأمر GenerateImage، باستخدام token في رأس HTTP Authorization مع التفويض الأساسي، لتحميل صورة الكاميرا:

curl -H "Authorization: Basic g.0.eventToken" \
      https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...

استخدِم مَعلمات طلب البحث width أو height لتخصيص درجة دقة الصورة التي تم تنزيلها. يجب تحديد مَعلمة واحدة فقط من هذه المَعلمات. يتم تغيير حجم المَعلمة الأخرى تلقائيًا وفقًا لنسبة عرض إلى ارتفاع الكاميرا.

على سبيل المثال، إذا كانت نسبة العرض إلى الارتفاع للكاميرا هي 4:3، لتنزيل صورة الكاميرا بدرجة دقة 480 x ‏360، حدِّد العرض أو الارتفاع:

العرض

curl -H "Authorization: Basic g.0.eventToken" \
      https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?width=480

الطول

curl -H "Authorization: Basic g.0.eventToken" \
      https://domain/sdm_event_snapshot/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?height=360

تنطبق قيود أخرى على عنوان URL للتنزيل:

إذا تم توفير كلتا المَعلمتَين في عنوان URL، يتم استخدام width ويتم تجاهل height.
في حال عدم تقديم أيّ من المَعلمتَين في عنوان URL، يتم اختيار القيمة التلقائية 480 لسمة width.

اطّلِع على سمة CameraImage للحصول على معلومات عن سمات الصور.

الوصول إلى بث مباشر

يمكن الوصول إلى البث المباشر من الكاميرا. تتوفّر تنسيقات البث التالية على هذا الجهاز:

RTSP

للحصول على قائمة كاملة بالكاميرات وتنسيقات البث المتوافقة، يُرجى الاطّلاع على الأجهزة المتوافقة.

للوصول إلى بث مباشر، استخدِم الأمر المناسب من GenerateFormatStream لسمة CameraLiveStream.

RTSP

بالنسبة إلى بث RTSP، يؤدي الأمر GenerateRtspStream في أمر سمة CameraLiveStream إلى عرض عنوان URL للبث وstreamToken ذي الصلة:

الطلب

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.GenerateRtspStream",
  "params" : {}
}

الردّ

{
  "results" : {
    "streamUrls" : {
      "rtspUrl" : "rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken"
    },
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF...",
    "streamToken" : "g.0.streamingToken",
    "expiresAt" : "2018-01-04T18:30:00.000Z"
  }
}

بعد ذلك، استخدِم عنوان URL للبث للوصول إلى البث المباشر للكاميرا:

rtsps://someurl.com/CjY5Y3VKaTZwR3o4Y19YbTVfMF...?auth=g.0.streamingToken

لا يمكن مشاركة عناوين URL لبثّ RTSP المباشر بين العملاء. لا يمكن لأحد العملاء استخدام عنوان URL للبث إلا مرة واحدة في كل مرة. إذا أراد عدة عملاء بث المحتوى من الكاميرا نفسها في الوقت نفسه، يجب إرسال أوامر RTSP لكل عميل فردي، ويجب أن يستخدم كل عميل عنوان URL الخاص بالبث.

تمديد بث مباشر

تكون جلسات البث المباشر من الكاميرا صالحة لمدة 5 دقائق فقط. إذا كنت بحاجة إلى إطالة مدّة البث المباشر، استخدِم الأمر المناسب لتمديدFormatالبث في سمة CameraLiveStream لتنسيق البث الذي أنشأته.

RTSP

لتوسيع نطاق بث RTSP، استخدِم ExtendRtspStream من أمر سمة CameraLiveStream للحصول على قيمتَي streamExtensionToken وstreamToken الجديدتَين:

الطلب

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.ExtendRtspStream",
  "params" : {
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
  }
}

الردّ

{
  "results" : {
    "streamExtensionToken" : "dGNUlTU2CjY5Y3VKaTZwR3o4Y1...",
    "streamToken" : "g.0.newStreamingToken",
    "expiresAt" : "2018-01-04T18:30:00.000Z"
  }
}

عدِّل عنوان URL للبث باستخدام القيم الجديدة هذه لمواصلة مشاهدة البث المباشر:

rtsps://someurl.com/dGNUlTU2CjY5Y3VKaTZwR3o4Y1...?auth=g.0.newStreamingToken

إيقاف بث مباشر

في أي وقت تتوقف فيه عن استخدام بث مباشر من الكاميرا، عليك إيقافه وإلغاء صلاحيته. لإجراء ذلك، استخدِم الأمر المناسب لإيقافFormatالبث لسمة CameraLiveStream وفقًا لتنسيق البث الذي أنشأته.

RTSP

لإيقاف بث RTSP، استخدِم الرمز المميّز لإلغاء الصلاحية باستخدام الأمر StopRtspStream لخاصية CameraLiveStream:

الطلب

POST /enterprises/project-id/devices/device-id:executeCommand
{
  "command" : "sdm.devices.commands.CameraLiveStream.StopRtspStream",
  "params" : {
    "streamExtensionToken" : "CjY5Y3VKaTZwR3o4Y19YbTVfMF..."
  }
}

الردّ

{}

الأخطاء

قد يتم عرض رموز الخطأ التالية في ما يتعلّق بهذا الجهاز:

رسالة الخطأ	متوسط عائد النقرة	تحديد المشاكل وحلّها
لم تعُد صورة الكاميرا متاحة للتنزيل.	`DEADLINE_EXCEEDED`	تنتهي صلاحية صور الحدث بعد 30 ثانية من نشر الحدث. يُرجى تنزيل الصورة قبل انتهاء صلاحيتها.
رقم تعريف الحدث لا يعود للكاميرا.	`FAILED_PRECONDITION`	استخدِم `eventID` الصحيح الذي يعرضه حدث الكاميرا.

اطّلِع على مرجع رموز الخطأ في واجهة برمجة التطبيقات للحصول على القائمة الكاملة لرموز الخطأ في واجهة برمجة التطبيقات.