گزینه ها

جدول زیر همه گزینه های موجود برای تنظیم و دریافت توسط camera.setOptions و camera.getOptions نشان می دهد. زمانی که پشتیبانی مربوطه آن خالی باشد یا فقط یک گزینه داشته باشد، نمی توان یک گزینه را تغییر داد.

نام تایپ کنید شرح بخوان / بنویس
captureMode رشته حالت تصویربرداری فعلی پیش فرض به image. rw
captureModeSupport آرایه رشته ای فهرست حالت‌های ضبط در حال حاضر موجود است. حداقل نیاز برای سطح 1 API ["image"] است و حداقل نیاز برای سطح 2 API ["image", "interval"] است، که در آن "interval" حالت گرفتن یک سری از تصاویر با فاصله زمانی مشخص را نشان می دهد. لطفاً captureInterval و captureIntervalSupport را نیز ببینید. دو حالت اضافی ("video" and "walkaround") توسط سطح 2 API پشتیبانی می شوند، بنابراین مجموعه کامل پشتیبانی شده توسط API سطح 2 ["image", "interval", "video", "walkaround"] است، که در آن "video" فیلمبرداری را نشان می دهد و "walkaround" حالت ثبت دو تصویر را به ترتیب نشان می دهد، اولی با ایستادن کاربران در هر جایی نسبت به دوربین و دومی با ایستادن کاربران در طرف مقابل (نسبت به اولین نقطه ایستاده) از دوربین این به دوربین اجازه می دهد تا با ترکیب دو تصویر، کاربران را از تصویر نهایی حذف کند. هنگامی که "walkaround" توسط دوربین پشتیبانی می شود و به عنوان حالت تصویربرداری فعلی تنظیم می شود، مشتری باید انتظار داشته باشد که دو دستور takePicture را به دوربین ارسال کند، جایی که پاسخ اولین فرمان (وقتی تمام شد) نشان می دهد دوربین آماده گرفتن است. تصویر دوم در حالی که فرمان دوم باید تصویر نهایی را پس از اتمام آن برگرداند.

برای افزودن حالت‌های تصویربرداری بیشتر که هنوز پشتیبانی نمی‌شوند، لطفاً حالت‌های خاص فروشنده را با یک زیرخط (_) پیشوند قرار دهید.

این گزینه در سطح 2 API اصلاح شد.

 r
captureStatus رشته وضعیت ضبط فعلی پیش‌فرض "idle" است. این برای تعیین وضعیت دوربین زمانی که برای اولین بار به یک برنامه متصل می شود مفید است. اگر دوربین در وسط فیلمبرداری قرار دارد، ممکن است لازم باشد قبل از دستور انجام کارهای دیگر متوقف شود، مثلاً یک فیلمبرداری دیگر.

این گزینه در سطح API 2.1 اضافه شده است.

 rw
captureStatusSupport آرایه رشته ای لیست وضعیت های ضبط در حال حاضر موجود است. به طور پیش فرض، اگر فیلمبرداری پشتیبانی می شود، باید ["idle", "shooting"] باشد. مجسمه های دیگری نیز می توانند ارائه شوند، به عنوان مثال "downloading" .

این گزینه در سطح API 2.1 اضافه شده است.

 r
exposureProgram عدد برنامه قرار گرفتن در معرض فعلی rw
exposureProgramSupport آرایه اعداد لیست برنامه های قرار گرفتن در معرض در حال حاضر موجود؛ به عنوان مثال، [0, 1, 2, 3, 4] . هر عدد صحیح نشان دهنده یک برنامه نوردهی متفاوت است:
  • 0 = تعریف نشده است
  • 1 = دستی
  • 2 = برنامه معمولی
  • 3 = اولویت دیافراگم
  • 4 = اولویت شاتر
لینک زیر را برای دانلود جزئیات بیشتر درباره ExposureProgram انتخاب کنید.		 r
iso عدد تنظیم سرعت ISO فعلی rw
isoSupport آرایه اعداد

سطح API 1: لیست تنظیمات ISO در حال حاضر موجود است. برای مثال، [100, 200, 400, 800,1600] یا [] زمانی که در حالت auto است.

API سطح 2: لیست تنظیمات ISO در حال حاضر موجود است. به عنوان مثال، [0, 100, 200, 400, 800, 1600] ، که در آن 0 نشان دهنده حالت auto است.

این گزینه در سطح 2 API اصلاح شد.

 r
shutterSpeed عدد تنظیم سرعت شاتر فعلی rw
shutterSpeedSupport آرایه اعداد

API سطح 1: فهرستی از سرعت های شاتر موجود در حال حاضر. برای مثال، [0.067, 0.033, 0.017,0.008] یا [] زمانی که در حالت auto است.

