معلومات

تعرض واجهة برمجة التطبيقات /osc/info معلومات أساسية حول الكاميرا والوظائف المتوافقة معها.

إدخال

  • لا يأخذ هذا الأمر أي إدخال.

الناتج

الاسم Type الوصف
manufacturer سلسلة الشركة المصنّعة للكاميرا
model سلسلة طراز الكاميرا
serialNumber سلسلة الرقم التسلسلي
firmwareVersion سلسلة الإصدار الحالي للبرامج الثابتة.
supportUrl سلسلة عنوان URL لصفحة الويب الخاصة بدعم الكاميرا
gps منطقي True إذا كانت الكاميرا مزوّدة بنظام تحديد المواقع العالمي (GPS).
gyro منطقي صحيح إذا كانت الكاميرا تحتوي على جيروسكوب.
uptime عدد صحيح عدد الثواني منذ تشغيل الكاميرا.
api مصفوفة السلاسل قائمة بواجهات برمجة التطبيقات المتوافقة
endpoints الكائن عنصر JSON يحتوي على معلومات عن نقاط النهاية في الكاميرا اطّلِع على الجدول التالي.
apiLevel مصفوفة عدد صحيح تكون القيمة [1] بشكل تلقائي عندما يكون هذا الحقل غير متوفّر. [1 و2] تمثل واجهة برمجة التطبيقات 1 و2 معتمدة في حين أن [2] تمثل واجهة برمجة التطبيقات 2 فقط معتمدة. ويتحمل مطوِّر البرامج مسؤولية استرداد هذه المعلومات وتنفيذها بشكل مختلف استنادًا إلى القيمة. تمّت إضافة هذا الحقل في المستوى 2 من واجهة برمجة التطبيقات. ويُرجى أيضًا استخدام الرقم 2 في حال إتاحة واجهة برمجة التطبيقات الإصدار 2.1.
cameraId سلسلة معرّف فريد يمثّل الكاميرا تمت إضافة هذا الحقل في المستوى 2.1 من واجهة برمجة التطبيقات، وهو مرتبط بالتحميل المباشر.
_vendorSpecific النوع معلومات إضافية خاصة بالمورّد حول الكاميرا يُرجى بادئة المفاتيح الخاصة بالمورّدين باستخدام شرطة سفلية ( _ ) لتجنُّب تعارضات مساحة الاسم.

كائن "endpoints"

يقدّم عنصر JSON هذا معلومات عن المنافذ التي تستخدمها الكاميرا لنقاط النهاية.

ملاحظة: نقاط نهاية HTTPS اختيارية.

الاسم Type الوصف
httpPort عدد صحيح منفذ لخادم HTTP. (العدد التلقائي 80)
httpUpdatesPort عدد صحيح منفذ لتلقّي التحديثات عبر HTTP
httpsPort عدد صحيح (اختياري) منفذ لخادم HTTPs. (العدد التلقائي 443)
httpsUpdatesPort عدد صحيح (اختياري) منفذ لاستلام التحديثات عبر بروتوكولات HTTP.

خطأ

  • لا يعرض هذا الأمر أي أخطاء.

مثال
طلب 
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"
        ]
}