Tùy chọn

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

Tên Loại Nội dung mô tả Đọc/Ghi
captureMode Chuỗi Chế độ chụp hiện tại. Mặc định là image.. Rr
captureModeSupport Mảng chuỗi Danh sách 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" đại diện cho chế độ chụp một loạt hình ảnh được sắp xếp cách nhau trong 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, chế độ hỗ trợ hoàn chỉnh do API cấp 2 hỗ trợ là ["image", "interval", "video", "walkaround"], trong đó "video" biểu thị chế độ quay video và "walkaround" biểu thị chế độ chụp hai hình ảnh theo trình tự, chế độ đầu tiên với người dùng đứng ở vị trí bất kỳ so với máy ảnh và chế độ thứ hai với người dùng đứng ở phía đối diện (tương ứng với điểm đứng đầu) của máy ảnh. Điều này cho phép máy ảnh xóa người dùng khỏi hình ảnh cuối cùng bằng cách kết hợp 2 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 đến 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ề ả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 các chế độ dành riêng cho nhà cung cấp.

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

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

Tùy chọn này đã được thêm vào từ API cấp 2.1.

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

Tùy chọn này đã được thêm vào từ API cấp 2.1.

 r
exposureProgram Số Chương trình phơi sáng hiện tại. Rr
exposureProgramSupport Mảng số Danh sách các chương trình hiển thị 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 phơi sáng khác nhau:
  • 0 = Không xác định
  • 1 = Thủ công
  • 2 = Chương trình pháp tuyến
  • 3 = Ưu tiên khẩu độ
  • 4 = Mức độ ưu tiên của cửa chớp
Chọn đường liên kết sau để tải thêm thông tin chi tiết về ExposureProgram xuống. 		r
iso Số Chế độ cài đặt tốc độ ISO hiện tại. Rr
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 đang ở 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.

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

 r
shutterSpeed Số Chế độ cài đặt tốc độ chụp hiện tại. Rr
shutterSpeedSupport Mảng số

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

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

Tùy 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 f-stop. Rr
apertureSupport Mảng số

API cấp 1: Danh sách các chế độ cài đặt khẩu độ hiện có, được thể hiện trong f/number; 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 thể hiện trong 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 số dư màu trắng hiện tại; ví dụ: daylight. Mặc định là auto. Rr
whiteBalanceSupport Mảng chuỗi Danh sách chế độ cài đặt số dư trắng hiện có, có thể là một tập hợp con của danh sách được xác định trước:[ "auto", "incandescent", "fluorescent", "daylight", "cloudy-daylight", "shade", "twilight"]. Giá trị cho mỗi trạng thái:
  • incandescent, khoảng 3200K
  • fluorescent, khoảng 4000K
  • datalight, khoảng 5200K
  • cloudy-daylight, khoảng 6000K
  • shade, khoảng 7000K
  • twilight, khoảng 12000K
Tiền tố là tên cài đặt riêng cho nhà cung cấp có dấu gạch dưới; ví dụ: _vendor-setting		 r
exposureCompensation Số Bù phơi sáng hiện tại. Rr
exposureCompensationSupport Mảng số Danh sách 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 hiện tại và độ phân giả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, thì phản hồi thích hợp có thể là:

{
    "type": "jpeg",
    "width": 2000,
    "height": 1000
}
Nếu captureMode là video, thì bạn có thể trả lời như sau: 
{
    "type": "mp4",
    "width": 1920,
    "height": 1080,
    "framerate": 30
}

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

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

Danh sách các định dạng tệp hiện có; 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.

