Tuỳ chọn

Bảng sau đây trình bày tất cả các lựa chọn có thể đặt và nhận theo camera.setOptions và camera.getOptions. Bạn không thể thay đổi một lựa chọn khi chế độ hỗ trợ tương ứng của lựa chọn đó trống hoặc chỉ chứa một lựa chọn.

Tên Loại Mô tả Đọc/Ghi
captureMode Chuỗi Chế độ chụp hiện tại. Mặc định là image. rw
captureModeSupport Mảng chuỗi Danh sách các chế độ chụp hiện có. Yêu cầu tối thiểu đối với API cấp 1 là ["image"] và yêu cầu tối thiểu đối với API cấp 2 là ["image", "interval"], trong đó "interval" thể hiện chế độ chụp một loạt ảnh cách nhau một khoảng thời gian nhất định, vui lòng xem thêm captureInterval và captureIntervalSupport. Hai chế độ bổ sung ("video" and "walkaround")được API cấp 2 hỗ trợ, vì vậy API cấp 2 hỗ trợ đầy đủ là ["image", "interval", "video", "walkaround"], trong đó "video" đại diện cho chế độ quay video và "walkaround" đại diện cho chế độ chụp 2 ảnh theo thứ tự, chế độ thứ nhất với người dùng đứng ở bất kỳ đâu so với máy ảnh và chế độ thứ hai với người dùng đứng ở phía đối diện (so với điểm đứng đầu tiên) của máy ảnh. Thao tác này cho phép máy ảnh xoá người dùng khỏi hình ảnh cuối cùng bằng cách kết hợp hai hình ảnh đó. Khi "walkaround" được máy ảnh hỗ trợ và được đặt thành chế độ chụp hiện tại, ứng dụng sẽ gửi hai lệnh Takepicture tới máy ảnh, trong đó phản hồi của lệnh đầu tiên (khi kết thúc) cho biết máy ảnh đã sẵn sàng chụp ảnh thứ hai, trong khi lệnh thứ hai sẽ trả về hình ảnh cuối cùng khi hoàn tất.

Để thêm các chế độ chụp khác chưa được hỗ trợ, vui lòng thêm dấu gạch dưới ( _) vào tiền tố của chế độ của nhà cung cấp cụ thể.

Tuỳ chọn này đã được sửa đổi trong API cấp 2.

 r
captureStatus Chuỗi Trạng thái chụp hiện tại. Giá trị mặc định là "idle". Mã này rất hữu ích khi xác định trạng thái của camera trong lần đầu tiên kết nối với một ứng dụng. Nếu camera đang trong quá trình quay video, có thể cần dừng lại trước khi được lệnh để làm những việc khác, chẳng hạn như lại một video quay nữa.

Tuỳ chọn này đã được thêm vào API cấp độ 2.1.

 rw
captureStatusSupport Mảng chuỗi Danh sách các trạng thái chụp hiện có; Theo mặc định, giá trị này phải là ["idle", "shooting"] nếu có hỗ trợ tính năng quay video. Bạn cũng có thể cung cấp các bức tượng khác, ví dụ: "downloading".

Tuỳ chọn này đã được thêm vào API cấp độ 2.1.

 r
exposureProgram Số Chương trình tiếp xúc hiện tại. rw
exposureProgramSupport Mảng số Danh sách các chương trình tiếp xúc hiện có; ví dụ: [0, 1, 2, 3, 4]. Mỗi số nguyên đại diện cho một chương trình tiếp xúc với quảng cáo:
  • 0 = Không xác định
  • 1 = Thủ công
  • 2 = Chương trình thông thường
  • 3 = Ưu tiên khẩu độ
  • 4 = Mức độ ưu tiên màn trập
Chọn đường liên kết sau để tải thêm thông tin chi tiết về ExposureProgram. 		r
iso Số Chế độ cài đặt tốc độ ISO hiện tại. rw
isoSupport Mảng số

