Nhóm CameraX rất vui mừng thông báo về việc phát hành phiên bản 1.5! Bản cập nhật mới nhất này tập trung vào việc mang đến các tính năng chuyên nghiệp trong tầm tay bạn, đồng thời giúp bạn định cấu hình phiên máy ảnh dễ dàng hơn bao giờ hết.

Đối với quay video, giờ đây, người dùng có thể dễ dàng quay video chuyển động chậm hoặc video có tốc độ khung hình cao tuyệt đẹp. Quan trọng hơn, API Nhóm tính năng mới cho phép bạn tự tin bật các tổ hợp phức tạp như HDR 10 bit và 60 khung hình/giây, đảm bảo kết quả nhất quán trên các thiết bị được hỗ trợ.

Về chụp ảnh, bạn có được tính linh hoạt tối đa nhờ hỗ trợ chụp các tệp DNG (RAW) chưa xử lý, chưa nén. Ngoài ra, giờ đây, bạn có thể tận dụng đầu ra Ultra HDR ngay cả khi sử dụng các Tiện ích camera mạnh mẽ.

Các tính năng này được hỗ trợ bởi SessionConfig API mới, giúp đơn giản hoá việc thiết lập và định cấu hình lại camera. Bây giờ, hãy cùng tìm hiểu chi tiết về các tính năng mới thú vị này.

Quay video mạnh mẽ: Tốc độ cao và tổ hợp tính năng

CameraX 1.5 mở rộng đáng kể các tính năng video, cho phép trải nghiệm quay video sáng tạo và mạnh mẽ hơn.

Video chuyển động chậm và tốc độ khung hình cao

Một trong những tính năng được mong đợi nhất của chúng tôi, video chuyển động chậm, hiện đã có. Giờ đây, bạn có thể quay video tốc độ cao (ví dụ: 120 hoặc 240 khung hình/giây) và mã hoá trực tiếp thành video chuyển động chậm ấn tượng. Ngoài ra, bạn có thể quay video ở cùng tốc độ khung hình cao để tạo ra video cực kỳ mượt mà.

Việc triển khai tính năng này rất đơn giản nếu bạn đã quen thuộc với VideoCapture API.

1. Kiểm tra khả năng hỗ trợ tốc độ cao: Sử dụng phương thức Recorder.getHighSpeedVideoCapabilities() mới để truy vấn xem thiết bị có hỗ trợ tính năng này hay không.

  val cameraInfo = cameraProvider.getCameraInfo(cameraSelector)

val highSpeedCapabilities = Recorder.getHighSpeedVideoCapabilities(cameraInfo)

if (highSpeedCapabilities == null) {
    // This camera device does not support high-speed video.
    return
}

2. Định cấu hình và liên kết trường hợp sử dụng: Sử dụng videoCapabilities được trả về (chứa thông tin về chất lượng video được hỗ trợ) để tạo HighSpeedVideoSessionConfig. Sau đó, bạn phải truy vấn các dải tốc độ khung hình được hỗ trợ thông qua cameraInfo.getSupportedFrameRateRanges() và đặt dải tốc độ khung hình mong muốn. Gọi setSlowMotionEnabled(true) để quay video chuyển động chậm, nếu không, video sẽ được quay ở tốc độ khung hình cao. Bước cuối cùng là sử dụng Recorder.prepareRecording().start() thông thường để bắt đầu quay video.

  val preview = Preview.Builder().build()
val quality = highSpeedCapabilities
        .getSupportedQualities(DynamicRange.SDR).first()

val recorder = Recorder.Builder()
      .setQualitySelector(QualitySelector.from(quality)))
      .build()

val videoCapture = VideoCapture.withOutput(recorder)

val frameRateRange = cameraInfo.getSupportedFrameRateRanges(      
       HighSpeedVideoSessionConfig(videoCapture, preview)
).first()

val sessionConfig = HighSpeedVideoSessionConfig(
    videoCapture, 
    preview, 
    frameRateRange = frameRateRange, 
    // Set true for slow-motion playback, or false for high-frame-rate
    isSlowMotionEnabled = true
)

cameraProvider.bindToLifecycle(
     lifecycleOwner, cameraSelector, sessionConfig)

// Start recording slow motion videos. 
val recording = recorder.prepareRecording(context, outputOption)
      .start(executor, {})

Khả năng tương thích và các hạn chế

Tính năng quay video tốc độ cao yêu cầu hỗ trợ CameraConstrainedHighSpeedCaptureSession và CamcorderProfile cụ thể. Luôn kiểm tra khả năng và chỉ bật tính năng quay video tốc độ cao trên các thiết bị được hỗ trợ để tránh trải nghiệm người dùng kém. Hiện tại, tính năng này được hỗ trợ trên camera sau của hầu hết các thiết bị Pixel và một số mẫu của các nhà sản xuất khác.

