لضبط قيم لخصائص محددة، على سبيل المثال، تشغيل/إيقاف نظام تحديد المواقع العالمي (GPS)، والتاريخ والوقت، وISO، وموازنة اللون الأبيض، وسرعة الغالق، وتأخير السكون/إيقاف التشغيل، وما إلى ذلك. تم تعديل هذا الأمر في المستوى 2 من واجهة برمجة التطبيقات.
المَعلمات
- sessionId: معرّف الجلسة الفريد من نوع سلسلة، ويتم الحصول عليه باستخدام الأمر
camera.startSession. تم إيقاف هذا الحقل نهائيًا في المستوى 2 من واجهة برمجة التطبيقات. - الخيارات: أزواج JSON
<key, value>من السمات المطلوب ضبطها. ويمكن أن تكون القيمة من الأنواع التالية:StringأوString ArrayأوNumberأوNumber ArrayأوBooleanأوObjectأوObject Array. يُرجى الاطّلاع على الخيارات.
النتائج
- لا يعرض هذا الأمر أي نتيجة.
الأخطاء
- missingParameter: هناك معلمة مطلوبة واحدة أو أكثر غير موجودة؛ على سبيل المثال، لم يتم تحديد
options. - invalidParameterName: خيار واحد أو أكثر من خيارات معلمة الإدخال أو اسم الخيار
غير معروف أو غير متوافق، على سبيل المثال، يجب عرض هذا الرمز إذا تم استخدام خيار (مثل
captureInterval) من المستوى 2 لواجهة برمجة التطبيقات عندما يكونclientVersionفيOptionsيساوي 1. - validParameterValue: تم التعرّف على معلمة إدخال أو اسم خيار واحد أو أكثر، ولكن قيمتها غير صالحة، على سبيل المثال، نوع البيانات غير صحيح.
Command I/O (إدخال وإخراج) | |
|---|---|
| إدخال الأوامر (المستوى 1 من واجهة برمجة التطبيقات) | {
"parameters": {
"sessionId": "12ABC3",
"options": {
"isoBalance": 200
}
}
} |
| مخرجات الأوامر (المستوى 1 من واجهة برمجة التطبيقات) | none |
| مخرجات الأمر (الخطأ) (مستوى واجهة برمجة التطبيقات 1) | {
"error": {
"code": "invalidParameterName",
"message": "Parameter options contains unsupported option isoBalance."
}
} |
| إدخال الأوامر (المستوى 2 من واجهة برمجة التطبيقات) | {
"parameters": {
"options": {
"iso": 200,
"captureInterval": 20
}
}
} |
| مخرجات الأوامر (المستوى 2 لواجهة برمجة التطبيقات) | none |
| مخرجات الأمر (الخطأ) (مستوى واجهة برمجة التطبيقات 2) | {
"error": {
"code": "invalidParameterName",
"message": "Parameter options contains unsupported option captureInterval."
}
} |