מצלמה.צילום תמונה

צילום תמונה מלבנית, תוך שמירת קואורדינטות של קווי אורך ורוחב ל-EXIF (אם במצלמה יש GPS או GPS משלה מופעל בזמן חיבור בטלפונים ניידים). חיוג למספר camera.setOptions לפני הפעלת הפקודה הזו, אם יש צורך. הפקודה הזו שונתה ברמת API 2.

פרמטרים

  • sessionId: מזהה סשן ייחודי שהתקבל מ הפקודה camera.startSession . השדה הזה הוצא משימוש ברמת API 2.

תוצאות

  • רמת API 1
    • fileUri: ה-URI של התמונה שצולמה. יצרנים להחליט אם להשתמש ב-URI מוחלטים או יחסיים; לדוגמה, "http://android.com/robots.txt" היא URI מוחלט בזמן robots.txt הוא URI יחסי. לקוחות יכולים לטפל בתור מזהה אטום.
  • רמת API 2
    • fileUrl: כתובת ה-URL האבסולוטית של התמונה שצולמה, שיכולה משמש כדי להוריד אותו ישירות משרת ה-HTTP של המצלמה. נשמח אם תוכלו לסמן בכוכב שימו לב שהפקודה הזו לא מחזירה את הערך fileUrl מיד כי צילום מסך (כולל חיבור במצלמה) בדרך כלל נמשך זמן מה (משתנה שניות עד דקות) כדי להשלים את התהליך. התקדמות הפקודה מתקבלת לדגום את המצלמה מדי פעם באמצעות ממשק ה-API של /osc/commands/status fileUrl הוא התוצאה שמוחזרת כשהפקודה מסתיימת. מתי delayProcessing נכון, זו כתובת ה-URL המוחלטת של התצוגה המקדימה תמונה, שיכול לשמש כקלט ב-ProcessPicture כדי לעבד את התמונה, אחרת, מדובר בכתובת ה-URL המוחלטת של התמונה הסופית שעברה עיבוד.

שגיאות

  • missingParameter: sessionId חסר. קוד השגיאה הזה הוצא משימוש ברמת API 2.
  • INVALIDParameterName: שם הפרמטר לא מזוהה, למשל sessionId לא מזוהה ברמת API 2.
  • invalidParameterValue: השם של פרמטר הקלט מזוהה, אבל הערך שלו לא חוקי. לדוגמה, sessionId לא קיים, כבר לא פעיל, או שסוג הנתונים שלו שגוי. קוד השגיאה הזה הוצא משימוש ברמת API 2.
  • DisabledCommand: הפקודה מושבתת כרגע. לדוגמה, המצלמה נמצאת במצב צילום וידאו. קוד השגיאה הזה נוסף ברמת API 2.

Command I/O
קלט פקודה (רמת API 1) 
{
    "parameters": {
        "sessionId": "12ABC3"
    }
}
פלט הפקודה (רמת API 1) 
{
    "results": {
        "fileUri": "file URI"
    }
}
פלט הפקודה (שגיאה) (רמת API 1) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter sessionId doesn't exist."
    }
}
קלט פקודה (רמת API 2) 
none
פלט הפקודה (API ברמה 2) 
{
    "results": {
        "fileUrl": "Absolute file URL"
    }
}
פלט הפקודה (שגיאה) (רמת API 2) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}