Hãy xem bài đăng trên blog để biết thêm chi tiết.

Kết hợp các tính năng một cách tự tin: Feature Group API

CameraX 1.5 giới thiệu Feature Group API, giúp loại bỏ việc đoán khả năng tương thích của tính năng. Dựa trên API truy vấn tổ hợp tính năng của Android 15, giờ đây, bạn có thể tự tin bật nhiều tính năng cùng nhau, đảm bảo phiên máy ảnh ổn định. Nhóm tính năng hiện hỗ trợ: HDR (HLG), 60 khung hình/giây, Chống rung khi xem trước và Ultra HDR. Ví dụ: bạn có thể bật đồng thời HDR, 60 khung hình/giây và Chống rung khi xem trước trên dòng Pixel 10 và Galaxy S25. Chúng tôi dự định sẽ cải tiến thêm để bao gồm tính năng quay video 4K và thu phóng siêu rộng. 

API nhóm tính năng cho phép 2 trường hợp sử dụng thiết yếu:

Trường hợp sử dụng 1: Ưu tiên chất lượng tốt nhất

Nếu muốn chụp bằng tổ hợp tính năng tốt nhất có thể, bạn có thể cung cấp danh sách được ưu tiên. CameraX sẽ cố gắng bật các tính năng này theo thứ tự, chọn tổ hợp đầu tiên mà thiết bị hỗ trợ đầy đủ.

  val sessionConfig = SessionConfig(
    useCases = listOf(preview, videoCapture),
    preferredFeatureGroup = listOf(
        GroupableFeature.HDR_HLG10,
        GroupableFeature.FPS_60,
        GroupableFeature.PREVIEW_STABILIZATION
    )
).apply {
    // (Optional) Get a callback with the enabled features to update your UI.
    setFeatureSelectionListener { selectedFeatures ->
        updateUiIndicators(selectedFeatures)
    }
}
processCameraProvider.bindToLifecycle(activity, cameraSelector, sessionConfig)

Trong ví dụ này, CameraX cố gắng bật các tính năng theo thứ tự sau:

1. HDR + 60 khung hình/giây + Chống rung khi xem trước
2. HDR + 60 khung hình/giây
3. HDR + Chống rung khi xem trước
4. HDR
5. 60 khung hình/giây + Chống rung khi xem trước
6. 60 khung hình/giây
7. Chống rung khi xem trước
8. Không có

Trường hợp sử dụng 2: Xây dựng giao diện người dùng cài đặt hướng đến người dùng

Giờ đây, bạn có thể phản ánh chính xác những tổ hợp tính năng được hỗ trợ trong giao diện người dùng cài đặt của ứng dụng, tắt các nút bật/tắt cho các lựa chọn không được hỗ trợ như hình bên dưới. 

Để xác định xem có làm mờ nút bật/tắt hay không, hãy sử dụng các mã sau để kiểm tra khả năng hỗ trợ tổ hợp tính năng. Ban đầu, hãy truy vấn trạng thái của từng tính năng riêng lẻ. Sau khi bật một tính năng, hãy truy vấn lại các tính năng còn lại bằng các tính năng đã bật để xem liệu các nút bật/tắt của chúng có phải bị làm mờ do các ràng buộc về khả năng tương thích hay không.

  fun disableFeatureIfNotSuported(
   enabledFeatures: Set<GroupableFeature>,     
   featureToCheck:GroupableFeature
) {
 val sessionConfig = SessionConfig(
     useCases = useCases,
     requiredFeatureGroup = enabledFeatures + featureToCheck
 )
 val isSupported = cameraInfo.isFeatureGroupSupported(sessionConfig)

 if (!isSupported) {
     // disable the toggle for featureToCheck
 }
}

Vui lòng tham khảo bài đăng trên blog về Nhóm tính năng để biết thêm thông tin. 

Các điểm cải tiến khác về video

