CameraX チームは、バージョン 1.5 のリリースを発表できることを嬉しく思います。この最新のアップデートでは、プロレベルの機能を簡単に利用できるようにするとともに、カメラ セッションをこれまで以上に簡単に構成できるようにすることに重点を置いています。
動画撮影については、スローモーション動画や高フレームレート動画を簡単に撮影できるようになりました。さらに、新しい Feature Group API を使用すると、10 ビット HDR と 60 FPS などの複雑な組み合わせを安心して有効にできるため、サポートされているデバイスで一貫した結果が得られます。
画像キャプチャ については、未処理の非圧縮 DNG(RAW)ファイルのキャプチャをサポートすることで、最大限の柔軟性を実現しています。また、強力な Camera Extensions を使用する場合でも、ウルトラ HDR 出力を活用できるようになりました。
これらの機能を支えるのが、カメラのセットアップと再構成を効率化する新しい SessionConfig API です。それでは、これらのエキサイティングな新機能の詳細を見ていきましょう。
強力な動画撮影: 高速撮影と機能の組み合わせ
CameraX 1.5 では動画機能が大幅に拡張され、よりクリエイティブで堅牢な撮影エクスペリエンスを実現できます。
スローモーション動画と高フレームレート動画
最も期待されていた機能の 1 つであるスローモーション動画が利用できるようになりました。高速動画(120 fps や 240 fps など)を撮影し、それを直接ドラマチックなスローモーション動画にエンコードできます。また、同じ高フレームレートで撮影して、非常にスムーズな動画を作成することもできます。
VideoCapture API に慣れている方であれば、簡単に実装できます。
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 のサポートが必要です。常に機能チェックを行い、サポートされているデバイスでのみ高速撮影を有効にして、ユーザー エクスペリエンスの低下を防ぎます。現在、この機能はほぼすべての Google Pixel デバイスの背面カメラと、他のメーカーの一部のモデルでサポートされています。
詳しくは、こちらのブログ投稿をご覧ください。
Feature Group API で機能を安心して組み合わせる
CameraX 1.5 では、機能の互換性を推測する必要がない Feature Group API が導入されました。Android 15 の機能組み合わせクエリ API に基づいて、複数の機能を同時に安心して有効にできるため、安定したカメラ セッションが保証されます。現在、Feature Group は HDR(HLG)、60 fps、プレビューの手ぶれ補正、ウルトラ HDR をサポートしています。たとえば、Google Pixel 10 と Galaxy S25 シリーズでは、HDR、60 FPS、プレビューの手ぶれ補正を同時に有効にできます。今後の機能強化では、4K 撮影と超広角ズームが追加される予定です。
Feature Group API では、次の 2 つの重要なユースケースが可能です。
ユースケース 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 FPS + プレビューの手ぶれ補正
- HDR + 60 FPS
- HDR + プレビューの手ぶれ補正
- HDR
- 60 FPS + プレビューの手ぶれ補正
- 60 FPS
- プレビューの手ぶれ補正
- なし
ユースケース 2: ユーザー向けの設定 UI を構築する
アプリの設定 UI で、サポートされている機能の組み合わせを正確に反映できるようになりました。下の図のように、サポートされていないオプションの切り替えを無効にできます。
切り替えをグレー表示するかどうかを判断するには、次のコードを使用して機能の組み合わせのサポートを確認します。まず、個々の機能のステータスをクエリします。機能が有効になったら、有効にした機能を使用して残りの機能を再度クエリし、互換性の制約により切り替えをグレー表示する必要があるかどうかを確認します。
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
}
}
詳しくは、Feature Group のブログ投稿 をご覧ください。
その他の動画機能の強化
-
同時カメラの改善: CameraX 1.5.1 では、非合成モード で、各 SingleCameraConfig に対して Preview + ImageCapture + VideoCapture のユースケースを同時にバインドできるようになりました。また、合成モード (CompositionSettings を使用した同じユースケース)では、最終的な合成結果に適用される
CameraEffectを設定できるようになりました。 -
動的なミュート:
PendingRecording.withAudioEnabled(boolean initialMuted)を使用してミュート状態で撮影を開始し、Recording.mute(boolean muted)を使用して後でミュートを解除できるようにしました。 -
ストレージ不足の処理の改善: CameraX は
VideoRecordEvent.Finalize.ERROR_INSUFFICIENT_STORAGEエラーを確実にディスパッチするようになったため、アプリはストレージ不足の状態を適切に処理してユーザーに通知できます。 - 低照度ブースト: サポートされているデバイス(Google 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) {}
}
)
Camera Extensions のウルトラ HDR
Camera Extensions(夜間モードなど)の優れた計算写真学と、ウルトラ HDR の鮮やかな色とダイナミック レンジを両立できます。この機能は、Google Pixel 9/10 シリーズや Samsung S24/25 シリーズなど、最近の多くのハイエンド Android スマートフォンでサポートされています。
// 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 の新しいコンセプトです。構成を一元化し、次の 2 つの重要な方法で API を簡素化します。
-
手動での
unbind()呼び出しが不要: CameraX API はライフサイクルを認識します。アクティビティやその他のLifecycleOwnerが破棄されると、ユースケースが暗黙的に「バインド解除」されます。ただし、ユースケースの更新やカメラの切り替えを行う場合は、再バインドする前にunbind()またはunbindAll()を呼び出す必要があります。CameraX 1.5 では、新しいSessionConfigをバインドすると、CameraX がセッションをシームレスに更新するため、バインド解除の呼び出しは不要になります。 -
決定論的なフレームレート制御: 新しい
SessionConfigAPI では、フレームレートを決定論的に管理できます。以前のsetTargetFrameRateはヒントにすぎませんでしたが、この新しいメソッドでは、構成が成功した場合に指定したフレームレート範囲が適用されることが保証 されます。正確性を確保するには、CameraInfo.getSupportedFrameRateRanges(SessionConfig)を使用して、サポートされているフレームレートをクエリする必要があります。完全なSessionConfigを渡すことで、CameraX はストリーム構成に基づいてサポートされている範囲を正確に判断できます。
Camera-Compose が安定版になりました
Jetpack Compose をご愛用いただきありがとうございます。camera-compose ライブラリがバージョン 1.5.1 で安定版になったことをお知らせいたします。このリリースには、CameraXViewfinder を moveableContentOf や Pager などの Compose 機能で使用する場合に関連する重要なバグの修正や、プレビューの引き伸ばしに関する問題の解決が含まれています。今後のリリースでは、camera-compose にさらに多くの機能を追加していく予定です。
ImageAnalysis と CameraControl の改善
- トーチの強度の調整: 新しい API を使用して、デバイスのトーチを細かく制御できます。CameraInfo.getMaxTorchStrengthLevel() を使用してサポートされている最大強度レベルをクエリし、CameraControl.setTorchStrengthLevel() で目的のレベルを設定できます。
-
ImageAnalysisでの NV21 のサポート:ImageAnalysisから NV21 画像形式を直接リクエストできるようになり、他のライブラリや 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 デベロッパー ヘルプグループに参加するか、バグを報告してください。
続きを読む
-
プロダクト ニュース
Android Studio Panda 4 が安定版となり、本番環境で使用できる準備が整いました。このリリースでは、プランニング モード、次の編集の予測などが導入され、高品質の Android アプリをこれまで以上に簡単に構築できるようになりました。
Matt Dyor • 5 分で読了
-
プロダクト ニュース
革新的な AI 機能をアプリに実装したい Android デベロッパー向けに、強力な新機能がリリースされました。
Thomas Ezan • 3 分で読了
-
プロダクト ニュース
Android 17 がベータ版 4 に到達しました。これは、このリリース サイクルの最後のベータ版であり、アプリの互換性とプラットフォームの安定性にとって重要なマイルストーンです。
Daniel Galpin • 4 分で読了
メールを受け取る
Android 開発に関する最新の分析情報を毎週メールでお届けします。