دليل الكاميرا المنزلية الذكية
action.devices.types.CAMERA
- الكاميرات معقّدة وستختلف الميزات بشكل كبير بين المورّدين. وبمرور الوقت، ستكتسب الكاميرات العديد من السمات والسمات التي تصف إمكانات معيّنة، وقد يتفاعل الكثير منها مع بث الفيديو أو الصوت بطرق خاصة، مثل إرسال بث إلى جهاز آخر، والتعرّف على المحتوى المعروض في البث، وإعادة تشغيل الخلاصات.
يشير هذا النوع إلى ظهور رمز الكاميرا على الجهاز وبعض العناصر ذات الصلة المرادفات والأسماء المستعارة.
إمكانيات الجهاز
راجع وثائق السمات المقابلة تفاصيل التنفيذ، مثل السمات والحالات التي يجب أن تتيحها خدمتك، وكيفية إنشاء ردود EXECUTE وQUERY.
السمات المطلوبة
هذه السمات والأوامر مطلوبة، إذا كانت منطبقة على
الخاص بك. إذا لم يكن جهازك يتيح هذه السمات، أدخِل رمز الخطأ
functionNotSupported
في استجابة QUERY أو EXECUTE. عرض
الأخطاء والاستثناءات لمزيد من المعلومات.
متطلبات الجودة
- وقت الاستجابة: يجب أن يكون أقل من أو يساوي 2000 ملي ثانية.
- الموثوقية: يجب أن تكون أكبر من أو تساوي 97%.
مثال على جهاز: كاميرا بسيطة
يحتوي هذا القسم على مثال على حمولات بيانات intent تمثّل "كاميرا" شائعة. بناءً على نوع الجهاز والسمات المذكورة أعلاه. إذا قمتَ بإضافة أو إزالة سمات في التنفيذ، عليك تعديل ردودك وفقًا لذلك لتعكس هذه التغييرات.
نموذج رد المزامنة
{ "requestId": "6894439706274654512", "inputs": [ { "intent": "action.devices.SYNC" } ] }
{ "requestId": "6894439706274654512", "payload": { "agentUserId": "user123", "devices": [ { "id": "123", "type": "action.devices.types.CAMERA", "traits": [ "action.devices.traits.CameraStream" ], "name": { "name": "Simple camera" }, "willReportState": true, "attributes": { "cameraStreamSupportedProtocols": [ "hls", "progressive_mp4" ], "cameraStreamNeedAuthToken": true, "cameraStreamNeedDrmEncryption": false }, "deviceInfo": { "manufacturer": "smart-home-inc", "model": "hs1234", "hwVersion": "3.2", "swVersion": "11.4" } } ] } }
نموذج رد QUERY
{ "requestId": "6894439706274654514", "inputs": [ { "intent": "action.devices.QUERY", "payload": { "devices": [ { "id": "123" } ] } } ] }
{ "requestId": "6894439706274654514", "payload": { "devices": { "123": { "status": "SUCCESS", "online": true } } } }
نماذج أوامر التنفيذ
GetCameraStream
للحصول على تفاصيل إضافية حول معاملات الأوامر،
عرض
action.devices.traits.CameraStream
المرجع.
{ "requestId": "6894439706274654516", "inputs": [ { "intent": "action.devices.EXECUTE", "payload": { "commands": [ { "devices": [ { "id": "123" } ], "execution": [ { "command": "action.devices.commands.GetCameraStream", "params": { "StreamToChromecast": true, "SupportedStreamProtocols": [ "progressive_mp4" ] } } ] } ] } } ] }
{ "requestId": "6894439706274654516", "payload": { "commands": [ { "ids": [ "123" ], "status": "SUCCESS", "states": { "online": true, "cameraStreamAccessUrl": "https://fluffysheep.com/baaaaa.mp4", "cameraStreamReceiverAppId": "1g2f89213hg", "cameraStreamAuthToken": "12657342190192783", "cameraStreamProtocol": "progressive_mp4" } } ] } }
أخطاء الجهاز
اطّلع على القائمة الكاملة الأخطاء والاستثناءات.resourceUnavailable
: أي أخطاء مرتبطة بإنشاء عنوان URL للبث