API cấp 1: Danh sách các chế độ cài đặt ISO hiện có; ví dụ: [100, 200, 400, 800,1600] hoặc [] khi ở chế độ auto.

API cấp 2: Danh sách các chế độ cài đặt ISO hiện có; ví dụ: [0, 100, 200, 400, 800, 1600], trong đó 0 đại diện cho chế độ auto.

Tuỳ chọn này đã được sửa đổi trong API cấp 2.

 r
shutterSpeed Số Chế độ cài đặt tốc độ màn trập hiện tại. rw
shutterSpeedSupport Mảng số

API cấp 1: Danh sách tốc độ màn trập hiện có; ví dụ: [0.067, 0.033, 0.017,0.008] hoặc [] khi ở chế độ auto.

API cấp 2: Danh sách tốc độ màn trập hiện có; ví dụ: [0, 0.067, 0.033, 0.017, 0.008], trong đó 0 đại diện cho chế độ auto.

Tuỳ chọn này đã được sửa đổi trong API cấp 2.

 r
aperture Số Chế độ cài đặt khẩu độ hiện tại, tính bằng số điểm dừng. rw
apertureSupport Mảng số

API cấp 1: Danh sách các chế độ cài đặt khẩu độ hiện có, được biểu thị bằng f/number; với ví dụ: [1.4, 2, 2.8, 4, 5.6, 8, 11] hoặc [] khi ở chế độ auto.

API cấp 2: Danh sách các chế độ cài đặt khẩu độ hiện có, được biểu thị bằng f/number; ví dụ: [0, 1.4, 2, 2.8, 4, 5.6, 8, 11], trong đó 0 đại diện cho chế độ auto.

 r
