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