Представляем CameraX 1.5: мощная видеозапись и профессиональная фотосъемка
Время на чтение: 7 минут.
Команда CameraX рада сообщить о выпуске версии 1.5! В этом обновлении мы сосредоточились на том, чтобы сделать профессиональные возможности доступными для всех и упростить настройку камеры.
При записи видео пользователи теперь могут без труда снимать потрясающие замедленные видео или видео с высокой частотой кадров. Но самое главное – новый Feature Group API позволяет уверенно включать сложные комбинации, такие как 10-битный HDR и 60 кадров/с, обеспечивая стабильные результаты на поддерживаемых устройствах.
Что касается фотосъемки, то теперь вы можете сохранять необработанные и несжатые файлы DNG (RAW). Кроме того, теперь вы можете использовать Ultra HDR даже при работе с мощными расширениями камеры.
В основе этих функций лежит новый SessionConfig API, который упрощает настройку и реконфигурацию камеры. Давайте подробнее рассмотрим эти новые функции.
Мощная видеозапись: высокая скорость и комбинации функций
В CameraX 1.5 значительно расширены возможности работы с видео, что позволяет создавать более креативные и надежные записи.
Замедленная съемка и высокая частота кадров
Теперь вы можете замедлять видео. Это одна из самых ожидаемых функций. Теперь вы можете снимать видео с высокой частотой кадров (например, 120 или 240 кадров/с) и сразу же кодировать его в замедленное видео. Вы также можете записывать видео с высокой частотой кадров, чтобы оно было исключительно плавным.
Если вы знакомы с API VideoCapture, то легко сможете реализовать эту функцию.
1. Проверка поддержки высокоскоростной записи. Используйте новый метод Recorder.getHighSpeedVideoCapabilities(), чтобы узнать, поддерживает ли устройство эту функцию.
val cameraInfo = cameraProvider.getCameraInfo(cameraSelector)
val highSpeedCapabilities = Recorder.getHighSpeedVideoCapabilities(cameraInfo)
if (highSpeedCapabilities == null) {
// This camera device does not support high-speed video.
return
}2. Настройте и привяжите вариант использования. Используйте возвращенный объект videoCapabilities, который содержит информацию о поддерживаемом качестве видео, чтобы создать HighSpeedVideoSessionConfig. Затем запросите поддерживаемые диапазоны частоты кадров с помощью cameraInfo.getSupportedFrameRateRanges() и задайте нужный диапазон. Вызовите setSlowMotionEnabled(true), чтобы записывать замедленные видео. В противном случае будут записываться видео с высокой частотой кадров. Наконец, нажмите Recorder.prepareRecording().start(), чтобы начать запись видео.
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, {})Совместимость и ограничения
Для высокоскоростной записи требуется поддержка CameraConstrainedHighSpeedCaptureSession и CamcorderProfile. Всегда проверяйте возможности устройства и включайте высокоскоростную запись только на поддерживаемых устройствах, чтобы не ухудшать пользовательский опыт. Сейчас эта функция поддерживается на основных камерах почти всех устройств Pixel и некоторых моделей других производителей.
Подробную информацию можно найти в записи блога.
Объединяйте функции с уверенностью: Feature Group API
В CameraX 1.5 появился Feature Group API, который позволяет не гадать, совместимы ли функции. Благодаря API запросов на комбинацию функций в Android 15 вы можете уверенно включать несколько функций одновременно, обеспечивая стабильную работу камеры. В настоящее время Feature Group поддерживает HDR (HLG), 60 кадров/с, стабилизацию предварительного просмотра и Ultra HDR. Например, на устройствах Pixel 10 и Galaxy S25 можно одновременно включить HDR, 60 кадров/с и стабилизацию предпросмотра. В будущем планируется добавить запись в формате 4K и ультраширокоугольный зум.
Feature Group API позволяет решать две основные задачи:
Пример 1. Приоритет отдается наилучшему качеству
Если вы хотите использовать наилучшее сочетание функций, укажите их в порядке приоритета. CameraX попытается включить их по порядку, выбрав первую комбинацию, которую устройство полностью поддерживает.
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)В этом примере CameraX пытается включить функции в следующем порядке:
- HDR + 60 кадров/с + стабилизация предпросмотра
- HDR + 60 кадров/с
- HDR + стабилизация предпросмотра
- HDR
- 60 кадр/с + стабилизация предпросмотра
- 60 кадров/с
- Стабилизация при предпросмотре
- Нет
Пример 2. Создание пользовательского интерфейса настроек
Теперь вы можете точно отразить, какие комбинации функций поддерживаются в интерфейсе настроек вашего приложения, отключив переключатели для неподдерживаемых параметров, как показано на рисунке ниже.
Чтобы определить, нужно ли сделать переключатель серым, используйте следующие коды для проверки поддержки комбинации функций. Сначала запросите статус каждой отдельной функции. После включения функции повторно запросите оставшиеся функции с включенными функциями, чтобы проверить, должны ли их переключатели теперь быть серыми из-за ограничений совместимости.
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
}
}Подробную информацию вы найдете в записи блога о группах функций.
Дополнительные средства оптимизации видео
- Улучшения одновременной работы камер. В CameraX 1.5.1 теперь можно одновременно привязывать варианты использования Preview, ImageCapture и VideoCapture для каждого объекта SingleCameraConfig в режиме без композиции. Кроме того, в режиме композиции (те же сценарии использования, что и с CompositionSettings) теперь можно задать
CameraEffect, который будет применяться к конечному результату композиции. - Динамическое отключение звука. Теперь вы можете начать запись с отключенным звуком, используя
PendingRecording.withAudioEnabled(boolean initialMuted), и разрешить пользователю включить звук позже, используяRecording.mute(boolean muted). - Улучшенная обработка нехватки памяти. Теперь CameraX надежно отправляет ошибку
VideoRecordEvent.Finalize.ERROR_INSUFFICIENT_STORAGE, позволяя приложению корректно обрабатывать ситуации с нехваткой памяти и информировать пользователя. - Улучшение видео при слабом освещении. На поддерживаемых устройствах, например Pixel 10, можно включить CameraControl.enableLowLightBoostAsync, чтобы автоматически повышать яркость предварительного просмотра и видеопотоков в темноте.
Профессиональная фотосъемка
В CameraX 1.5 значительно улучшен класс ImageCapture. Это оценят разработчики, которым нужны максимальное качество и гибкость.
Творите без ограничений с помощью съемки в формате DNG (RAW)
Для полного контроля над постобработкой CameraX теперь поддерживает захват DNG (RAW). Это позволяет получить доступ к необработанным и несжатым данным изображения непосредственно с датчика камеры, что дает возможность профессионального редактирования и цветокоррекции. API поддерживает съемку только в формате DNG или одновременную съемку в форматах JPEG и DNG. Ниже приведен образец кода, который позволяет одновременно сохранять файлы JPEG и 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 для расширений камеры
Получите лучшее из двух миров: потрясающую вычислительную фотографию с расширениями камеры (например, ночным режимом) в сочетании с великолепными цветами и динамическим диапазоном Ultra HDR. Сейчас эта функция поддерживается на многих современных телефонах Android премиум-класса, таких как Pixel 9/10 и 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 и удобства использования
Новый способ настройки: SessionConfig
Как показано в примерах выше, SessionConfig – это новая концепция в CameraX 1.5. Он централизует конфигурацию и упрощает API двумя основными способами:
- Больше не нужно вручную вызывать
unbind(). API CameraX учитывают жизненный цикл. Он неявно отменит привязку вариантов использования, когда действие или другой объектLifecycleOwnerбудет уничтожен. Но чтобы обновить варианты использования или переключить камеры, вам все равно нужно вызватьunbind()илиunbindAll()перед повторной привязкой. В CameraX 1.5 при привязке новогоSessionConfigCameraX автоматически обновляет сеанс, поэтому вызывать unbind не нужно. - Детерминированное управление частотой кадров. Новый API
SessionConfigпозволяет управлять частотой кадров детерминированным способом. В отличие от предыдущего методаsetTargetFrameRate, который был лишь подсказкой, новый метод гарантирует, что указанный диапазон частоты кадров будет применен после успешной настройки. Чтобы обеспечить точность, необходимо запросить поддерживаемые частоты кадров с помощьюCameraInfo.getSupportedFrameRateRanges(SessionConfig). Передавая полныйSessionConfig, CameraX может точно определить поддерживаемые диапазоны на основе конфигураций потока.
Стабильная версия Camera-Compose
Мы знаем, как вам нравится Jetpack Compose, и рады сообщить, что библиотека camera-compose теперь стабильна в версии 1.5.1! В этом выпуске исправлены критические ошибки, связанные с использованием CameraXViewfinder с функциями Compose, такими как moveableContentOf и Pager, а также решена проблема с растягиванием предварительного просмотра. В будущих выпусках мы продолжим добавлять новые функции в camera-compose.
Улучшения ImageAnalysis и CameraControl
- Регулировка яркости фонарика. Новые API позволяют точнее настраивать яркость фонарика на устройстве. Вы можете запросить максимальную поддерживаемую яркость с помощью CameraInfo.getMaxTorchStrengthLevel(), а затем установить желаемый уровень с помощью CameraControl.setTorchStrengthLevel().
- Поддержка NV21 в
ImageAnalysis. Теперь вы можете запрашивать графический формат NV21 непосредственно изImageAnalysis, что упрощает интеграцию с другими библиотеками и API. Для этого используется методImageAnalysis.Builder.setOutputImageFormat(OUTPUT_IMAGE_FORMAT_NV21).
Начните уже сегодня
Обновите зависимости до CameraX 1.5 и попробуйте новые функции. Нам не терпится увидеть, что вы создадите.
Чтобы использовать CameraX 1.5, добавьте в файл libs.versions.toml следующие зависимости: Рекомендуем использовать версию 1.5.1, в которой исправлены многие критические ошибки и улучшена работа с несколькими камерами.
[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" }Затем добавьте в зависимости 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
}У вас есть вопросы или вы хотите связаться с командой CameraX? Присоединитесь к группе обсуждения для разработчиков CameraX или отправьте отчет об ошибке:
-
Новости о продуктахНа движке Unity создано более половины всех мобильных игр в мире, поэтому первое впечатление имеет значение. Для разработчиков игр плавный и надежный процесс адаптации игроков имеет важное значение для удержания в первый день и долгосрочного вовлечения.
Michelle Martin • Время на чтение: 1 минута -
Новости о продуктахAndroid XR позволяет создавать приложения с пространственным интерфейсом, которые можно использовать как дома, так и на ходу. На Саммите для разработчиков Android мы отметили важную веху – запуск XREAL AURA.
Amy Zeppenfeld, Vinny DaSilva • Время на чтение: 3 минуты -
Новости о продуктахВ эпоху искусственного интеллекта пользователи больше не просто нажимают на кнопки в приложениях. Они ставят перед собой глобальные цели и ожидают, что ИИ-агенты, такие как Gemini, будут выполнять многоэтапные рабочие процессы, иногда в нескольких приложениях на их устройствах.
Jingyu Shi • Время на чтение: 4 минуты
Получайте еженедельную рассылку с последними новостями о разработке для Android.