whiteBalance Chuỗi Chế độ cài đặt cân bằng trắng hiện tại; ví dụ: daylight. Giá trị mặc định là auto. rw
whiteBalanceSupport Mảng chuỗi Danh sách các chế độ cài đặt cân bằng trắng hiện có sẵn có thể là một phần trong danh sách được xác định sẵn:[ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"]. Giá trị cho mỗi loại:
  • incandescent, khoảng 3200 nghìn
  • fluorescent, khoảng 4000 nghìn
  • datalight, khoảng 5200 nghìn
  • cloudy-daylight, khoảng 6000 nghìn
  • shade, khoảng 7000 nghìn
  • twilight, khoảng 12000 nghìn
Đặt dấu gạch dưới vào tên chế độ cài đặt của từng nhà cung cấp; ví dụ: _vendor-setting		 r
exposureCompensation Số Bù phơi sáng hiện tại. rw
exposureCompensationSupport Mảng số Danh sách các bù phơi sáng hiện có, thường ở bước 0.33 hoặc 0,5; ví dụ: [-1, -0.67, -0.33, 0, 0.33, 0.67, 1] r
fileFormat Đối tượng

Loại tệp và độ phân giải hiện tại. Định dạng phải phản ánh giá trị hiện tại của captureMode. Ví dụ: nếu captureMode là image, câu trả lời thích hợp có thể là:

{
    "type": "jpeg",
    "width": 2000,
    "height": 1000
}
Nếu captureMode là video, phản hồi thích hợp có thể là: 
{
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 30
}

Tuỳ chọn này đã được sửa đổi trong API cấp 2.

 rw
fileFormatSupport Mảng đối tượng

Danh sách các định dạng tệp hiện có sẵn; ví dụ:

[
    {
    "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
    },
    ...
]
Chọn đường liên kết sau để biết thêm thông tin về tất cả các loại.

Tuỳ chọn này đã được sửa đổi trong API cấp 2.

 r
exposureDelay Số Độ trễ hiện tại giữa lệnh takePicture và khi bắt đầu phơi sáng, tính bằng giây. rw
exposureDelaySupport Mảng số Danh sách thông tin về độ trễ phơi nhiễm hiện có, tính bằng giây; ví dụ: [0, 1, 2, 5, 10, 30, 60] r
sleepDelay Số Độ trễ hiện tại trước khi máy ảnh chuyển sang chế độ ngủ, tính bằng giây. rw
sleepDelaySupport Mảng số Danh sách các độ trễ giấc ngủ hiện có, tính bằng giây; ví dụ: [30, 60, 120, 300, 600, 1800, 65535], trong đó 65535 tắt chế độ ngủ (máy ảnh sẽ không ngủ cho đến khi tắt nguồn) và phải được hỗ trợ. r
offDelay Số Độ trễ hiện tại (tính bằng giây) trước khi máy ảnh tắt nguồn. rw
offDelaySupport Mảng số Danh sách thời gian trì hoãn tắt nguồn hiện có, tính bằng giây; ví dụ: [1800, 3600, 7200, 65535], trong đó 65535 tắt chế độ tắt nguồn (máy ảnh không tắt nguồn cho đến khi pin hết hoặc tắt theo cách thủ công) và phải được hỗ trợ. r
totalSpace Số Chỉ đọc: Số byte của tổng bộ nhớ. r
remainingSpace Số Chỉ đọc: Số byte của bộ nhớ miễn phí. r
remainingPictures Số Chỉ đọc: Số lượng ảnh còn lại ước tính dựa trên ảnh chụp hiện tại cài đặt. r
gpsInfo Đối tượng

Thông tin GPS hiện tại. Đặt bằng setOptions bằng GPS của điện thoại:

{
    "lat": 23.532,
    "lng": -132.35
}
Các thuộc tính lat và lng là độ thập phân, với lat trong dải ô, [-90, 90] và lng trong dải ô, [-180, 180]. Khi được điện thoại cung cấp, xin lưu ý rằng mỗi vị trí GPS chỉ hợp lệ cho đến lần cập nhật tiếp theo từ điện thoại. Điện thoại phải xác định thời điểm cập nhật vị trí GPS; chẳng hạn như ngay trước mỗi lệnh takePicture. 65535 thông báo cho camera rằng vị trí GPS hiện tại là không hợp lệ và camera nên bỏ qua nó và sử dụng GPS riêng nếu có; ví dụ: setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) có nghĩa là vị trí GPS là không hợp lệ.		 rw
dateTimeZone Chuỗi Thông tin về ngày và giờ hiện tại. Do setOptions đặt bằng ngày, giờ và múi giờ trên điện thoại. Định dạng là YYYY:MM:DD HH:MM:SS+(-)HH:MM. Thời gian ở định dạng 24 giờ, ngày và giờ được phân tách bằng một dấu cách, múi giờ và múi giờ là một số chênh lệch so với giờ UTC; ví dụ: 2014:05:18 01:04:29+8:00 là Múi giờ Trung Quốc (UTC+8:00) rw
hdr

API cấp 1: Boolean

API cấp 2: Chuỗi

API cấp 1: Bật/tắt chế độ chụp HDR. Giá trị là true để bật HDR hoặc false để tắt. Giá trị mặc định là false. Chế độ cài đặt chỉ có thể là true khi hdrSupport cũng là true.

API cấp 2: Chế độ HDR hiện tại của loại Chuỗi.

Tuỳ chọn này đã được sửa đổi trong API cấp 2.

 rw
hdrSupport

API cấp 1: Boolean

API cấp 2: Mảng chuỗi

API cấp 1: Giá trị true cho biết máy ảnh hỗ trợ HDR. Chế độ cài đặt false xác định một camera không có HDR.

API cấp 2: Nếu bạn không hỗ trợ chế độ HDR thì [“off”]; nếu bạn hỗ trợ một chế độ HDR, chế độ đó là [“off”, “hdr”], nếu nhiều chế độ HDR (dựa trên thuật toán khác nhau) thì chế độ đó là [“off”, “hdr”, “hdr1”, “hdr2”, ...]

