camera.takePicture

Chụp ảnh hình cầu toàn cảnh, lưu toạ độ vĩ độ/kinh độ đối với EXIF (nếu máy ảnh của bạn có GPS hoặc GPS riêng được bật khi được kết nối điện thoại di động). Gọi cho camera.setOptions trước lệnh gọi lệnh này nếu cần. Lệnh này đã được sửa đổi trong API cấp 2.

Tham số

  • sessionId: Giá trị nhận dạng phiên duy nhất thu được từ camera.startSession . Trường này không còn được dùng trong API cấp 2.

Kết quả

  • API cấp 1
    • fileUri: URI của hình ảnh được chụp. Nhà sản xuất quyết định xem nên sử dụng URI tuyệt đối hay tương đối; ví dụ: "http://android.com/robots.txt" là URI tuyệt đối trong khi "robots.txt" là một URI tương đối. Khách hàng có thể xử lý đây là giá trị nhận dạng không rõ ràng.
  • API cấp 2
    • fileUrl: URL tuyệt đối của hình ảnh đã chụp, mà có thể được dùng để tải xuống trực tiếp từ máy chủ HTTP của camera. Năn nỉ Xin lưu ý rằng lệnh này không trả về fileUrl ngay lập tức vì chụp (bao gồm ghép ảnh trong máy ảnh) thường mất một khoảng thời gian (khác nhau từ giây đến phút) để hoàn tất. Tiến trình của lệnh được lấy bằng thăm dò camera định kỳ bằng cách sử dụng API /osc/commands/status và fileUrl là kết quả được trả về khi lệnh kết thúc. Thời gian delayProcessing là đúng, đây là URL tuyệt đối của bản xem trước hình ảnh, có thể được dùng làm dữ liệu đầu vào trong quá trình Hình ảnh để xử lý hình ảnh, nếu không, đó là URL tuyệt đối của hình ảnh được xử lý cuối cùng.

Lỗi

  • missingTham số: Thiếu sessionId. Mã lỗi này không còn được dùng trong API cấp 2.
  • không hợp lệ Tham số: Tên thông số không được nhận dạng, ví dụ: sessionId không nhận dạng được trong API cấp 2.
  • invalidParameterValue: Tên thông số đầu vào được công nhận, nhưng giá trị của thuộc tính này không hợp lệ; ví dụ: sessionId không tồn tại, không còn hoạt động hoặc loại dữ liệu của tài khoản không chính xác. Mã lỗi này không còn được dùng trong API cấp 2.
  • disabledCommand: Lệnh hiện đang tắt; ví dụ: máy ảnh đang ở chế độ quay video. Mã lỗi này đã được thêm vào API cấp 2.

Lệnh I/O
Đầu vào lệnh (API cấp 1) 
{
    "parameters": {
        "sessionId": "12ABC3"
    }
}
Đầu ra lệnh (API cấp 1) 
{
    "results": {
        "fileUri": "file URI"
    }
}
Kết quả lệnh (Lỗi) (API cấp 1) 
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter sessionId doesn't exist."
    }
}
Đầu vào lệnh (API cấp 2) 
none
Đầu ra lệnh (API cấp 2) 
{
    "results": {
        "fileUrl": "Absolute file URL"
    }
}
Kết quả lệnh (Lỗi) (API cấp 2) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}