يعرض الجدول التالي جميع الخيارات المتاحة لضبطها واستلامها في camera.setOptions
وcamera.getOptions
. لا يمكن تغيير أحد الخيارات عندما يكون الدعم المقابل فارغًا أو يحتوي على خيار واحد فقط.
الاسم | النوع | الوصف | القراءة/الكتابة |
---|---|---|---|
captureMode |
سلسلة | وضع الالتقاط الحالي. الإعداد التلقائي هو image. |
ص |
captureModeSupport |
مصفوفة سلسلة | قائمة أوضاع الالتقاط المتوفرة حاليًا. الحد الأدنى المطلوب لمستوى واجهة برمجة التطبيقات هو ["image"] ، والحد الأدنى المطلوب لمستوى واجهة برمجة التطبيقات 2 هو ["image", "interval"] ، حيث يمثل "interval" وضع التقاط سلسلة من الصور على فترات زمنية معيَّنة، يُرجى الرجوع أيضًا إلى captureInterval وcaptureIntervalSupport . الوضعان الإضافيان ("video" and "walkaround") متوافقان مع المستوى 2 من واجهة برمجة التطبيقات، لذا فإن المجموعة الكاملة المتوافقة من المستوى 2 لواجهة برمجة التطبيقات هي ["image", "interval", "video", "walkaround"] ، حيث يمثل "video" وضع تصوير الفيديو ويمثِّل "walkaround" وضع التقاط صورتين بالتسلسل، والأول هو وضع المستخدمين في أي مكان بالنسبة إلى الكاميرا والثاني مع وضع المستخدمين على الجانب الآخر (مقارنة بنقطة أول موضع) في الكاميرا. يسمح ذلك للكاميرا بإزالة المستخدمين من الصورة النهائية من خلال الجمع بين الصورتين. عندما تكون الكاميرا متوافقة مع "walkaround" ويتم ضبطها على أنّها وضع الالتقاط الحالي، من المتوقّع أن يرسل العميل أمرَين أخذت صورة إلى الكاميرا، حيث يشير استجابة الأمر الأول (عند الانتهاء) إلى أنّ الكاميرا جاهزة لالتقاط الصورة الثانية، بينما يجب أن يعرض الأمر الثاني الصورة النهائية عند الانتهاء.
لإضافة المزيد من أوضاع الالتقاط غير المتاحة بعد، يُرجى استخدام الشرطة السفلية ( _ ) للأوضاع الخاصة بالمورد . تم تعديل هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
r |
captureStatus |
سلسلة | حالة الالتقاط الحالية. الإعداد التلقائي هو "idle" . ويُعدّ ذلك مفيدًا لتحديد حالة الكاميرا عندما تكون متصلة لأول مرة بأحد التطبيقات. وإذا كانت الكاميرا في منتصف تصوير الفيديو، قد تحتاج إلى إيقافه قبل أن يُطلب منها تنفيذ مهام أخرى، مثل تصوير فيديو آخر. تمت إضافة هذا الخيار في المستوى 2.1 لواجهة برمجة التطبيقات. |
ص |
captureStatusSupport |
مصفوفة سلسلة | قائمة بحالات التقاط الصور متاحة حاليًا، وحسب الإعدادات التلقائية، من المفترض أن تكون الحالة ["idle", "shooting"] إذا كانت تصوير الفيديو متاحة. ويمكن توفير تماثيل أخرى، مثل "downloading" . تمت إضافة هذا الخيار في المستوى 2.1 لواجهة برمجة التطبيقات. |
r |
exposureProgram |
الرقم | برنامج التعرض الحالي. | ص |
exposureProgramSupport |
مصفوفة الأرقام | قائمة ببرامج التعرّض لفيروس كورونا متاحة حاليًا، مثل [0, 1, 2, 3, 4] . ويمثل كل عدد صحيح برنامج عرض مختلفًا:
ExposureProgram .
|
r |
iso |
الرقم | الإعداد الحالي للسرعة وفقًا للمعيار ISO. | ص |
isoSupport |
مصفوفة الأرقام | مستوى واجهة برمجة التطبيقات 1: قائمة بإعدادات ISO المتاحة حاليًا، مثل مستوى واجهة برمجة التطبيقات 2: قائمة بإعدادات ISO المتاحة حاليًا، مثل تم تعديل هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
r |
shutterSpeed |
الرقم | الإعداد الحالي لسرعة الغالق | ص |
shutterSpeedSupport |
مصفوفة الأرقام | مستوى واجهة برمجة التطبيقات 1: قائمة بسرعات الالتقاط المتاحة حاليًا، مثل مستوى واجهة برمجة التطبيقات 2: قائمة بسرعات الالتقاط المتاحة حاليًا، مثل تم تعديل هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
r |
aperture |
الرقم | إعداد فتحة العدسة الحالية، عند توقف الكاميرا. | ص |
apertureSupport |
مصفوفة الأرقام | مستوى واجهة برمجة التطبيقات 1: تتوفر قائمة بإعدادات فتحة العدسة حاليًا، ويتم التعبير عنها في مستوى واجهة برمجة التطبيقات 2: قائمة بإعدادات فتحة العدسة متاحة حاليًا، ويتم التعبير عنها في |
r |
whiteBalance |
سلسلة | الإعداد الحالي لموازنة اللون الأبيض، مثل daylight الإعداد التلقائي هو auto . |
ص |
whiteBalanceSupport |
مصفوفة سلسلة | قائمة إعدادات توازن الأبيض المتاحة حاليًا، ويمكن أن تكون مجموعة فرعية من القائمة المحددة مسبقًا:[ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"] . قيم لكل مما يلي:
_vendor-setting . |
r |
exposureCompensation |
الرقم | التعويض الحالي للتعرّض لفيروس كورونا. | ص |
exposureCompensationSupport |
مصفوفة الأرقام | قائمة بمكافآت التعرّض لفيروس كورونا متاحة حاليًا، عادةً في الخطوة 0.33 أو 0.5، على سبيل المثال: [-1, -0.67, -0.33, 0, 0.33, 0.67, 1] |
r |
fileFormat |
اعتراض | درجة دقة الملف ونوعه الحاليَين ويجب أن يعكس التنسيق القيمة الحالية لـ { "type": "jpeg", "width": 2000, "height": 1000 }إذا كانت قيمة captureMode هي video ، يمكن أن يكون الرد المناسب:
{ "type": "mp4", "width": 1920, "height": 1080, "framerate": 30 } تم تعديل هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
ص |
fileFormatSupport |
مصفوفة الكائنات | قائمة بتنسيقات الملفات المتاحة حاليًا، على سبيل المثال: [ { "type": "jpeg", "width": 2000, "height": 1000 }, { "type": "jpeg", "width": 200, "height": 100 }, { "type": "mp4", "width": 1920, "height": 1080, "framerate": 24 }, { "type": "mp4", "width": 1280, "height": 720, "framerate": 30 }, ... ]اختَر الرابط التالي للحصول على مزيد من المعلومات عن جميع الأنواع. تم تعديل هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
r |
exposureDelay |
الرقم | التأخير الحالي بين الأمر takePicture ووقت بدء التعرّض للفيروس بالثواني. |
ص |
exposureDelaySupport |
مصفوفة الأرقام | قائمة بحالات تأخير التعرّض لفيروس كورونا متاحة حاليًا، بالثواني، على سبيل المثال: [0, 1, 2, 5, 10, 30, 60] |
r |
sleepDelay |
الرقم | التأخير الحالي قبل بدء الكاميرا في وضع السكون بالثواني. | ص |
sleepDelaySupport |
مصفوفة الأرقام | قائمة بحالات تأخير النوم المتوفّرة حاليًا، بالثواني، على سبيل المثال، [30, 60, 120, 300, 600, 1800, 65535] ، حيث 65535 توقف وضع السكون (لا تستطيع الكاميرا استخدام وضع السكون' حتى إيقاف التشغيل) ويجب أن تكون متوافقة. |
r |
offDelay |
الرقم | التأخير الحالي بالثواني قبل إيقاف تشغيل الكاميرا. | ص |
offDelaySupport |
مصفوفة الأرقام | قائمة تأخيرات إيقاف التشغيل المتاحة حاليًا، بالثواني، مثل [1800, 3600, 7200, 65535] ، حيث يتم إيقاف وضع إيقاف التشغيل 65535 (لا يتم إيقاف الكاميرا حتى تنفد البطارية أو يتم إيقافها يدويًا) ويجب أن يكون متوافقًا. |
r |
totalSpace |
الرقم | للقراءة فقط: عدد وحدات البايت من إجمالي مساحة التخزين. | r |
remainingSpace |
الرقم | للقراءة فقط: عدد وحدات البايت من مساحة التخزين المجانية. | r |
remainingPictures |
الرقم | للقراءة فقط: العدد المقدَّر للصور المتبقية بناءً على إعداد الالتقاط الحالي. | r |
gpsInfo |
اعتراض | معلومات نظام تحديد المواقع العالمي (GPS) الحالية. اضبط الموقع الجغرافي باستخدام { "lat": 23.532, "lng": -132.35 }تتضمن السمتَان lat وlng درجات عشرية، مع lat في النطاق و[-90, 90] وlng في النطاق، [-180, 180] . يُرجى العِلم أنّ كل موقع جغرافي لنظام تحديد المواقع العالمي (GPS) يكون صالحًا فقط
إلى أن يتم تنفيذ التحديث التالي من الهاتف. ويجب أن يحدّد الهاتف وقت تعديل
الموقع الجغرافي لنظام تحديد المواقع العالمي (GPS)، مثلاً قبل كل أمر takePicture مباشرةً. وتُبلِغ 65535 الكاميرا بأن موقع نظام تحديد المواقع العالمي (GPS) الحالي غير صالح وأن الكاميرا يجب أن تتجاهله وتستخدم نظام تحديد المواقع العالمي (GPS) في حال توفّره، على سبيل المثال، تشير القيمة setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) إلى أن الموقع الجغرافي لنظام تحديد المواقع العالمي (GPS) غير صالح. |
ص |
dateTimeZone |
سلسلة | معلومات التاريخ والوقت الحالية. تضبط هذه السياسة setOptions باستخدام التاريخ والوقت والمنطقة الزمنية للهاتف. التنسيق هو YYYY:MM:DD HH:MM:SS+(-)HH:MM . يتم استخدام التوقيت بتنسيق 24 ساعة، مع الفصل بين التاريخ والوقت بمسافة فارغة،
مع معادلة المنطقة الزمنية عن التوقيت العالمي المتفق عليه (UTC)، على سبيل المثال: 2014:05:18 01:04:29+8:00 هي المنطقة الزمنية للصين (UTC+8:00) |
ص |
hdr |
مستوى واجهة برمجة التطبيقات 1: قيمة منطقية مستوى واجهة برمجة التطبيقات 2: سلسلة |
مستوى واجهة برمجة التطبيقات 1: يتيح تفعيل/إيقاف وضع التقاط النطاق العالي الديناميكية. قيمة مستوى واجهة برمجة التطبيقات 2: الوضع الحالي للنطاق العالي الديناميكية من نوع السلسلة. تم تعديل هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
ص |
hdrSupport |
مستوى واجهة برمجة التطبيقات 1: قيمة منطقية مستوى واجهة برمجة التطبيقات 2: مصفوفة سلسلة |
مستوى واجهة برمجة التطبيقات 1: تشير القيمة مستوى واجهة برمجة التطبيقات 2: إذا لم يتوافق مع وضع النطاق العالي الديناميكية، فهو
تم تعديل هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
r |
exposureBracket |
اعتراض | الإعداد الحالي لقوس التعرّض لفيروس كورونا. لا تتوفّر هذه الميزة إلا عندما تكون قيمة hdrSupport == true (مستوى واجهة برمجة التطبيقات 1) أو hdrSupport تحتوي على وضع نطاق عالي الديناميكية واحد على الأقل (مستوى واجهة برمجة التطبيقات 2). إذا كانت الكاميرا تستخدم الأقواس اليدوية، فإن الكائن يحتوي على إدخالين:
{ "shots": 3, "increment": 1.33 }إذا كانت الكاميرا تستخدم الحامل التلقائي للتعرّض للضوء، يحتوي العنصر على: { "autoMode": true } مستوى واجهة برمجة التطبيقات 1: يكون الإعداد التلقائي فارغًا مستوى واجهة برمجة التطبيقات 2: يكون الإعداد التلقائي فارغًا {} عندما يحتوي تم تعديل هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
ص |
exposureBracketSupport |
اعتراض | تتوفّر حاليًا إعدادات قوس التعرّض لفيروس كورونا، على سبيل المثال: { "autoMode": true, "shotsSupport": [1, 3, 5, 7], "incrementSupport": [0.33, 0.67, 1, 1.33, 1.67, 2] } مستوى واجهة برمجة التطبيقات 1: يكون الإعداد التلقائي فارغًا مستوى واجهة برمجة التطبيقات 2: يكون الإعداد التلقائي فارغًا تم تعديل هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
r |
gyro |
منطقي | يمكنك ضبط السياسة على true لتفعيل وحدة الجيروسكوب في الكاميرا أو false لإيقاف هذه الميزة. يتم ضبط الإعداد التلقائي على true إذا كانت الكاميرا توفّر هذه الميزة، أو الخيار false . لا يمكن ضبط هذا الإعداد على true إلا في حال gyroSupport == true . |
ص |
gyroSupport |
منطقي | إذا كانت الكاميرا تحتوي على الجيروسكوب، يجب أن تكون هذه القيمة true ، وإلا false . |
r |
gps |
منطقي | تفعيل/إيقاف وحدة نظام تحديد المواقع العالمي للكاميرا. يجب أن تكون القيمة true لتفعيلها، أو false لإيقافها. وتكون القيمة التلقائية هي true إذا كانت الكاميرا توفّر هذه الميزة، أو إذا كانت تستخدم false . الإعداد true فقط عندما gpsSupport == true . |
ص |
gpsSupport |
منطقي | يجب أن تكون هذه القيمة true إذا كانت الكاميرا لها وحدة GPS خاصة بها، وإلا false . |
r |
imageStabilization |
سلسلة | عملية تثبيت الصورة الحالية، على سبيل المثال، off . |
ص |
imageStabilizationSupport |
مصفوفة سلسلة | خيارات تثبيت الصورة متاحة حاليًا. القائمة المُحدَّدة مسبقًا هي: ["off", "on"] .إذا كانت الكاميرا لا توفّر تثبيت الصور، يمكنك عرض ["off"] وإلا يمكنك عرض ["off", "on"] . يمكنك وضع البادئة (الشرطة المائلة) لسلاسل خاصة بالمورِّد، على سبيل المثال، [ "off", "_horizontal_stabilization", "_vibration_correction" ] . |
r |
wifiPassword |
سلسلة | يجب أن تتألف من 8 أحرف على الأقل تحتوي على أحرف وأرقام ورموز بدون مسافات. لا يمكن تغييره إلا عندما تكون الكاميرا متصلة بجهاز عميل. بعد تغيير الكاميرا، يجب إلغاء ربط الكاميرا حتى يتمكن المستخدم من إعادة الاتصال باستخدام
wifiPassword الجديد.يجب أن توفّر الكاميرا آلية لإعادة الضبط في حال نسيان كلمة المرور، على سبيل المثال، زرّ إعادة الضبط لاستعادة كلمة المرور التلقائية على الإعدادات الأصلية. |
w |
previewFormat |
اعتراض | درجة الدقة الحالية للمعاينة المباشرة، على سبيل المثال: { "width": 640, "height": 320, "framerate": 24 } تمت إضافة هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
ص |
previewFormatSupport |
مصفوفة الكائنات | تنسيقات المعاينة المباشرة المتاحة حاليًا، مثل: [ { "width": 640, "height": 320, "framerate": 24 }, ... { "width": 1280, "height": 720, "framerate": 24 } ] تمت إضافة هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
r |
captureInterval |
الرقم | الفاصل الزمني الحالي بين التقاط صورتين متتاليتين في seconds .
تمت إضافة هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
ص |
captureIntervalSupport |
اعتراض | يُسمح بالحد الأدنى والحد الأقصى للفواصل الزمنية بين التقاط صورتين متتاليتين، بالثواني، على سبيل المثال: { "minInterval": 10, "maxInterval": 60 }قد تختلف القيمة حسب fileFormat .
تمت إضافة هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
r |
captureNumber |
الرقم | عدد الصور التي سيتم التقاطها لجلسة التقاط واحدة مرة. الإعداد التلقائي هو 0 ، وهذا يعني أنّه يجب إنهاء الالتقاط بشكل صريح بموجب الأمر stopCapture. وبخلاف ذلك، يتوقف الالتقاط تلقائيًا بعد التقاط الصور للرقم المحدّد. يمكن أيضًا مقاطعة التقاط الصورة عندما تكون الكاميرا قد نفدت بطارية أو عندما يتم إيقافها عن قصد.
تمت إضافة هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
ص |
captureNumberSupport |
اعتراض | الحد الأدنى والأقصى لعدد الصور التي يمكن التقاطها أثناء التقاط لقطة شاشة، على سبيل المثال: { "minNumber": 2, "maxNumber": 50 }قد يتم تغيير ذلك حسب مساحة التخزين المتبقية. تمت إضافة هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
r |
remainingVideoSeconds |
الرقم | العدد المقدّر seconds للفيديو المتبقي استنادًا إلى إعداد الالتقاط الحالي.
تمت إضافة هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
r |
pollingDelay |
الرقم | الحد الأدنى للفاصل الزمني بالثواني بين طلبَين متتاليَين للاستطلاع على الحالة ويجب أن يستخدم العملاء هذا الحقل لتوجيه سلوكهم في استطلاع الحالة، على سبيل المثال، عند تركيب صورة، قد يحتاج العملاء إلى استطلاع رأي الكاميرا بشكل دوري لمعرفة ما إذا كانت تنتهي في تركيب الصورة. هناك اختلاف بين الكاميرات. على سبيل المثال، يمكن لبعض الكاميرات التعامل مع استطلاع الحالة كل ثانية، بينما تتيح بعض الكاميرات الأخرى فترة زمنية أطول.
تمت إضافة هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
r |
delayProcessing |
منطقي | True عند المعالجة (مثل التركيب) لها أولوية أقل من التقاط، أو بعبارة أخرى، يُسمح بالتقاط صورة أخرى قبل انتهاء معالجة الصورة السابقة التي تم التقاطها. وهذا الإجراء يُنصح به بشدة، خاصةً للكاميرات التي تتطلب وقتًا طويلاً للمعالجة.
تمت إضافة هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
ص |
delayProcessingSupport |
المصفوفة المنطقية |
تعني ويعني تمت إضافة هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
r |
clientVersion |
الرقم | مستوى واجهة برمجة التطبيقات الذي يقرر العميل استخدامه. يتم ضبط القيمة تلقائيًا على 1 إذا كانت الكاميرا
تتوافق مع المستوى 1 و2 لواجهة برمجة التطبيقات بحيث تظل البرامج المكتوبة للمستوى 1 لواجهة برمجة التطبيقات تعمل مع الكاميرا بدون أي تغيير، أو يتم ضبطها تلقائيًا على القيمة 2 إذا كانت الكاميرا تتوافق مع المستوى 2 لواجهة برمجة التطبيقات فقط، ولا يُنصح بهذا الإجراء قبل نقل البرامج إلى المستوى 2 لواجهة برمجة التطبيقات. إذا كانت الكاميرا
تتوافق مع المستوى 2 فقط لواجهة برمجة التطبيقات، يجب أن يتعذّر تنفيذ الطلب الذي يحاول ضبطها على 1. إذا تم ضبط تمت إضافة هذا الخيار في المستوى 2 لواجهة برمجة التطبيقات. |
ص |
photoStitchingSupport |
مصفوفة سلسلة | قائمة خيارات التركيب للصور. يمكنك عرض
تمت إضافة هذا الخيار في المستوى 2.1 لواجهة برمجة التطبيقات. |
r |
photoStitching |
سلسلة | خيار التركيب الحالي للصور، مثل تمت إضافة هذا الخيار في المستوى 2.1 لواجهة برمجة التطبيقات. |
ص |
videoStitchingSupport |
مصفوفة سلسلة | قائمة خيارات تركيب الفيديوهات. ارجع إلى تمت إضافة هذا الخيار في المستوى 2.1 لواجهة برمجة التطبيقات. |
r |
videoStitching |
سلسلة | خيار التركيب الحالي للفيديوهات، مثل تمت إضافة هذا الخيار في المستوى 2.1 لواجهة برمجة التطبيقات. |
ص |
videoGPSSupport |
مصفوفة سلسلة | قائمة خيارات نظام تحديد المواقع العالمي (GPS) أثناء التقاط الفيديو. ارجع
تمت إضافة هذا الخيار في المستوى 2.1 لواجهة برمجة التطبيقات. |
r |
videoGPS |
سلسلة | الخيار الحالي لدعم نظام تحديد المواقع العالمي (GPS) أثناء التقاط الفيديو، مثل تمت إضافة هذا الخيار في المستوى 2.1 لواجهة برمجة التطبيقات. |
ص |
_vendorSpecific |
[type] (اختياري) | خيارات الكاميرا الإضافية الخاصة بالمورّد. يجب إضافة سلاسل بشرطة سفلية خاصة بشرطة سفلية ( _ ). |