אפשרויות

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

שם סוג תיאור קריאה/כתיבה
captureMode String מצב צילום מסך נוכחי. ברירת המחדל היא image. שורה
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" ומוגדרת כמצב הצילום הנוכחי, הלקוח אמור לצפות למצלמה שתי פקודות של PhotoPicture, כשהתגובה של הפקודה הראשונה (כשהיא מסתיימת) מציינת שהמצלמה מוכנה לצלם את התמונה השנייה, והפקודה השנייה צריכה להחזיר את התמונה הסופית כשהיא מסתיימת.

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

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

 r
captureStatus String סטטוס הצילום הנוכחי. ברירת המחדל היא "idle". זו שיטה שימושית שמאפשרת לקבוע את הסטטוס של המצלמה כשהיא מחוברת לאפליקציה. אם המצלמה נמצאת באמצע צילום סרטון, יכול להיות שיהיה צורך לעצור אותה לפני ביצוע פקודה אחרת, למשל: צילום סרטון נוסף.

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

 שורה
captureStatusSupport מערך מיתרים רשימה של סטטוסים זמינים כרגע של צילום. כברירת מחדל, היא צריכה להיות ["idle", "shooting"] אם צילום הווידאו נתמך. אפשר לספק גם פסלים אחרים, כמו "downloading".

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

 r
exposureProgram מספר תוכנית החשיפה הנוכחית. שורה
exposureProgramSupport מערך מספרים רשימת תוכניות החשיפה זמינה כרגע. לדוגמה, [0, 1, 2, 3, 4]. כל מספר שלם מייצג תוכנית חשיפה אחרת:
  • 0 = לא מוגדר
  • 1 = ידני
  • 2 = תוכנית רגילה
  • 3 = עדיפות לצמצם
  • 4 = עדיפות צמצם
יש ללחוץ על הקישור הבא כדי להוריד פרטים נוספים על ExposureProgram. 		r
iso מספר ההגדרה הנוכחית של מהירות ISO. שורה
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 מספר הגדרת מהירות התריס הנוכחית. שורה
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 מספר הגדרת הצמצם הנוכחית, בעצירות ביניים. שורה
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 String ההגדרה הנוכחית של היתרה הלבנה, לדוגמה, daylight. ברירת המחדל היא auto. שורה
whiteBalanceSupport מערך מיתרים כרגע יש רשימה של הגדרות יתרה לבנה שכוללת תת-קבוצה מתוך הרשימה שהוגדרה מראש:[ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"]. הערכים של כל אחד מהם:
  • incandescent, בערך 3200K
  • fluorescent, בערך 4,000 אלף
  • datalight, בערך 5200K
  • cloudy-daylight, בערך 6,000 אלף
  • shade, בערך 7,000 אלף
  • twilight, בערך 12,000 אלף
מוסיפים קו תחתון לשמות ספציפיים לספקים, עם קו תחתון. לדוגמה: _vendor-setting		 r
exposureCompensation מספר פיצוי חשיפה נוכחי. שורה
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.

 שורה
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 לבין התחלת החשיפה בשניות. שורה
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 עדכניים. הגדרה של 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 לא חוקי.		 שורה
dateTimeZone String התאריך והשעה הנוכחיים. המדיניות הוגדרה על ידי setOptions באמצעות התאריך, השעה ואזור הזמן של הטלפון. הפורמט הוא YYYY:MM:DD HH:MM:SS+(-)HH:MM. פורמט השעה הוא 24 שעות, התאריך והשעה מופרדים במרחב ריק. אזור הזמן מקוזז משעון UTC. לדוגמה: 2014:05:18 01:04:29+8:00 הוא אזור הזמן של סין (UTC+8:00) שורה
hdr

רמת API 1: בוליאני

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

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

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

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

 שורה
hdrSupport

רמת API 1: בוליאני

רמת 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
}

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

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

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

 שורה
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.

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

 r
gyro בוליאני יש להגדיר את הערך true כדי להפעיל את מודול הג'ירוסקופ של המצלמה, או את הערך false כדי להשבית את התכונה. ערך ברירת המחדל הוא true, אם המצלמה תומכת באפשרות הזו, אחרת false. ההגדרה הזו יכולה להיות true רק כאשר gyroSupport == true. שורה
gyroSupport בוליאני אם יש לג'ירוסקופ במצלמה ערך זה צריך להיות true, אחרת false. r
gps בוליאני הפעלה/השבתה של מודול ה-GPS של המצלמה. כדי להשבית, הערך צריך להיות true או false כדי להשבית אותו. ערך ברירת המחדל הוא true אם המצלמה תומכת בו, אחרת false. ההגדרה היא true רק כאשר gpsSupport == true. שורה
gpsSupport בוליאני הערך הזה צריך להיות true אם למצלמה יש מודול GPS משלה, אחרת הוא false. r
imageStabilization String פעולה ייצוב תמונה נוכחית. לדוגמה, off. שורה
imageStabilizationSupport מערך מיתרים כרגע יש אפשרויות לייצוב תמונות. הרשימה שהוגדרה מראש היא ["off", "on"]. אם המצלמה לא תומכת בייצוב תמונה, יש להחזיר את ["off"]. אחרת, ניתן להחזיר את ["off", "on"]. מוסיפים קווים ספציפיים לספקים עם קו תחתון ( _ ). לדוגמה: [ "off", "_horizontal_stabilization", "_vibration_correction" ]. r
wifiPassword String
באורך של 8 תווים לפחות, המכיל אותיות, מספרים, סמלים, אבל לא רווחים. ניתן לשנות אותה רק כשהמצלמה מחוברת למכשיר לקוח. אחרי שמשנים את המצלמה, המצלמה צריכה להתנתק כדי שהמשתמש יצטרך להתחבר מחדש באמצעות הגרסה החדשה של wifiPassword.
המצלמה צריכה לספק מנגנון איפוס במקרה שהסיסמה נשכחה. לדוגמה, לחצן איפוס כדי לשחזר את סיסמת ברירת המחדל של היצרן.
 w
previewFormat התנגדות

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

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

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

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

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

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

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

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

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

 שורה
captureIntervalSupport התנגדות

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

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

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

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

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

 שורה
captureNumberSupport התנגדות

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

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

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

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

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

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

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

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

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

 שורה
delayProcessingSupport מערך בוליאני

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

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

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

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

 r
clientVersion מספר

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

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

 שורה
photoStitchingSupport מערך מיתרים

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

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

 r
photoStitching String

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

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

 שורה
videoStitchingSupport מערך מיתרים

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

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

 r
videoStitching String

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

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

 שורה
videoGPSSupport מערך מיתרים

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

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

 r
videoGPS String

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

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

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