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

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

שגיאות

  • missingParameter: sessionId חסר. קוד השגיאה הזה הוצא משימוש ברמת API 2.
  • legalParameterName: שם הפרמטר לא מזוהה, למשל sessionId לא מזוהה ברמת API 2.
  • invalidParameterValue: השם של פרמטר הקלט מזוהה, אבל הערך שלו לא חוקי. לדוגמה, sessionId לא קיים, לא פעיל יותר או שסוג הנתונים שגוי. קוד השגיאה הזה הוצא משימוש ברמת API 2.
  • DisableCommand: הפקודה מושבתת כרגע. לדוגמה, המצלמה נמצאת במצב צילום וידאו. קוד השגיאה הזה התווסף ברמת 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."
    }
}