Tuỳ chọn này đã được sửa đổi trong API cấp 2.

 r
exposureBracket Đối tượng Chế độ cài đặt khung phơi sáng hiện tại. Chỉ dùng được khi hdrSupport == true (API cấp 1) hoặc hdrSupport chứa ít nhất một chế độ HDR (API cấp 2). Nếu máy ảnh sử dụng chế độ phơi sáng thủ công, thì đối tượng sẽ chứa 2 mục:
  1. shots, một số nguyên chứa số lần chụp.
  2. increment, một số có chứa mức tăng xe điện giữa các lần chụp.
Ví dụ: 
{
    "shots": 3,
    "increment": 1.33
}
Nếu máy ảnh sử dụng tính năng tự động lấy nét phơi sáng, thì đối tượng sẽ chứa: 
{
    "autoMode": true
}

API cấp 1: Mặc định là trống {} khi hdrSupport == false. Các nhà sản xuất sẽ quyết định các giá trị mặc định (ví dụ: tự động phơi sáng) khi hdr là true.

API cấp 2: Mặc định là trống {} khi hdrSupport chỉ chứa "off". Nếu không, nhà sản xuất sẽ quyết định các giá trị mặc định (ví dụ: tự động phơi sáng).

Tuỳ chọn này đã được sửa đổi trong API cấp 2.

 rw
exposureBracketSupport Đối tượng

Hiện đã có chế độ cài đặt khung phơi sáng; ví dụ:

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

API cấp 1: Mặc định là trống {} nếu hdrSupport == false. Khi hdrSupport == true nhưng không hỗ trợ tính năng tự động lấy nét phơi sáng thì autoMode sẽ là false.

API cấp 2: Mặc định là {} trống nếu hdrSupport chỉ chứa "off". Khi hdrSupport chứa chế độ HDR bất kỳ nhưng tính năng tự động phơi sáng không được hỗ trợ, thì autoMode sẽ là false.

Tuỳ chọn này đã được sửa đổi trong API cấp 2.

 r
gyro Boolean Đặt thành true để bật mô-đun con quay hồi chuyển của máy ảnh hoặc false để tắt tính năng này. Giá trị mặc định là true nếu máy ảnh hỗ trợ, nếu không thì là false. Chế độ cài đặt này chỉ có thể là true khi gyroSupport == true. rw
gyroSupport Boolean Nếu máy ảnh có con quay hồi chuyển, giá trị này phải là true, nếu không, giá trị này phải là false. r
gps Boolean Bật/tắt mô-đun GPS của máy ảnh. Giá trị phải là true để bật hoặc false để tắt. Giá trị mặc định là true nếu máy ảnh hỗ trợ, nếu không thì là false. Chế độ cài đặt chỉ là true khi gpsSupport == true. rw
gpsSupport Boolean Giá trị này phải là true nếu máy ảnh có mô-đun GPS riêng, nếu không thì false. r
imageStabilization Chuỗi Hoạt động ổn định hình ảnh hiện tại; ví dụ: off. rw
imageStabilizationSupport Mảng chuỗi Các chế độ ổn định hình ảnh hiện có sẵn. Danh sách được xác định trước là ["off", "on"].Nếu máy ảnh không hỗ trợ tính năng ổn định hình ảnh, hãy trả về ["off"], nếu không, hãy trả về ["off", "on"]. Thêm tiền tố vào các chuỗi dành riêng cho nhà cung cấp bằng dấu gạch dưới ( _ ); ví dụ: [ "off", "_horizontal_stabilization", "_vibration_correction" ]. r
wifiPassword Chuỗi
Dài ít nhất 8 ký tự, có chứa chữ cái, số, ký hiệu, nhưng không có dấu cách. Bạn chỉ có thể thay đổi chế độ cài đặt này khi máy ảnh được kết nối với một thiết bị khách. Sau khi thay đổi, camera phải ngắt kết nối để người dùng phải kết nối lại bằng wifiPassword mới.
Camera phải cung cấp cơ chế đặt lại trong trường hợp bạn quên mật khẩu; ví dụ: nút đặt lại để khôi phục mật khẩu mặc định về trạng thái ban đầu.
 tuần