Tùy 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à thời điểm tiếp xúc với thời điểm bắt đầu, tính bằng giây. Rr
exposureDelaySupport Mảng số Danh sách độ trễ tiếp xúc hiện có sẵn 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 camera chuyển sang chế độ ngủ, tính bằng giây. Rr
sleepDelaySupport Mảng số Danh sách độ trễ giấc ngủ hiện có sẵn tính bằng giây; ví dụ: [30, 60, 120, 300, 600, 1800, 65535], trong đó 65535 tắt chế độ ngủ (máy ảnh không chuyển sang chế độ 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. Rr
offDelaySupport Mảng số Danh sách độ trễ 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 (máy ảnh không tắt nguồn cho đến khi pin hết hoặc tắt nguồn theo cách thủ công) và phải được hỗ trợ. r
totalSpace Số Chỉ đọc: Số byte trong tổng số bộ nhớ. r
remainingSpace Số Chỉ đọc: Số byte bộ nhớ miễn phí. r
remainingPictures Số Chỉ có thể đọc: Ước tính số lượng ảnh còn lại dựa trên chế độ cài đặt chụp hiện tại. 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ỉ có hiệu lực 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; ví dụ: ngay trước mỗi lệnh takePicture. 65535 thông báo cho máy ảnh rằng vị trí GPS hiện tại không hợp lệ và máy ảnh nên bỏ qua và sử dụng GPS của chính nó nếu có; ví dụ: setOptions({"gpsInfo": {"lat": 65535, "lng": 65535}}) có nghĩa là vị trí GPS không hợp lệ.		 Rr
dateTimeZone Chuỗi Thông tin ngày và giờ hiện tại. Do setOptions đặt bằng cách sử dụng ngày, giờ và múi giờ của điện thoại. Định dạng là YYYY:MM:DD HH:MM:SS+(-)HH:MM. Giờ ở định dạng 24 giờ, ngày và giờ được phân tách bằng dấu cách, còn múi giờ là độ 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) Rr
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 tính năng này. 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.

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

 Rr
hdrSupport

API cấp 1: Boolean

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

API cấp 1: Giá trị true cho biết rằng máy ảnh hỗ trợ HDR. Tuỳ chọn cài đặt false xác định máy ảnh không có HDR.

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

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

 r
exposureBracket Đối tượng Chế độ cài đặt giá trị phơi sáng hiện tại. Chỉ có sẵn 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 tính năng phơi sáng thủ công, đối tượng này sẽ chứa hai mục:
  1. shots, một số nguyên chứa số lần chụp cần chụp.
  2. increment, một số chứa mức tăng EV giữa các lần quay.
Ví dụ: 
{
    "shots": 3,
    "increment": 1.33
}
Nếu máy ảnh sử dụng tính năng phơi sáng tự động, đối tượng chứa: 
{
    "autoMode": true
}

API cấp 1: Mặc định để trống {} khi hdrSupport == false. 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 thành 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).

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

 Rr
exposureBracketSupport Đối tượng

Hiện đã có chế độ cài đặt giá trị 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 để trống {} nếu hdrSupport == false. Khi hdrSupport == true nhưng không hỗ trợ độ phơi sáng tự động, thì autoMode sẽ là false.

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

Tùy 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. Đặt giá trị mặc định là true nếu máy ảnh hỗ trợ tính năng này, nếu không thì false. Chế độ cài đặt này chỉ có thể true khi gyroSupport == true. Rr
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 thì giá trị 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ợ giá trị này, nếu không false. Chế độ cài đặt chỉ là true khi gpsSupport == true. Rr
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 phải là false. r
imageStabilization Chuỗi Thao tác ổn định hình ảnh hiện tại; ví dụ: off. Rr
imageStabilizationSupport Mảng chuỗi Hiện có các tuỳ chọn ổn định hình ảnh. Danh sách 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"]. Tiền tố các chuỗi dành riêng cho nhà cung cấp có dấu gạch dưới ( _ ); ví dụ: [ "off", "_horizontal_stabilization", "_vibration_correction" ]. r
wifiPassword Chuỗi
Có ít nhất 8 ký tự, 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 mật khẩu này khi máy ảnh được kết nối với thiết bị khách. Sau khi thay đổi, máy ảnh 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.
Máy ảnh phải cung cấp cơ chế đặt lại trong trường hợp mật khẩu bị quên; ví dụ: nút đặt lại để khôi phục mật khẩu mặc định ban đầu.
 mà
previewFormat Đối tượng

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

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

Tùy chọn này đã được thêm vào từ API cấp 2.

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

Những đị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
    }
]

Tùy chọn này đã được thêm vào từ API cấp 2.

 r
captureInterval Số Khoảng thời gian hiện tại giữa các lần chụp hai hình ảnh liên tiếp, trong seconds.

Tùy chọn này đã được thêm vào từ API cấp 2.

 Rr
