Lưu ý: Trang này đề cập đến gói Camera2. Bạn nên sử dụng CameraX, trừ phi ứng dụng của bạn yêu cầu các tính năng cụ thể, cấp thấp của Camera2. Cả CameraX và Camera2 đều hỗ trợ Android 5.0 (API cấp 21) trở lên.
Nhiều thiết bị Android hiện đại có hai hoặc nhiều camera ở mặt trước, mặt sau hoặc cả hai mặt của thiết bị. Mỗi ống kính có thể có các chức năng riêng, chẳng hạn như chụp liên tục, điều khiển thủ công hoặc theo dõi chuyển động. Ứng dụng gửi séc có thể chỉ sử dụng camera sau đầu tiên, trong khi ứng dụng mạng xã hội có thể mặc định sử dụng camera trước nhưng cho phép người dùng chuyển đổi giữa tất cả các ống kính hiện có. Trợ lý cũng có thể ghi nhớ các lựa chọn của trẻ.
Trang này trình bày cách liệt kê các ống kính máy ảnh và chức năng của chúng để bạn có thể đưa ra quyết định trong ứng dụng về việc nên sử dụng ống kính nào trong một tình huống nhất định. Đoạn mã sau đây truy xuất danh sách tất cả camera và lặp lại các camera đó:
try { val cameraIdList = cameraManager.cameraIdList // may be empty // iterate over available camera devices. for (cameraId in cameraIdList) { val characteristics = cameraManager.getCameraCharacteristics(cameraId) val cameraLensFacing = characteristics.get(CameraCharacteristics.LENS_FACING) val cameraCapabilities = characteristics.get(CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES) // check if the selected camera device supports basic features // ensures backward compatibility with the original Camera API. val isBackwardCompatible = cameraCapabilities?.contains( CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE ) ?: false // ... } } catch (e: CameraAccessException) { e.message?.let { Log.e(TAG, it) } // ... }
Biến cameraLensFacing mô tả hướng mà camera hướng tới so với màn hình thiết bị và có một trong các giá trị sau:
CameraMetadata.LENS_FACING_FRONTCameraMetadata.LENS_FACING_BACKCameraMetadata.LENS_FACING_EXTERNAL
Để biết thêm thông tin về cấu hình hướng ống kính, hãy xem CameraCharacteristics.LENS_FACING.
Biến cameraCapabilities trong mã mẫu trước đó chứa thông tin về các chức năng khác, bao gồm cả việc máy ảnh có thể tạo ra khung hình chuẩn dưới dạng đầu ra hay không (trái ngược với việc chỉ có dữ liệu cảm biến độ sâu). Bạn có thể tìm xem CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE có phải là một trong các chức năng được liệt kê của máy ảnh hay không. Chức năng này được lưu trữ dưới dạng cờ trong isBackwardCompatible.
Chọn giá trị mặc định hợp lý
Trong ứng dụng, bạn nên mở một máy ảnh cụ thể theo mặc định (nếu có). Ví dụ: ứng dụng chụp ảnh selfie có thể mở camera trước, trong khi ứng dụng thực tế tăng cường có thể bắt đầu bằng camera sau. Hàm sau đây trả về camera đầu tiên hướng về một hướng nhất định:
fun getFirstCameraIdFacing( cameraManager: CameraManager, facing: Int = CameraMetadata.LENS_FACING_BACK ): String? { try { // Get list of all compatible cameras. val cameraIds = cameraManager.cameraIdList.filter { val characteristics = cameraManager.getCameraCharacteristics(it) val capabilities = characteristics.get(CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES) capabilities?.contains( CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE ) ?: false } // Iterate over the list of cameras and return the first one matching desired // lens-facing configuration. cameraIds.forEach { val characteristics = cameraManager.getCameraCharacteristics(it) if (characteristics.get(CameraCharacteristics.LENS_FACING) == facing) { return it } } // If no camera matched desired orientation, return the first one from the list. return cameraIds.firstOrNull() } catch (e: CameraAccessException) { e.message?.let { Log.e(TAG, it) } return null } }
Bật tính năng chuyển đổi camera
Nhiều ứng dụng máy ảnh cho phép người dùng chuyển đổi giữa các máy ảnh:
Nhiều thiết bị có nhiều camera hướng về cùng một phía. Một số phòng thậm chí còn có camera USB bên ngoài. Để cung cấp cho người dùng một giao diện người dùng cho phép họ chuyển đổi giữa các camera trước, hãy chọn camera đầu tiên có sẵn cho mỗi cấu hình hướng ống kính có thể có.
Mặc dù không có logic chung để chọn camera tiếp theo, nhưng đoạn mã sau đây phù hợp với hầu hết các trường hợp sử dụng:
fun filterCompatibleCameras( cameraIds: Array<String>, cameraManager: CameraManager ): List<String> { return cameraIds.filter { val characteristics = cameraManager.getCameraCharacteristics(it) characteristics.get(CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES)?.contains( CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_BACKWARD_COMPATIBLE ) ?: false } } fun filterCameraIdsFacing( cameraIds: List<String>, cameraManager: CameraManager, facing: Int ): List<String> { return cameraIds.filter { val characteristics = cameraManager.getCameraCharacteristics(it) characteristics.get(CameraCharacteristics.LENS_FACING) == facing } } fun getNextCameraId(cameraManager: CameraManager, currCameraId: String? = null): String? { // Get all front, back and external cameras in 3 separate lists. val cameraIds = filterCompatibleCameras(cameraManager.cameraIdList, cameraManager) val backCameras = filterCameraIdsFacing( cameraIds, cameraManager, CameraMetadata.LENS_FACING_BACK ) val frontCameras = filterCameraIdsFacing( cameraIds, cameraManager, CameraMetadata.LENS_FACING_FRONT ) val externalCameras = filterCameraIdsFacing( cameraIds, cameraManager, CameraMetadata.LENS_FACING_EXTERNAL ) // The recommended order of iteration is: all external, first back, first front. val allCameras = ( externalCameras + listOf( backCameras.firstOrNull(), frontCameras.firstOrNull() ) ).filterNotNull() // Get the index of the currently selected camera in the list. val cameraIndex = allCameras.indexOf(currCameraId) // The selected camera may not be in the list, for example it could be an // external camera that has been removed by the user. return if (cameraIndex == -1) { // Return the first camera from the list. allCameras.getOrNull(0) } else { // Return the next camera from the list, wrap around if necessary. allCameras.getOrNull((cameraIndex + 1) % allCameras.size) } }
Mã này hoạt động cho một nhóm lớn thiết bị có nhiều cấu hình khác nhau. Để biết thêm thông tin về cách xử lý các trường hợp hiếm gặp, hãy xem CameraMetadata.REQUEST_AVAILABLE_CAPABILITIES_LOGICAL_MULTI_CAMERA.
Tạo ứng dụng tương thích
Đối với các ứng dụng vẫn sử dụng API Camera không dùng nữa, số lượng camera mà Camera.getNumberOfCameras() trả về phụ thuộc vào cách triển khai của OEM. Nếu có nhiều máy ảnh logic trong hệ thống, để duy trì khả năng tương thích ngược của ứng dụng, phương thức này sẽ chỉ hiển thị một máy ảnh cho mỗi máy ảnh logic và nhóm máy ảnh vật lý cơ bản. Sử dụng API Camera2 để xem tất cả camera.
Để biết thêm thông tin cơ bản về hướng máy ảnh, hãy xem Camera.CameraInfo.orientation.
Nhìn chung, hãy sử dụng API Camera.getCameraInfo() để truy vấn tất cả orientation của máy ảnh và chỉ hiển thị một máy ảnh cho mỗi hướng có sẵn cho người dùng đang chuyển đổi giữa các máy ảnh.
Phù hợp với mọi loại thiết bị
Đừng cho rằng ứng dụng của bạn luôn chạy trên thiết bị cầm tay có một hoặc hai camera. Thay vào đó, hãy chọn máy ảnh phù hợp nhất cho ứng dụng. Nếu bạn không cần một máy ảnh cụ thể, hãy chọn máy ảnh đầu tiên hướng về hướng đã chọn. Nếu không có máy ảnh hướng về một hướng nhất định, hãy cân nhắc xem người dùng có thể hoàn tất hành trình bằng một máy ảnh khác hay không. Đừng hạn chế phạm vi cung cấp ứng dụng trên một số thiết bị dựa trên phần cứng máy ảnh. Nếu có camera ngoài được kết nối, người dùng có thể muốn đặt camera đó làm camera mặc định.