previewFormat Đối tượng

Độ phân giải của bản xem trước trực tiếp hiện tại; ví dụ:

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

Tuỳ chọn này đã được thêm vào API cấp 2.

 rw
previewFormatSupport Mảng đối tượng

Các định dạng xem trước trực tiếp hiện được hỗ trợ; ví dụ:

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

Tuỳ chọn này đã được thêm vào API cấp 2.

 r
captureInterval Số Khoảng thời gian hiện tại giữa thời điểm chụp 2 ảnh liên tiếp, trong seconds.

Tuỳ chọn này đã được thêm vào API cấp 2.

 rw
captureIntervalSupport Đối tượng

Khoảng thời gian tối thiểu và tối đa được phép giữa hai lần chụp liên tiếp (tính bằng giây); ví dụ:

{
    "minInterval": 10,
    "maxInterval": 60
}
Số liệu này có thể thay đổi tuỳ thuộc vào fileFormat.

Tuỳ chọn này đã được thêm vào API cấp 2.

 r
captureNumber Số Số ảnh cần chụp cho một phiên chụp ngắt quãng. Mặc định là 0, nghĩa là quá trình chụp cần được kết thúc rõ ràng bằng lệnh stopCapture; nếu không, quá trình chụp sẽ tự động dừng sau khi chụp ảnh của số điện thoại được chỉ định. Quá trình quay cũng có thể bị gián đoạn khi máy ảnh hết pin hoặc khi máy ảnh bị tắt một cách có chủ ý.

Tuỳ chọn này đã được thêm vào API cấp 2.

 rw
captureNumberSupport Đối tượng

Số lượng ảnh tối thiểu và tối đa có thể chụp trong một lần chụp ngắt quãng; ví dụ:

{
    "minNumber": 2,
    "maxNumber": 50
}
Mức dung lượng này có thể thay đổi tuỳ thuộc vào dung lượng lưu trữ còn lại.

Tuỳ chọn này đã được thêm vào API cấp 2.

 r
remainingVideoSeconds Số Số lượng seconds ước tính cho video còn lại dựa trên chế độ cài đặt quay video hiện tại.

Tuỳ chọn này đã được thêm vào API cấp 2.

 r
pollingDelay Số Khoảng thời gian tối thiểu tính bằng giây giữa hai yêu cầu thăm dò trạng thái liên tiếp. Ứng dụng nên sử dụng trường này để định hướng hoạt động thăm dò trạng thái; ví dụ: khi đang ghép một hình ảnh, khách hàng có thể cần thăm dò camera theo định kỳ để xem đã ghép xong chưa. Các máy ảnh khác nhau có sự hỗ trợ khác nhau; ví dụ: một số camera có thể xử lý việc thăm dò trạng thái mỗi giây một lần trong khi một số khác hỗ trợ khoảng thời gian dài hơn.

Tuỳ chọn này đã được thêm vào API cấp 2.

 r
delayProcessing Boolean True khi xử lý (ví dụ: ghép) có mức độ ưu tiên thấp hơn so với chụp ảnh, hay nói cách khác là được phép chụp một lần nữa trước khi quá trình xử lý ảnh đã chụp trước đó hoàn tất. Bạn nên làm việc này, đặc biệt là đối với các camera cần thời gian xử lý dài.

Tuỳ chọn này đã được thêm vào API cấp 2.

 rw
delayProcessingSupport Mảng boolean

[true] có nghĩa là quá trình xử lý (ví dụ: ghép) có mức độ ưu tiên thấp hơn chụp và luôn bị trễ theo mặc định.

