אפשרויות

בטבלה הבאה מוצגות כל האפשרויות הזמינות להגדרה ולקבלה של camera.setOptions ו-camera.getOptions. אי אפשר לשנות אפשרות כשהתמיכה התואמת שלה ריקה או מכילה רק אפשרות אחת.

שם סוג תיאור קריאה/כתיבה
captureMode מחרוזת מצב הצילום הנוכחי. ברירת המחדל היא image. Rw
captureModeSupport מערך מחרוזות רשימת מצבי הצילום שזמינים כרגע. הדרישה המינימלית לרמת API 1 היא ["image"] והדרישה המינימלית לרמת API 2 היא ["image", "interval"]. "interval" מייצג את המצב של צילום סדרת תמונות במרווחי זמן מסוימים. הערכים האלה מופיעים גם ב-captureInterval וב-captureIntervalSupport. שני מצבים נוספים ("video" and "walkaround")נתמכים על ידי רמת API 2, כך שהמצב הנתמך המלא על ידי רמת API 2 הוא ["image", "interval", "video", "walkaround"], שבו "video" מייצג את מצב צילום הווידאו ו-"walkaround" מייצג את המצב של צילום שתי תמונות ברצף: הראשון שבו המשתמשים עומדים במקום כלשהו ביחס למצלמה והשני כשהמשתמשים עומדים בצד הנגדי (ביחס לנקודת העמידה הראשונה) של המצלמה. כך המצלמה יכולה להסיר את המשתמשים מהתמונה הסופית על ידי שילוב של שתי התמונות. כשהמצלמה תומכת ב-"walkaround" ומוגדרת למצב הצילום הנוכחי, הלקוח אמור לשלוח למצלמה שתי פקודות TakePicture שבהן התשובה של הפקודה הראשונה (כשהפקודה מסתיימת) מציינת שהמצלמה מוכנה לצילום התמונה השנייה, והפקודה השנייה אמורה להחזיר את התמונה הסופית כשהיא תסתיים.

כדי להוסיף עוד מצבי צילום שעדיין לא נתמכים, צריך להוסיף קו תחתון ( _ ) למצבים ספציפיים לספק.

האפשרות הזו שונתה ברמת API 2.

 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.

האפשרות הזו שונתה ברמת API 2.

 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.

האפשרות הזו שונתה ברמת API 2.

 r
aperture מספר הגדרת הצמצם הנוכחית, בעצירה f. 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, בערך 3,200 אלף
  • fluorescent, בערך 4,000 אלף
  • datalight, בערך 5,200 אלף
  • cloudy-daylight, בערך 6,000 אלף
  • shade, בערך 7,000 אלף
  • twilight, בערך 12,000 אלף
מוסיפים קו תחתון בתור שם של הגדרות ספציפיות לספק. לדוגמה: _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
}

האפשרות הזו שונתה ברמת API 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
    },
    ...
]
בקישור הבא אפשר לקבל מידע נוסף על כל הסוגים.

האפשרות הזו שונתה ברמת API 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. מגדירים באמצעות 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 level 1: בוליאני

רמת API 2: מחרוזת

רמת API 1: הפעלה/השבתה של מצב צילום HDR. הערך הוא true כדי להפעיל HDR, או false כדי להשבית אותו. ערך ברירת המחדל הוא false. ההגדרה יכולה להיות true רק אם hdrSupport הוא גם true.

API ברמה 2: מצב HDR נוכחי מסוג 'מחרוזת'.

האפשרות הזו שונתה ברמת API 2.

 Rw
hdrSupport

API level 1: בוליאני

רמת API 2: מערך מחרוזות

רמת API 1: הערך true מציין שהמצלמה תומכת ב-HDR. הגדרה של false מזהה מצלמה בלי HDR.

רמת API 2: אם אתם לא תומכים במצב HDR, [“off”]; אם יש תמיכה במצב HDR אחד, הערך שלו הוא [“off”, “hdr”]. אם יש תמיכה בכמה מצבי HDR (לפי אלגוריתמים שונים), הערך הוא [“off”, “hdr”, “hdr1”, “hdr2”, ...]

האפשרות הזו שונתה ברמת API 2.

 r
exposureBracket אובייקט ההגדרה הנוכחית של מסגרת החשיפה. זמין רק כאשר hdrSupport == true (רמת API 1) או hdrSupport מכילים מצב HDR אחד לפחות (רמת API 2). אם המצלמה משתמשת בחלוקה ידנית של גבולות חשיפה, האובייקט יכלול שתי רשומות:
  1. shots, מספר שלם שמכיל את מספר התמונות שיש לצלם.
  2. increment, מספר שמכיל מרווח של רכב חשמלי בין התמונות.
