حالت

/osc/state API ویژگی های state دوربین را برمی گرداند. تفاوت بین این و API info در این است که state حاوی مقادیر قابل تغییری است که وضعیت دوربین را نشان می‌دهد (به عنوان مثال، batteryLevel )، در حالی که info فقط شامل ویژگی‌های ثابت دوربین است (مثلاً manufacturer یا ویژگی‌هایی که اغلب تغییر نمی‌کنند مانند firmwareVersion) .

ورودی

  • این دستور هیچ ورودی نمی گیرد.

خروجی

نام تایپ کنید شرح
fingerprint رشته اثر انگشت (شناسه منحصر به فرد) وضعیت فعلی دوربین.
state هدف - شی یک شی JSON حاوی وضعیت وضعیت های مختلف دوربین. جدول بعدی را ببینید.

شیء state

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

نام تایپ کنید شرح
sessionId رشته شناسه جلسه جاری این فیلد در سطح 2 API منسوخ شده است.
batteryLevel عدد به عنوان یک مقدار ممیز شناور باقیمانده باتری، به عنوان مثال 0.5 بیان می شود
storageChanged بولی درست است اگر نوع جدیدی از حافظه (مانند کارت SD یا درایو USB) وارد/حذف شود. این فیلد در سطح 2 API منسوخ شده است.
storageUri رشته یک شناسه منحصر به فرد برای تشخیص انبارهای مختلف. برای تشخیص اینکه آیا فضای ذخیره سازی تغییر کرده است یا خیر استفاده می شود. این فیلد در سطح 2 API اضافه شد.
_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
    }
}