[false] có nghĩa là quá trình xử lý diễn ra ngay sau khi chụp.

[true, false] có nghĩa là bạn có thể chọn giữa hai chế độ này.

Tuỳ chọn này đã được thêm vào API cấp 2.

 r
clientVersion Số

Cấp độ API mà ứng dụng quyết định sử dụng. Mặc định là 1 nếu camera hỗ trợ cả API cấp 1 và 2 để các ứng dụng được viết cho API cấp 1 vẫn hoạt động với máy ảnh mà không có bất kỳ thay đổi nào; mặc định thành 2 nếu máy ảnh chỉ hỗ trợ API cấp 2, tức là không được đề xuất trước khi khách hàng chuyển sang API cấp 2. Nếu camera chỉ hỗ trợ API cấp 2, yêu cầu cố gắng đặt thành 1 phải không thành công. Nếu bạn đặt clientVersion thành 2 và không dùng lệnh từ API cấp 1 nữa thì yêu cầu đó sẽ không thành công với mã lỗi unknownCommand.

Tuỳ chọn này đã được thêm vào API cấp 2.

 rw
photoStitchingSupport Mảng chuỗi

Danh sách lựa chọn ghép ảnh. Quay lại [ondevice] nếu ảnh luôn được ghép trên máy ảnh, [none] nếu máy ảnh không thể ghép ảnh và [none,ondevice] nếu người dùng có thể định cấu hình tính năng ghép. Thêm dấu gạch dưới vào tên chế độ cài đặt của từng nhà cung cấp, ví dụ: _vendor-setting.

Tuỳ chọn này đã được thêm vào API cấp độ 2.1.

 r
photoStitching Chuỗi

Tùy chọn ghép ảnh hiện tại cho ảnh, ví dụ: ondevice. Giá trị mặc định là ondevice nếu là được hỗ trợ.

Tuỳ chọn này đã được thêm vào API cấp độ 2.1.

 rw
videoStitchingSupport Mảng chuỗi

Danh sách cách ghép cho video. Quay lại [ondevice] nếu video luôn được ghép trên camera, [none] nếu máy ảnh không thể ghép video và [none,ondevice] nếu người dùng có thể định cấu hình tính năng ghép. Thêm dấu gạch dưới vào tên chế độ cài đặt của từng nhà cung cấp, ví dụ: _vendor-setting.

Tuỳ chọn này đã được thêm vào API cấp độ 2.1.

 r
videoStitching Chuỗi

Lựa chọn ghép ảnh hiện tại cho video, ví dụ: ondevice. Giá trị mặc định là ondevice nếu là được hỗ trợ.

Tuỳ chọn này đã được thêm vào API cấp độ 2.1.

 rw
videoGPSSupport Mảng chuỗi

Danh sách tuỳ chọn GPS trong khi quay video. Quay lại [continuous] nếu máy ảnh có thể liên tục chụp GPS trong khi quay video và nhúng các vị trí trong video. Quay lại [none] nếu không thể và [none,continuous] nếu người dùng có thể định cấu hình hỗ trợ GPS của video. Thêm tiền tố theo nhà cung cấp đặt tên bằng dấu gạch dưới, ví dụ: _vendor-setting.

Tuỳ chọn này đã được thêm vào API cấp độ 2.1.

 r
videoGPS Chuỗi

Tuỳ chọn hiện tại để hỗ trợ GPS trong khi quay video, ví dụ: continuous. Giá trị mặc định là continuous nếu là được hỗ trợ.

Tuỳ chọn này đã được thêm vào API cấp độ 2.1.

 rw
_vendorSpecific [loại] (không bắt buộc) Các lựa chọn camera bổ sung dành riêng cho nhà cung cấp. Thêm tiền tố vào các chuỗi dành riêng cho nhà cung cấp bằng dấu gạch dưới ( _ ).