最新のカメラアプリは、強力で重複する機能によって定義されます。ユーザーは、HDR で美しい動画を撮影し、60 FPS で滑らかな動きをキャプチャし、プレビューの手ぶれ補正でスムーズな映像を撮影することを期待しています。多くの場合、これらすべてを同時に行えることを期待しています。
開発者として、現実はもっと複雑であることを私たちは知っています。特定のデバイスが特定の組み合わせを実際にサポートしていることを保証するにはどうすればよいですか？これまで、複数の機能を有効にすることは、多くの場合、ギャンブルでした。個々の機能のサポートを確認することはできますが、それらを組み合わせると、未定義の動作や、最悪の場合、カメラ セッションの失敗につながる可能性があります。この不確実性により、デベロッパーは保守的にならざるを得ず、対応デバイスのユーザーは最高のユーザー エクスペリエンスを利用できなくなります。
たとえば、HDR と 60 FPS の動画を同時に安定してサポートするプレミアム デバイスはごくわずかです。そのため、ほとんどのアプリでは、大半のスマートフォンでユーザー エクスペリエンスが低下するのを防ぐため、両方を同時に有効にすることを避けています。
この問題を解決するため、CameraX の Feature Group を導入します。これは、この推測を不要にするように設計された新しい API です。カメラを構成する前に、特定の機能の組み合わせがサポートされているかどうかをクエリできるようになりました。また、優先順位を CameraX に伝えるだけで、サポートされている最適な組み合わせを有効にすることもできます。
CameraX を初めて使用する方へ
新しい Feature Group API について詳しく説明する前に、CameraX について簡単に振り返っておきましょう。CameraX は、カメラアプリの開発を容易にすることを目的とした Jetpack サポート ライブラリです。ほとんどの Android デバイスで機能する一貫性のある使いやすい API サーフェスを提供するとともに、Android 6.0（API レベル 23）への下位互換性も備えています。CameraX を初めて使用する場合は、公式ドキュメントを確認し、Codelab を試して始めることをおすすめします。
Feature Group API で構築できるもの
機能の組み合わせを推測する必要がなくなり、組み合わせをサポートできないデバイスでエラーを回避しながら、対応するハードウェア（Google Pixel 10 Pro など）で HDR と 60 FPS の動画を同時に撮影するなど、可能な限り最高のカメラ エクスペリエンスを自信を持って提供できます。
Feature Group API を使用すると、次のことができます。
- よりスマートで動的な UI を構築: リアルタイムのハードウェア サポートに基づいて、UI の設定をインテリジェントに有効または無効にします。たとえば、ユーザーが HDR を有効にした場合、そのデバイスでその組み合わせがサポートされていなければ、60 FPS オプションをすぐにグレーアウトして無効にできます。
- 信頼性の高い「高画質」モードを実現: 必要な機能の優先順位付きリストでカメラを構成します。CameraX は、特定のデバイスに最適なサポート対象の組み合わせを自動的に検出して有効にします。これにより、複雑なデバイス固有のロジックなしで優れた結果が得られます。
- カメラ セッションの失敗を防ぐ: サポートを事前に確認することで、カメラがサポートされていない組み合わせを構成しようとするのを防ぎ、クラッシュの一般的な原因を排除して、スムーズなユーザー エクスペリエンスを提供します。
仕組み: コア コンポーネント
新しい API は、SessionConfig と CameraInfo へのキー追加を中心に構成されています。
- GroupableFeature: この API は、HDR_HLG10、FPS_60、PREVIEW_STABILIZATION、IMAGE_ULTRA_HDR などの、グループ化可能な一連の事前定義された機能を導入します。計算上の制約により、この API が提供する信頼性の高いグループ化が可能なのは、特定の一連の機能のみです。YouTube では現在、このリストの拡大に取り組んでおり、今後のリリースでさらに多くの機能のサポートを導入する予定です。
- 新しい SessionConfig パラメータ: カメラ セッションの開始に使用されるこのクラスで、2 つの新しいパラメータが使用できるようになりました。
requiredFeatureGroup: 構成を成功させるためにサポートが必須の機能に使用します。ユーザーが明示的に有効にする機能（「HDR」スイッチの切り替えなど）に最適です。決定論的で一貫したエクスペリエンスを確保するため、リクエストされた組み合わせが対象外の場合、bindToLifecycle呼び出しは機能リクエストを無視するのではなく、IllegalArgumentExceptionをスローします。この結果を事前にクエリするには、CameraInfo#isFeatureGroupSupportedAPI（詳細は下記）を使用する必要があります。preferredFeatureGroup: 望ましいがオプションの機能に使用します。たとえば、デフォルトの「高画質」モードを実装する場合などです。必要な機能のリストを優先順位に従って並べ替えて提供すると、CameraX はデバイスがサポートする最も優先順位の高い組み合わせを自動的に有効にします。
- CameraInfo#isFeatureGroupSupported(): これは、機能グループがサポートされているかどうかを明示的に確認するためのコアクエリ メソッドです。アプリの UI でサポートされている機能オプションのみをユーザーに提供する場合に最適です。
SessionConfigを渡すと、その組み合わせがサポートされているかどうかを示すブール値が返されます。必要な機能を備えたSessionConfigをバインドする場合は、まずこの API を使用して、その機能がサポートされていることを確認する必要があります。
実装の実際
これらのコンポーネントを使用して、カメラ エクスペリエンスを向上させる方法を見てみましょう。
シナリオ 1: 「ベスト エフォート」高品質モード
可能な限り最適な機能をデフォルトで有効にするには、優先順位付きのリストを preferredFeatureGroup に指定します。この例では、CameraX に HDR、60 FPS、プレビューの手ぶれ補正の順に優先順位を設定するよう指示しています。CameraX は、考えられるすべての組み合わせをチェックし、デバイスがサポートする最適な組み合わせを選択する複雑な処理を行います。
たとえば、デバイスが HDR と 60 FPS を同時に処理できるが、プレビューの安定化は処理できない場合、CameraX は最初の 2 つを有効にして、3 つ目を破棄します。これにより、複雑なデバイス固有のチェックを記述することなく、最適なエクスペリエンスを実現できます。
cameraProvider.bindToLifecycle(
lifecycleOwner,
cameraSelector,
SessionConfig(
useCases = listOf(preview, videoCapture),
// The order of features in this list determines their priority.
// CameraX will enable the best-supported combination based on these
// priorities: HDR_HLG10 > FPS_60 > Preview Stabilization.
preferredFeatureGroup =
listOf(HDR_HLG10, FPS_60, PREVIEW_STABILIZATION),
).apply {
// (Optional) Get a callback with the enabled features
// to update your UI.
setFeatureSelectionListener { selectedFeatures ->
updateUiIndicators(selectedFeatures)
}
}
)このコード スニペットでは、CameraX は次の優先順位で機能の組み合わせを有効にしようとし、デバイスが完全にサポートする最初の組み合わせを選択します。
- HDR + 60 FPS + プレビューの手ぶれ補正
- HDR + 60 FPS
- HDR + プレビューの手ぶれ補正
- HDR
- 60 FPS + プレビューの手ぶれ補正
- 最大 60 FPS
- プレビューの手ぶれ補正
- 上記の機能以外
シナリオ 2: リアクティブ UI を構築する
ユーザーの選択に応答し、サポートされていない機能の組み合わせをユーザーが選択できないようにする UI を作成するには、サポートを直接クエリします。次の関数は、ユーザーの現在の選択と互換性のない機能をチェックし、対応する UI 要素を無効にできるようにします。
/**
* Returns a list of features that are NOT supported in combination
* with the currently selected features.
*/
fun getUnsupportedFeatures(
currentFeatures: Set<GroupableFeature>
): Set<GroupableFeature> {
val unsupportedFeatures = mutableSetOf<GroupableFeature>()
val appFeatureOptions = setOf(HDR_HLG10, FPS_60, PREVIEW_STABILIZATION)
// Iterate over every available feature option in your app.
appFeatureOptions.forEach { featureOption ->
// Skip features the user has already selected.
if (currentFeatures.contains(featureOption)) return@forEach
// Check if adding this new feature is supported.
val isSupported = cameraInfo.isFeatureGroupSupported(
SessionConfig(
useCases = useCases,
// Check the new feature on top of existing ones.
requiredFeatureGroup = currentFeatures + featureOption
)
)
if (!isSupported) {
unsupportedFeatures.add(featureOption)
}
}
return unsupportedFeatures
}このロジックを ViewModel または UI コントローラに接続して、ユーザー入力に応答し、動作が保証された構成でカメラを再バインドできます。
// Invoked when user turns some feature on/off.
fun onFeatureChange(currentFeatures: Set<GroupableFeature>) {
// Identify features that are unsupported with the current selection.
val unsupportedFeatures = getUnsupportedFeatures(currentFeatures)
// Update app UI so that users can't enable them.
updateDisabledFeatures(unsupportedFeatures)
// Since the UI now only allows selecting supported feature combinations,
// `currentFeatures` is always valid. This allows setting
// `requiredFeatureGroup` directly, without needing to re-check for
// support or set a feature selection listener.
cameraProvider.bindToLifecycle(
lifecycleOwner,
cameraSelector,
SessionConfig(
useCases = listOf(preview, videoCapture),
requiredFeatureGroup = currentFeatures,
)
)
}これらのコンセプトを動作するアプリで確認するには、内部テストアプリをご覧ください。このアプリでは、上記の「ベスト エフォート」と「リアクティブ UI」の両方のシナリオが完全に実装されています。
注: これはテスト アプリケーションであり、公式にサポートされているサンプルではありません。Feature Group API の優れたリファレンスですが、本番環境での使用向けに調整されていません。
今すぐ始めましょう
Feature Group API を使用すると、高度なカメラ機能の操作における曖昧さが解消されます。機能サポートをクエリする決定論的な方法を提供することで、より強力で信頼性の高いカメラアプリを自信を持って構築できます。
この API は CameraX 1.5 で試験運用版として提供されており、1.6 リリースで完全に安定版となる予定です。今後、サポートの追加や改善も予定されています。
詳しくは、公式ドキュメントをご覧ください。皆様の創造性あふれる作品を楽しみにしています。また、皆様からのフィードバックもお待ちしております。ご意見、ご要望、問題の報告は、次の方法でお送りいただけます。
-
プロダクト ニュースGoogle Play では、サブスクリプション プラットフォームを継続的に拡大し、成長の促進、新しいビジネスモデルへの適応、ユーザーのニーズへの対応をサポートしています。
Sheenam Mittal • 所要時間: 4 分 -
プロダクト ニュース昨年、Android Studio はあらゆる AI モデルに対応しました。本日、Google はコーディング エージェントの選択をサポートすることで、次のステップに進みます。
Matthew Warner • 所要時間: 3 分 -
プロダクト ニュースGooglebook は、共有 Android 基盤上に構築された新しいカテゴリのノートパソコンです。HP、Dell、Lenovo、Acer、Asus などのパートナーの高性能ハードウェアは、モバイルの利便性とデスクトップのパワーを兼ね備えています。
Fahd Imtiaz, Loryn Hairston • 所要時間: 4 分
Android 開発に関する最新の分析情報を毎週メールでお届けします。
