जानकारी

/osc/info API, कैमरे और उसके साथ काम करने वाले फ़ंक्शन के बारे में बुनियादी जानकारी देता है.

इनपुट

  • इस निर्देश के लिए कोई इनपुट नहीं चाहिए.

आउटपुट

नाम Type ब्यौरा
manufacturer String कैमरा बनाने वाली कंपनी.
model String कैमरा मॉडल.
serialNumber String सीरियल नंबर.
firmwareVersion String फ़र्मवेयर का मौजूदा वर्शन.
supportUrl String कैमरे के सहायता वेबपेज का यूआरएल.
gps बूलियन अगर कैमरे में जीपीएस है, तो वैल्यू 'सही' होगी.
gyro बूलियन अगर कैमरे में जाइरोस्कोप है, तो वैल्यू 'सही' होगी.
uptime Integer कैमरा चालू होने के बाद से सेकंड की संख्या.
api स्ट्रिंग अरे इस्तेमाल किए जा सकने वाले एपीआई की सूची.
endpoints ऑब्जेक्ट एक JSON ऑब्जेक्ट, जिसमें कैमरे के एंडपॉइंट के बारे में जानकारी होती है. अगली टेबल देखें.
apiLevel पूर्णांक अरे जब यह फ़ील्ड मौजूद नहीं होता है, तो डिफ़ॉल्ट रूप से यह [1] होता है. [1, 2] से पता चलता है कि एपीआई 1 और 2, दोनों काम करते हैं, जबकि [2] सिर्फ़ एपीआई 2 के साथ काम करता है. इस जानकारी को हासिल करने और वैल्यू के हिसाब से, इसे अलग-अलग तरीके से लागू करने की ज़िम्मेदारी डेवलपर की है. यह फ़ील्ड एपीआई लेवल 2 में जोड़ा गया था. अगर आपके डिवाइस पर एपीआई 2.1 काम करता है, तो कृपया 2.1 का भी इस्तेमाल करें.
cameraId String कैमरे को दिखाने वाला यूनीक आईडी. यह फ़ील्ड एपीआई लेवल 2.1 में जोड़ा गया था और डायरेक्ट अपलोड के लिए काम का है.
_vendorSpecific टाइप वेंडर के लिए कैमरे के बारे में अतिरिक्त जानकारी. नेमस्पेस के टकराव से बचने के लिए, कृपया वेंडर के हिसाब से बनी कुंजियों से पहले अंडरस्कोर ( _ ) लगाएं.

endpoints ऑब्जेक्ट

यह JSON ऑब्जेक्ट, उन पोर्ट के बारे में जानकारी देता है जिनका इस्तेमाल कैमरा, एंडपॉइंट के लिए करता है.

ध्यान दें: एचटीटीपीएस एंडपॉइंट ज़रूरी नहीं हैं.

नाम Type ब्यौरा
httpPort Integer एचटीटीपी सर्वर के लिए पोर्ट. (डिफ़ॉल्ट 80)
httpUpdatesPort Integer एचटीटीपी पर अपडेट पाने के लिए पोर्ट करें
httpsPort Integer (ज़रूरी नहीं) एचटीटीपी सर्वर के लिए पोर्ट करें. (डिफ़ॉल्ट 443)
httpsUpdatesPort Integer (ज़रूरी नहीं) एचटीटीपी पर अपडेट पाने के लिए पोर्ट करें.

गड़बड़ी

  • यह निर्देश कोई गड़बड़ी नहीं दिखाता है.

उदाहरण
अनुरोध करें 
GET /osc/info HTTP/1.1
Host: [camera ip address]:[httpPort]
Accept: application/json
X-XSRF-Protected: 1
रिस्पॉन्स (एपीआई 2) 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
        "manufacturer": "AAA",
        "model": "BBB",
        "serialNumber": "CCC",
        "firmwareVersion": "DDD",
        "supportUrl": "EEE",
        "endpoints": {
            "httpPort": 80,
            "httpUpdatesPort": 10080,
            ...
        },
        "gps": true,
        "gyro": false,
        "uptime": 600,
        "api": [
            "/osc/info",
            "/osc/state",
            "/osc/checkForUpdates",
            "/osc/commands/execute",
            "/osc/commands/status"
        ],
        "apiLevel": [1, 2]
}
रिस्पॉन्स (एपीआई 1) 
HTTP/1.1 200 OK
Content-Type: application/json;charset=utf-8
Content-Length: {CONTENT_LENGTH}
X-Content-Type-Options: nosniff

{
        "manufacturer": "AAA",
        "model": "BBB",
        "serialNumber": "CCC",
        "firmwareVersion": "DDD",
        "supportUrl": "EEE",
        "endpoints": {
            "httpPort": 80,
            "httpUpdatesPort": 10080,
            ...
        },
        "gps": true,
        "gyro": false,
        "uptime": 600,
        "api": [
            "/osc/info",
            "/osc/state",
            "/osc/checkForUpdates",
            "/osc/commands/execute",
            "/osc/commands/status"
        ]
}