• Cải tiến camera đồng thời: Với CameraX 1.5.1, giờ đây, bạn có thể liên kết đồng thời các trường hợp sử dụng Xem trước + Chụp ảnh + Quay video cho mỗi SingleCameraConfig trong chế độ không kết hợp. Ngoài ra, trong chế độ kết hợp (các trường hợp sử dụng tương tự với CompositionSettings), giờ đây, bạn có thể đặt CameraEffect được áp dụng cho kết quả kết hợp cuối cùng.
• Tắt tiếng động: Giờ đây, bạn có thể bắt đầu quay video ở trạng thái tắt tiếng bằng cách sử dụng PendingRecording.withAudioEnabled(boolean initialMuted) và cho phép người dùng bật tiếng sau bằng cách sử dụng Recording.mute(boolean muted).
• Cải thiện khả năng xử lý tình trạng thiếu bộ nhớ: CameraX hiện gửi lỗi VideoRecordEvent.Finalize.ERROR_INSUFFICIENT_STORAGE một cách đáng tin cậy, cho phép ứng dụng của bạn xử lý tình trạng thiếu bộ nhớ một cách suôn sẻ và thông báo cho người dùng.
• Tăng cường ánh sáng yếu: Trên các thiết bị được hỗ trợ (như dòng Pixel 10), bạn có thể bật CameraControl.enableLowLightBoostAsync để tự động làm sáng bản xem trước và luồng video trong môi trường tối.

Chụp ảnh chuyên nghiệp

CameraX 1.5 mang đến những nâng cấp lớn cho ImageCapture dành cho các nhà phát triển yêu cầu chất lượng và tính linh hoạt tối đa.

Giải phóng khả năng kiểm soát sáng tạo bằng tính năng chụp DNG (RAW)

Để kiểm soát hoàn toàn quá trình xử lý hậu kỳ, CameraX hiện hỗ trợ tính năng chụp DNG (RAW). Tính năng này cho phép bạn truy cập vào dữ liệu hình ảnh chưa xử lý, chưa nén trực tiếp từ cảm biến camera, cho phép chỉnh sửa và phân loại màu chuyên nghiệp. API hỗ trợ chụp riêng tệp DNG hoặc chụp đồng thời đầu ra JPEG và DNG. Hãy xem mã mẫu bên dưới để biết cách chụp đồng thời tệp JPEG và DNG.

  val capabilities = ImageCapture.getImageCaptureCapabilities(cameraInfo)
val imageCapture = ImageCapture.Builder().apply {
    if (capabilities.supportedOutputFormats
             .contains(OUTPUT_FORMAT_RAW_JPEG)) {
        // Capture both RAW and JPEG formats.
        setOutputFormat(OUTPUT_FORMAT_RAW_JPEG)
    }
}.build()
// ... bind imageCapture to lifecycle ...


// Provide separate output options for each format.
val outputOptionRaw = /* ... configure for image/x-adobe-dng ... */
val outputOptionJpeg = /* ... configure for image/jpeg ... */
imageCapture.takePicture(
    outputOptionRaw,
    outputOptionJpeg,
    executor,
    object : ImageCapture.OnImageSavedCallback {
        override fun onImageSaved(results: OutputFileResults) {
            // This callback is invoked twice: once for the RAW file
            // and once for the JPEG file.
        }

        override fun onError(exception: ImageCaptureException) {}
    }
)

Ultra HDR cho Tiện ích camera

Tận dụng những ưu điểm của cả hai: khả năng chụp ảnh điện toán tuyệt đẹp của Tiện ích camera (như Chế độ ban đêm) kết hợp với màu sắc rực rỡ và dải động của Ultra HDR. Tính năng này hiện được hỗ trợ trên nhiều điện thoại Android cao cấp gần đây, chẳng hạn như dòng Pixel 9/10 và dòng Samsung S24/S25.

  // Support UltraHDR when Extension is enabled. 

val extensionsEnabledCameraSelector = extensionsManager
     .getExtensionEnabledCameraSelector(
        CameraSelector.DEFAULT_BACK_CAMERA, ExtensionMode.NIGHT)