API سطح 2: لیست سرعت های شاتر در حال حاضر موجود. به عنوان مثال، [0, 0.067, 0.033, 0.017, 0.008] ، که در آن 0 حالت auto را نشان می دهد.

این گزینه در سطح 2 API اصلاح شد.

 r
aperture عدد تنظیم دیافراگم فعلی، در f-stop. rw
apertureSupport آرایه اعداد

API سطح 1: فهرست تنظیمات دیافراگم موجود در حال حاضر، بیان شده در f/number . برای مثال، [1.4, 2, 2.8, 4, 5.6, 8, 11] یا [] زمانی که حالت auto است.

API سطح 2: فهرست تنظیمات دیافراگم در حال حاضر موجود، بیان شده در f/number . به عنوان مثال، [0, 1.4, 2, 2.8, 4, 5.6, 8, 11] ، که در آن 0 نشان دهنده حالت auto است.

 r
whiteBalance رشته تنظیم تعادل رنگ سفید فعلی؛ به عنوان مثال، daylight . پیش فرض به auto است. rw
whiteBalanceSupport آرایه رشته ای فهرست تنظیمات تراز سفیدی در حال حاضر موجود است، می‌تواند زیرمجموعه‌ای از فهرست از پیش تعریف‌شده باشد: [ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"] . مقادیر برای هر کدام:
  • incandescent ، حدود 3200K
  • fluorescent ، حدود 4000K
  • دیتا لایت، حدود datalight
  • cloudy-daylight ، حدود 6000K
  • shade ، حدود 7000K
  • twilight ، حدود 12000K
پیشوند نام های تنظیم خاص فروشنده با زیرخط. به عنوان مثال: _vendor-setting		 r
exposureCompensation عدد جبران نوردهی فعلی rw
exposureCompensationSupport آرایه اعداد فهرستی از جبران‌های مواجهه در حال حاضر موجود، معمولاً در مرحله 0.33 یا 0.5. به عنوان مثال: [-1, -0.67, -0.33, 0, 0.33, 0.67, 1] r
fileFormat هدف - شی

نوع و وضوح فایل فعلی قالب باید مقدار فعلی captureMode را منعکس کند. به عنوان مثال، اگر captureMode image باشد، پاسخ مناسب می تواند این باشد:

{
    "type": "jpeg",
    "width": 2000,
    "height": 1000
}
اگر captureMode video باشد، پاسخ مناسب می تواند این باشد:
{
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 30
}

این گزینه در سطح 2 API اصلاح شد.

 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 API اصلاح شد.

 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 فعلی تنظیم با استفاده از setOptions با استفاده از 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 ساعته است، تاریخ و زمان با یک فضای خالی از هم جدا شده اند، و منطقه زمانی یک افست از زمان UTC است. برای مثال، 2014:05:18 01:04:29+8:00 منطقه زمانی چین است (UTC+8:00) rw
hdr

API سطح 1: Boolean

API سطح 2: رشته

API سطح 1: حالت ضبط HDR را فعال/غیرفعال کنید. مقدار true برای فعال کردن HDR یا false برای غیرفعال کردن آن است. مقدار پیش فرض false است. تنظیم فقط زمانی می تواند true که hdrSupport نیز true .

API سطح 2: حالت فعلی HDR از نوع String.

این گزینه در سطح 2 API اصلاح شد.

 rw
hdrSupport

API سطح 1: Boolean

API سطح 2: آرایه رشته ای

API سطح 1: مقدار true نشان می دهد که دوربین از HDR پشتیبانی می کند. تنظیم false دوربین بدون HDR را شناسایی می کند.

API سطح 2: اگر از حالت HDR پشتیبانی نمی کنید، [“off”] است. اگر از یک حالت HDR پشتیبانی می‌کنید، این حالت [“off”, “hdr”] است، اگر چند حالت HDR (بر اساس الگوریتم‌های مختلف) پشتیبانی می‌شود، آنگاه [“off”, “hdr”, “hdr1”, “hdr2”, ...]

این گزینه در سطح 2 API اصلاح شد.

 r
exposureBracket هدف - شی تنظیم براکت نوردهی فعلی. فقط زمانی در دسترس است که hdrSupport == true (سطح API 1) یا hdrSupport دارای حداقل یک حالت HDR (سطح API 2) باشد. اگر دوربین از براکت نوردهی دستی استفاده می کند، شی دارای دو ورودی است:
  1. shots ، یک عدد صحیح حاوی تعداد عکس هایی که باید گرفته شود.
  2. increment ، عددی که شامل افزایش EV بین عکس‌ها است.
به عنوان مثال: 
{
    "shots": 3,
    "increment": 1.33
}
اگر دوربین از براکت نوردهی خودکار استفاده می کند، شی شامل موارد زیر است: 
{
    "autoMode": true
}

سطح 1 API: زمانی که hdrSupport == false {} را خالی می‌کند. زمانی که hdr true است، تولیدکنندگان مقادیر پیش‌فرض را تعیین می‌کنند (مثلاً براکتینگ نوردهی خودکار).

سطح 2 API: زمانی که hdrSupport فقط حاوی "off" باشد، پیش‌فرض {} خالی می‌شود. در غیر این صورت، تولیدکنندگان مقادیر پیش فرض را تعیین می کنند (به عنوان مثال، براکتینگ نوردهی خودکار).

این گزینه در سطح 2 API اصلاح شد.

 rw
exposureBracketSupport هدف - شی

تنظیمات براکت نوردهی در حال حاضر موجود است. مثلا:

{
    "autoMode": true,
    "shotsSupport": [1, 3, 5, 7],
    "incrementSupport": [0.33, 0.67, 1, 1.33, 1.67, 2]
}

سطح 1 API: اگر hdrSupport == false ، {} پیش‌فرض خالی شود. هنگامی که hdrSupport == true ، اما براکتینگ نوردهی خودکار پشتیبانی نمی‌شود، autoMode false خواهد بود.

سطح 2 API: اگر hdrSupport فقط حاوی "off" باشد، پیش‌فرض {} خالی می‌شود. وقتی hdrSupport دارای هر حالت HDR باشد، اما براکتینگ نوردهی خودکار پشتیبانی نمی‌شود، autoMode false خواهد بود.

این گزینه در سطح 2 API اصلاح شد.

 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 بولی اگر دوربین دارای ماژول GPS خاص خود باشد، این مقدار باید true باشد، در غیر این صورت 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 API اضافه شد.

 rw
previewFormatSupport آرایه شی

در حال حاضر پشتیبانی از فرمت های پیش نمایش زنده. مثلا:

[
    {
    "width": 640,
    "height": 320,
    "framerate": 24
    },
    ...
    {
    "width": 1280,
    "height": 720,
    "framerate": 24
    }
]

این گزینه در سطح 2 API اضافه شد.

 r
captureInterval عدد فاصله فعلی بین ثبت دو تصویر متوالی، در seconds .

این گزینه در سطح 2 API اضافه شد.

 rw
captureIntervalSupport هدف - شی

حداقل و حداکثر فواصل مجاز بین ثبت دو تصویر متوالی، در ثانیه. مثلا:

{
    "minInterval": 10,
    "maxInterval": 60
}
ممکن است بسته به fileFormat متفاوت باشد.

این گزینه در سطح 2 API اضافه شد.

 r
captureNumber عدد تعداد تصاویری که باید برای یک جلسه ثبت فاصله ای گرفته شود. پیش‌فرض 0 است، به این معنی که ضبط باید به صراحت با دستور stopCapture خاتمه یابد. در غیر این صورت، پس از گرفتن تصاویر از تعداد مشخص شده، ضبط به طور خودکار متوقف می شود. هنگامی که باتری دوربین تمام می شود یا زمانی که دوربین به طور عمدی خاموش می شود، می توان عکسبرداری را قطع کرد.

این گزینه در سطح 2 API اضافه شد.

 rw
captureNumberSupport هدف - شی

حداقل و حداکثر تعداد تصاویری که می توان در طول یک عکس برداری فاصله ای گرفت. مثلا:

{
    "minNumber": 2,
    "maxNumber": 50
}
ممکن است بسته به فضای ذخیره‌سازی باقی‌مانده تغییر کند.

این گزینه در سطح 2 API اضافه شد.

 r
remainingVideoSeconds عدد تعداد seconds تخمینی برای ویدیوی باقی‌مانده براساس تنظیمات ضبط فعلی.

این گزینه در سطح 2 API اضافه شد.

 r
pollingDelay عدد حداقل فاصله در ثانیه بین دو درخواست نظرسنجی وضعیت متوالی. مشتریان باید از این فیلد برای هدایت رفتار نظرسنجی وضعیت خود استفاده کنند. برای مثال، زمانی که در حال دوخت یک تصویر است، مشتریان ممکن است نیاز داشته باشند که به صورت دوره‌ای از دوربین نظرسنجی کنند تا ببینند آیا دوخت آن تمام شده است یا خیر. دوربین های مختلف پشتیبانی متفاوتی دارند. به عنوان مثال، برخی از دوربین‌ها می‌توانند هر یک ثانیه وضعیت را بررسی کنند، در حالی که برخی دیگر از فاصله زمانی طولانی‌تری پشتیبانی می‌کنند.

این گزینه در سطح 2 API اضافه شد.

 r
delayProcessing بولی True است زمانی که پردازش (مثلاً دوخت) اولویت کمتری نسبت به گرفتن دارد، یا به عبارت دیگر، قبل از پایان پردازش تصویر گرفته شده قبلی، گرفتن دیگری مجاز است. این بسیار توصیه می شود، به خصوص برای دوربین هایی که به زمان پردازش طولانی نیاز دارند.

این گزینه در سطح 2 API اضافه شد.

 rw
delayProcessingSupport آرایه بولی

[true] به این معنی است که پردازش (مثلاً دوخت) اولویت کمتری نسبت به ضبط دارد و همیشه به طور پیش‌فرض به تأخیر می‌افتد.

[false] به این معنی است که پردازش درست پس از گرفتن اتفاق می افتد.

[true, false] یعنی بین این دو حالت یک انتخاب وجود دارد.

این گزینه در سطح 2 API اضافه شد.

 r
clientVersion عدد

سطح API که مشتری تصمیم می گیرد از آن استفاده کند. اگر دوربین از هر دو سطح API 1 و 2 پشتیبانی می‌کند، پیش‌فرض 1 است تا کلاینت‌های نوشته شده برای سطح 1 API همچنان بدون هیچ تغییری با دوربین کار کنند. اگر دوربین فقط از سطح API 2 پشتیبانی می‌کند، پیش‌فرض 2 است، که قبل از انتقال کلاینت‌ها به سطح 2 API توصیه نمی‌شود. اگر دوربین فقط از سطح 2 API پشتیبانی می‌کند، درخواست برای تنظیم آن روی 1 باید با شکست مواجه شود. اگر clientVersion با موفقیت روی 2 تنظیم شود و یک فرمان منسوخ شده از سطح 1 API درخواست شود، درخواست باید با کد خطای knownCommand شکست بخورد.

این گزینه در سطح 2 API اضافه شده است.

 rw
photoStitchingSupport آرایه رشته ای

لیست گزینه های دوخت برای عکس ها. اگر عکس‌ها همیشه روی دوربین دوخته می‌شوند، [none] [ondevice] برگردانید، اگر دوربین نمی‌تواند عکس‌ها را [none,ondevice] اگر دوخت قابل تنظیم توسط کاربر است، [هیچ‌کدام، روی دستگاه] را برگردانید. پیشوند نام های تنظیمات خاص فروشنده را با یک زیرخط، به عنوان مثال _vendor-setting .

این گزینه در سطح API 2.1 اضافه شده است.

 r
photoStitching رشته

گزینه دوخت فعلی برای عکس‌ها، به عنوان مثال ondevice . اگر از آن پشتیبانی شود، ondevice روی دستگاه است.

این گزینه در سطح API 2.1 اضافه شده است.

 rw
videoStitchingSupport آرایه رشته ای

لیست گزینه های دوخت برای فیلم ها. اگر فیلم‌ها همیشه روی دوربین دوخته می‌شوند، [none] [ondevice] برگردانید، اگر دوربین نمی‌تواند ویدیوها [none,ondevice] اگر دوخت قابل تنظیم توسط کاربر است، [هیچ‌کدام] را برگردانید. پیشوند نام های تنظیمات خاص فروشنده را با یک زیرخط، به عنوان مثال _vendor-setting .

این گزینه در سطح API 2.1 اضافه شده است.

 r
videoStitching رشته

گزینه دوخت فعلی برای ویدیوها، به عنوان مثال ondevice . اگر از آن پشتیبانی شود، ondevice روی دستگاه است.

این گزینه در سطح API 2.1 اضافه شده است.

 rw
videoGPSSupport آرایه رشته ای

لیست گزینه های GPS در هنگام ضبط ویدیو. اگر دوربین می تواند به طور مداوم GPS را در حین فیلمبرداری بگیرد و مکان ها را در فیلم جاسازی کند، [continuous] را برگردانید. اگر نمی‌تواند [هیچ [none] را برگردانید و اگر پشتیبانی GPS ویدیویی قابل تنظیم توسط کاربر باشد [none,continuous] را برگردانید. پیشوند نام های تنظیمات خاص فروشنده را با یک زیرخط، به عنوان مثال _vendor-setting .

این گزینه در سطح API 2.1 اضافه شده است.

 r
videoGPS رشته

گزینه فعلی برای پشتیبانی از GPS در هنگام ضبط ویدیو، به عنوان مثال continuous . اگر پشتیبانی شود، پیش‌فرض به continuous می‌رسد.

این گزینه در سطح API 2.1 اضافه شده است.

 rw
_vendorSpecific [نوع] (اختیاری) گزینه های دوربین اضافی مخصوص فروشنده. پیشوند رشته های خاص فروشنده را با زیرخط ( _ ) قرار دهید.