ארץ

ה-API /osc/state מחזיר מאפייני state של המצלמה. ההבדל בין הממשק הזה לבין ה-API של info הוא שב-state יש ערכים שניתנים לשינוי שמייצגים את סטטוס המצלמה (לדוגמה, batteryLevel), ואילו info מכיל רק מאפיינים סטטיים של המצלמה (לדוגמה, manufacturer או מאפיינים שלא משתנים לעיתים קרובות, כמו firmwareVersion).

קלט

  • פקודה זו לא מקבלת קלט.

פלט

שם סוג תיאור
fingerprint מחרוזת טביעת אצבע (מזהה ייחודי) של מצב המצלמה הנוכחי.
state אובייקט אובייקט JSON שמכיל את הסטטוס של המצבים השונים של המצלמה. פרטים נוספים זמינים בטבלה הבאה.

אובייקט אחד (state)

אובייקט JSON הזה מציג את הסטטוס של מצבי המצלמה השונים. היצרנים יכולים לספק מצבים חדשים בהתאמה אישית, כשלפניהם צריך להוסיף קו תחתון ( _ ) כדי למנוע התנגשויות בין מרחבי שמות.

שם סוג תיאור
sessionId מחרוזת המזהה של הסשן הנוכחי. השדה הזה הוצא משימוש ברמת API 2.
batteryLevel מספרים מבוטאת כערך נקודה צפה (floating-point) של רמת הטעינה שנותרה, לדוגמה 0.5
storageChanged בוליאני הערך הוא True אם סוג אחסון חדש (למשל כרטיס SD או כונן USB) מוכנס או הוסר. השדה הזה הוצא משימוש ברמת API 2.
storageUri מחרוזת מזהה ייחודי להבחנה בין אמצעי אחסון שונים. הנתונים משמשים כדי לדעת אם האחסון השתנה או לא. השדה הזה נוסף ברמת API 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
    }
}