val imageCapabilities = ImageCapture.getImageCaptureCapabilities(
               cameraProvider.getCameraInfo(extensionsEnabledCameraSelector)

val imageCapture = ImageCapture.Builder()
     .apply {
       if (imageCapabilities.supportedOutputFormats
                .contains(OUTPUT_FORMAT_JPEG_ULTRA_HDR) {
           setOutputFormat(OUTPUT_FORMAT_JPEG_ULTRA_HDR)

       }

     }.build()

API cốt lõi và các tính năng giúp tăng cường khả năng hữu dụng

Cách định cấu hình mới: SessionConfig

Như bạn thấy trong các ví dụ ở trên, SessionConfig là một khái niệm mới trong CameraX 1.5. Tính năng này tập trung hoá cấu hình và đơn giản hoá API theo 2 cách chính:

1. Không còn phải gọi unbind() theo cách thủ công: Các API CameraX nhận biết được vòng đời. API này sẽ ngầm "huỷ liên kết" các trường hợp sử dụng của bạn khi hoạt động hoặc LifecycleOwner khác bị huỷ. Tuy nhiên, việc cập nhật các trường hợp sử dụng hoặc chuyển đổi camera vẫn yêu cầu bạn gọi unbind() hoặc unbindAll() trước khi liên kết lại. Giờ đây, với CameraX 1.5, khi bạn liên kết một SessionConfig mới, CameraX sẽ cập nhật phiên một cách liền mạch cho bạn, loại bỏ nhu cầu gọi huỷ liên kết.
2. Kiểm soát tốc độ khung hình xác định: API SessionConfig mới giới thiệu một cách xác định để quản lý tốc độ khung hình. Không giống như setTargetFrameRate trước đây (chỉ là một gợi ý), phương thức mới này đảm bảo dải tốc độ khung hình được chỉ định sẽ được áp dụng khi định cấu hình thành công. Để đảm bảo độ chính xác, bạn phải truy vấn tốc độ khung hình được hỗ trợ bằng cách sử dụng CameraInfo.getSupportedFrameRateRanges(SessionConfig). Bằng cách truyền toàn bộ SessionConfig, CameraX có thể xác định chính xác các dải được hỗ trợ dựa trên cấu hình luồng.

Camera-Compose hiện đã ổn định

Chúng tôi biết bạn thích Jetpack Compose đến mức nào và rất vui mừng thông báo rằng camera-compose thư viện hiện đã ổn định ở phiên bản 1.5.1! Bản phát hành này bao gồm các bản sửa lỗi quan trọng liên quan đến việc sử dụng CameraXViewfinder với các tính năng của Compose như moveableContentOf và Pager, cũng như giải quyết vấn đề kéo dài bản xem trước. Chúng tôi sẽ tiếp tục bổ sung thêm các tính năng cho camera-compose trong các bản phát hành trong tương lai.

Cải tiến ImageAnalysis và CameraControl

• Điều chỉnh cường độ đèn pin: Kiểm soát chi tiết đèn pin của thiết bị bằng các API mới. Bạn có thể truy vấn cường độ tối đa được hỗ trợ bằng cách sử dụng CameraInfo.getMaxTorchStrengthLevel() rồi đặt mức mong muốn bằng CameraControl.setTorchStrengthLevel().
• Hỗ trợ NV21 trong ImageAnalysis: Giờ đây, bạn có thể yêu cầu định dạng hình ảnh NV21 trực tiếp từ ImageAnalysis, giúp đơn giản hoá việc tích hợp với các thư viện và API khác. Tính năng này được bật bằng cách gọi ImageAnalysis.Builder.setOutputImageFormat(OUTPUT_IMAGE_FORMAT_NV21).

Bắt đầu ngay hôm nay

Cập nhật các phần phụ thuộc lên CameraX 1.5 ngay hôm nay và khám phá các tính năng mới thú vị. Chúng tôi rất mong được thấy những gì bạn xây dựng.

Để sử dụng CameraX 1.5,  vui lòng thêm các phần phụ thuộc sau vào libs.versions.toml. (Bạn nên sử dụng phiên bản 1.5.1 có chứa nhiều bản sửa lỗi quan trọng và các điểm cải tiến camera đồng thời.)

  [versions]

camerax = "1.5.1"


[libraries]

..

androidx-camera-core = { module = "androidx.camera:camera-core", version.ref = "camerax" }

androidx-camera-compose = { module = "androidx.camera:camera-compose", version.ref = "camerax" }

androidx-camera-view = { module = "androidx.camera:camera-view", version.ref = "camerax" }

androidx-camera-lifecycle = { group = "androidx.camera", name = "camera-lifecycle", version.ref = "camerax" }

androidx-camera-camera2 = { module = "androidx.camera:camera-camera2", version.ref = "camerax" }

androidx-camera-extensions = { module = "androidx.camera:camera-extensions", version.ref = "camerax" }

Sau đó, hãy thêm các phần phụ thuộc này vào mô-đun build.gradle.kts:

  dependencies {

  ..

  implementation(libs.androidx.camera.core)
  implementation(libs.androidx.camera.lifecycle)

  implementation(libs.androidx.camera.camera2)

  implementation(libs.androidx.camera.view) // for PreviewView 
  implementation(libs.androidx.camera.compose) // for compose UI

  implementation(libs.androidx.camera.extensions) // For Extensions 

}

Bạn có câu hỏi hoặc muốn kết nối với nhóm CameraX? Tham gia nhóm thảo luận dành cho nhà phát triển CameraX hoặc báo cáo lỗi:

• Nhóm thảo luận dành cho nhà phát triển CameraX
• Báo cáo lỗi