למשל: 
{
    "shots": 3,
    "increment": 1.33
}
אם המצלמה משתמשת בקביעת גבולות חשיפה אוטומטית, האובייקט יכלול: 
{
    "autoMode": true
}

רמת API 1: ברירת המחדל היא {} ריקה כאשר hdrSupport == false. היצרן קובע את ערכי ברירת המחדל (למשל, סוגריים מרובעים של חשיפה אוטומטית), כשהערך של hdr הוא true.

רמת API 2: ברירת המחדל היא {} ריקה כאשר hdrSupport מכיל רק "off". אם לא, היצרנים קובעים את ערכי ברירת המחדל (לדוגמה, הגדרת גבולות חשיפה אוטומטית).

האפשרות הזו שונתה ברמת API 2.

 Rw
exposureBracketSupport אובייקט

ההגדרות של גבולות החשיפה זמינות כרגע: לדוגמה:

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

רמת API 1: כברירת מחדל, הערך של {} הוא ריק אם hdrSupport == false. כשהערך הוא hdrSupport == true, אבל אין תמיכה בגבולות חשיפה אוטומטיים, הערך של autoMode יהיה false.

רמת API 2: ברירת המחדל של {} היא ריקה אם hdrSupport מכיל רק "off". אם יש ב-hdrSupport מצב HDR כלשהו, אבל אין תמיכה בפריים אוטומטי של החשיפה, הערך autoMode יהיה false.

האפשרות הזו שונתה ברמת API 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 החדש.
המצלמה חייבת לספק מנגנון איפוס למקרה שהסיסמה נשכחת. לדוגמה, לחצן איפוס לשחזור הסיסמה שהוגדרה כברירת המחדל להגדרות המקוריות.
 שבוע
previewFormat אובייקט

הרזולוציה הנוכחית של התצוגה המקדימה בזמן אמת; לדוגמה:

{
    "width": 640,
    "height": 320,
    "framerate": 24
}

האפשרות הזו נוספה ברמת API 2.

 Rw
previewFormatSupport מערך אובייקטים

פורמטים של תצוגה מקדימה בזמן אמת שנתמכים כרגע: לדוגמה:

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

האפשרות הזו נוספה ברמת API 2.

 r
captureInterval מספר המרווח הנוכחי בין צילום של שתי תמונות ברצף, seconds.

האפשרות הזו נוספה ברמת API 2.

 Rw
captureIntervalSupport אובייקט

פרקי זמן מינימליים ומקסימליים מותרים בין צילום של שתי תמונות ברצף, בשניות; לדוגמה:

{
    "minInterval": 10,
    "maxInterval": 60
}
הוא עשוי להשתנות בהתאם ל-fileFormat.

האפשרות הזו נוספה ברמת API 2.

 r
captureNumber מספר מספר התמונות שיצולמו במהלך סשן צילום אחד במרווחי זמן. ברירת המחדל היא 0, כלומר צריך להפסיק את הצילום באופן מפורש באמצעות הפקודה stopCapture. אחרת, הצילום ייפסק באופן אוטומטי אחרי שהוא יצלם תמונות של המספר שצוין. יכול להיות שהצילום יופסק גם כשהסוללה של המצלמה כבויה או כשהיא כבויה בכוונה.

האפשרות הזו נוספה ברמת API 2.

 Rw
captureNumberSupport אובייקט

המספר המינימלי והמקסימלי של תמונות שאפשר לצלם במהלך צילום במרווחי זמן; לדוגמה:

{
    "minNumber": 2,
    "maxNumber": 50
}
הוא עשוי להשתנות בהתאם לנפח האחסון שנותר.

האפשרות הזו נוספה ברמת API 2.

 r
remainingVideoSeconds מספר המספר המשוער של seconds לסרטון שנותר על סמך הגדרת הצילום הנוכחית.

האפשרות הזו נוספה ברמת API 2.

 r
pollingDelay מספר מרווח מינימלי בשניות בין שתי בקשות רצופות לסקרים סטטוס. הלקוחות צריכים להשתמש בשדה הזה כדי להנחות את אופן הפעולה שלהם בסקר הסטטוס. לדוגמה, כשיוצרים תפירה של תמונה, יכול להיות שהלקוחות יצטרכו לבדוק את המצלמה מדי פעם כדי לראות אם היא מסיימת ליצור את כל החיבורים. למצלמות שונות יש תמיכה שונה. לדוגמה, מצלמות מסוימות יכולות להתמודד עם תשאול של סטטוס כל שנייה, בעוד שמצלמות אחרות תומכות במרווחי זמן ארוכים יותר.