captureIntervalSupport Đối tượng

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

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

Tùy chọn này đã được thêm vào từ API cấp 2.

 r
captureNumber Số Số lượng hình ảnh cần chụp trong một phiên chụp. Mặc định là 0, tức là quá trình chụp cần được chấm dứt 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 bằng số đã chỉ định. Quá trình chụp cũng có thể bị gián đoạn khi máy ảnh hết pin hoặc khi máy ảnh cố ý tắt.

Tùy chọn này đã được thêm vào từ API cấp 2.

 Rr
captureNumberSupport Đối tượng

Số lượng hình ảnh tối thiểu và tối đa có thể chụp được trong một khoảng thời gian chụp; ví dụ:

{
    "minNumber": 2,
    "maxNumber": 50
}
Ảnh này có thể thay đổi tùy thuộc vào bộ nhớ còn lại.

Tùy chọn này đã được thêm vào từ 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 hiện tại của video.

Tùy chọn này đã được thêm vào từ 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 lần yêu cầu thăm dò trạng thái liên tiếp. Máy khách phải sử dụng trường này để định hướng hành vi thăm dò trạng thái của họ. Ví dụ: khi máy ảnh ghép hình ảnh, khách hàng có thể cần kiểm tra máy ảnh định kỳ để xem máy có hoàn tất quá trình ghép không. Mỗi loại máy ảnh có chế độ hỗ trợ khác nhau. Ví dụ: một số máy ảnh có thể xử lý việc thăm dò trạng thái sau mỗi giây trong khi các máy ảnh khác hỗ trợ khoảng thời gian dài hơn.

Tùy chọn này đã được thêm vào từ API cấp 2.

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

Tùy chọn này đã được thêm vào từ API cấp 2.

 Rr
delayProcessingSupport Mảng boolean

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

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

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

Tùy chọn này đã được thêm vào từ 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 máy ảnh 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 thay đổi; mặc định là 2 nếu máy ảnh chỉ hỗ trợ API cấp 2. Việc này là không nên sử dụng trước khi máy khách chuyển sang API cấp 2. Nếu máy ảnh chỉ hỗ trợ API cấp 2, thì yêu cầu cố gắng đặt thành 1 sẽ không thành công. Nếu bạn đặt clientVersion thành 2 giá trị thành công và yêu cầu một lệnh không dùng nữa từ API cấp 1 sẽ được yêu cầu, thì yêu cầu sẽ không thành công với mã lỗi unknownCommand.

Tùy chọn này đã được thêm vào từ API cấp 2.

 Rr
photoStitchingSupport Mảng chuỗi

Danh sách các tùy chọn ghép ảnh. Trả về [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 ghép có thể định cấu hình người dùng. Đặt tiền tố cho các chế độ cài đặt dành riêng cho nhà cung cấp, bao gồm dấu gạch dưới, ví dụ: _vendor-setting.

Tùy chọn này đã được thêm vào từ API cấp 2.1.

 r
photoStitching Chuỗi

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

Tùy chọn này đã được thêm vào từ API cấp 2.1.

 Rr
videoStitchingSupport Mảng chuỗi

Danh sách các lựa chọn ghép video. Trả về [ondevice] nếu video luôn được ghép trên máy ảnh, [none] nếu máy không thể ghép video và [none,ondevice] nếu người dùng có thể định cấu hình video. Đặt tiền tố cho các chế độ cài đặt dành riêng cho nhà cung cấp, bao gồm dấu gạch dưới, ví dụ: _vendor-setting.

Tùy chọn này đã được thêm vào từ API cấp 2.1.

 r
videoStitching Chuỗi

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

Tùy chọn này đã được thêm vào từ API cấp 2.1.

 Rr
videoGPSSupport Mảng chuỗi

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

Tùy chọn này đã được thêm vào từ 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 giá trị này được hỗ trợ.

Tùy chọn này đã được thêm vào từ API cấp 2.1.

 Rr
_vendorSpecific [loại] (không bắt buộc) Các tuỳ chọn máy ảnh bổ sung dành riêng cho nhà cung cấp. Tiền tố các chuỗi dành riêng cho nhà cung cấp có dấu gạch dưới ( _ ).