ولاية

تعرض واجهة برمجة التطبيقات /osc/state سمات state للكاميرا. الفرق بين هذه الواجهة وواجهة برمجة التطبيقات info، وهي أنّ state يحتوي على قيم قابلة للتغيير. تمثّل حالة الكاميرا (batteryLevel، على سبيل المثال)، في حين أنّ السمة info يحتوي فقط على سمات ثابتة للكاميرا (على سبيل المثال، manufacturer أو السمات التي لا تتغير كثيرًا مثل firmwareVersion).

الإدخال

  • لا يتطلب هذا الأمر إدخالاً.

الناتج

الاسم النوع الوصف
fingerprint سلسلة بصمة الإصبع (المعرّف الفريد) لحالة الكاميرا الحالية
state الكائن كائن JSON يحتوي على حالة حالات الكاميرا المختلفة اطّلِع على الجدول التالي.

عنصر واحد (state)

يعرض كائن JSON هذا حالة الحالات المختلفة للكاميرا. يمكن للشركات المصنّعة توفير حالات مخصصة جديدة يجب أن تسبقها شرطة سفلية ( _ ) لمنع تضاربات مساحة الاسم.

الاسم النوع الوصف
sessionId سلسلة رقم تعريف الجلسة الحالية تم إيقاف هذا الحقل في المستوى 2 من واجهة برمجة التطبيقات.
batteryLevel العدد ويتم التعبير عنها كقيمة النقطة العائمة للبطارية المتبقية، مثال: 0.5
storageChanged منطقي True في حالة إدخال/إزالة نوع جديد من التخزين (مثل بطاقة SD أو محرك أقراص USB). تم إيقاف هذا الحقل في المستوى 2 من واجهة برمجة التطبيقات.
storageUri سلسلة معرّف فريد للتمييز بين مساحات التخزين المختلفة ويتم استخدامه لمعرفة ما إذا كانت مساحة التخزين قد تغيّرت أم لا. تمت إضافة هذا الحقل في المستوى 2 من واجهة برمجة التطبيقات.
_vendorSpecific [النوع](اختياري) الحالة الإضافية التي يحدّدها المورّد بشأن الكاميرا البادئة مع شرطة سفلية ( _ ) لمنع تعارضات مساحة الاسم.

خطأ

  • لا يؤدي هذا الأمر إلى عرض أي أخطاء.

مثال
طلب 
POST /osc/state HTTP/1.1
Host: [camera ip address]:[httpPort]
Accept: application/json
X-XSRF-Protected: 1
الردّ 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
    "fingerprint": "12EGA33",
    "state": {
        "sessionId": "12ABC3",
        "batteryLevel": 0.5,
        "storageChanged": false
    }
}