האפשרות הזו נוספה ברמת API 2.

 r
delayProcessing בוליאני True בזמן העיבוד (למשל: איחוד תמונות) מקבל עדיפות נמוכה יותר מזו של הצילום. במילים אחרות, אפשר לצלם שוב לפני סיום העיבוד של התמונה הקודמת שצולמה. מומלץ מאוד לעשות זאת, במיוחד במצלמות שדורשות זמן עיבוד ארוך.

האפשרות הזו נוספה ברמת API 2.

 Rw
delayProcessingSupport מערך בוליאני

המשמעות של [true] היא לעיבוד (למשל, איחוד תמונות) יש עדיפות נמוכה יותר מהצילום, והוא תמיד מתעכב כברירת מחדל.

המשמעות של [false] היא שהעיבוד מתבצע מיד אחרי הצילום.

המשמעות של [true, false] היא שיש אפשרות לבחור בין שני המצבים האלה.

האפשרות הזו נוספה ברמת API 2.

 r
clientVersion מספר

רמת ה-API שבה הלקוח מחליט להשתמש. ברירת המחדל היא 1 אם המצלמה תומכת גם ברמת API 1 וגם ברמה 2, כך שלקוחות שנכתבו עבור רמת API 1 עדיין פועלת עם המצלמה ללא שינוי. ברירת מחדל ל-2 אם המצלמה תומכת רק ברמת API 2, שאינה מומלץ לפני שהלקוחות עוברים לרמת API 2. אם המצלמה יש תמיכה רק ברמת API 2. הבקשה שמנסה להגדיר אותה ל-1 אמורה נכשל. אם הערך של clientVersion הוא 2 מתקבל בהצלחה נדרשת פקודה שהוצאה משימוש מרמת API 1, הבקשה אמור להיכשל עם קוד השגיאה unknownCommand.

האפשרות הזו נוספה ברמת API 2.

 Rw
photoStitchingSupport מערך מחרוזות

רשימה של אפשרויות לחיבור תמונות. חזרה לפעילות [ondevice] אם התמונות תמיד נתפורות במצלמה, [none] אם המצלמה לא יכולה לחבר תמונות, וגם [none,ondevice] אם המשתמש יכול ליצור את רצף החיבור. מוסיפים קו תחתון בתור שם של הגדרות ספציפיות לספק, למשל _vendor-setting

האפשרות הזו נוספה ברמת API 2.1.

 r
photoStitching מחרוזת

האפשרות הנוכחית לחיבור תמונות, למשל ondevice ברירת המחדל היא ondevice, אם היא נתמך.

האפשרות הזו נוספה ברמת API 2.1.

 Rw
videoStitchingSupport מערך מחרוזות

רשימה של אפשרויות לחיבור סרטונים. חזרה לפעילות [ondevice] אם סרטונים תמיד תפורים במצלמה, [none] אם המצלמה לא יכולה לחבר סרטונים, וגם [none,ondevice] אם המשתמש יכול ליצור את רצף החיבור. מוסיפים קו תחתון בתור שם של הגדרות ספציפיות לספק, למשל _vendor-setting

האפשרות הזו נוספה ברמת API 2.1.

 r
videoStitching מחרוזת

האפשרות הנוכחית לחיבור סרטונים, לדוגמה: ondevice ברירת המחדל היא ondevice, אם היא נתמך.

האפשרות הזו נוספה ברמת API 2.1.

 Rw
videoGPSSupport מערך מחרוזות

רשימה של אפשרויות GPS במהלך צילום סרטון. חזרה לפעילות [continuous] אם המצלמה יכולה לצלם GPS ברציפות במהלך צילום הסרטון ומטמיעים את המיקומים בסרטון. חזרה לפעילות [none] אם אי אפשר, ו-[none,continuous] אם התמיכה ב-GPS בווידאו ניתנת להגדרה. קידומת ספציפית לספק כשמגדירים שמות עם קו תחתון, למשל _vendor-setting

האפשרות הזו נוספה ברמת API 2.1.

 r
videoGPS מחרוזת

האפשרות הנוכחית עבור תמיכה ב-GPS במהלך צילום וידאו, לדוגמה continuous ברירת המחדל היא continuous, אם היא נתמך.

האפשרות הזו נוספה ברמת API 2.1.

 Rw
_vendorSpecific [type] (אופציונלי) אפשרויות מצלמה נוספות ספציפיות לספק מסוים. הוספת קידומת לספק ספציפי למחרוזות ספציפיות קו תחתון ( _ ).