जानकारी

/osc/info एपीआई, कैमरे और उसके काम करने के तरीके के बारे में बुनियादी जानकारी दिखाता है यह काम करता है.

इनपुट

  • यह निर्देश कोई इनपुट नहीं लेता है.

आउटपुट

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

endpoints ऑब्जेक्ट

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

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

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

गड़बड़ी

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

उदाहरण
अनुरोध करें 
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"
        ]
}