折りたたみ式デバイスでは、開いた状態の大型ディスプレイと独自の折りたたみ状態により、新しいユーザー エクスペリエンスを実現します。Jetpack Compose でアプリを折りたたみ対応にするには、Compose Material 3 Adaptive ライブラリを使用します。このライブラリは、折りたたみ式デバイスの折り目、ヒンジ、デバイスの姿勢などのウィンドウ機能用の API を提供します。アプリを折りたたみ対応にすると、レイアウトを調整して、重要なコンテンツが折り目またはヒンジの領域に配置されることを回避したり、折り目またはヒンジを自然な区切り要素として使用したりすることができます。
デバイスがテーブルトップ形状やブック形状などの構成をサポートしているかどうかを把握することで、さまざまなレイアウトのサポートや特定の機能の提供に関する決定を導くことができます。
ウィンドウ情報
Jetpack Compose では、collectFoldingFeaturesAsState() コンポーズ可能な関数を使用して、ウィンドウの折りたたみ情報をモニタリングします。collectFoldingFeaturesAsState() は、WindowInfoTracker から現在のウィンドウの折りたたみ機能を収集し、FoldingFeature オブジェクトのリストを含む Compose State に格納します。
collectFoldingFeaturesAsState() は Compose の State を返すため、デバイスの折りたたみ状態やポスチャーが変化するたびに、コンポーザブルが自動的に再コンポーズされます。手動でのライフサイクル管理や Flow の収集は必要ありません。
@Composable
fun FoldAwareScreen() {
val foldingFeatures by collectFoldingFeaturesAsState()
// Access folding features for the current window.
val foldFeature = foldingFeatures.firstOrNull()
if (foldFeature != null) {
// Adapt layout based on the fold feature.
}
}
折りたたみ式ディスプレイの機能
collectFoldingFeaturesAsState()(DisplayFeature のサブタイプ)によって返される FoldingFeature 要素のリストは、次のようなプロパティとして、折りたたみ式ディスプレイに関する情報を提供します。
state: デバイスの折りたたみ状態(FLATまたはHALF_OPENED)orientation: 折り目またはヒンジの向き(HORIZONTALまたはVERTICAL)isSeparating: 折り目またはヒンジが 2 つの論理ディスプレイ領域を生成するかどうか(true または false)
HALF_OPENED 状態の折りたたみ式デバイスは、画面が 2 つのディスプレイ領域に分割されているため、常に isSeparating を true として報告します。また、デュアル スクリーン デバイスでは、アプリが両方の画面にまたがっている場合、isSeparating は常に true になります。
FoldingFeature の bounds プロパティ(DisplayFeature から継承される)は、折り目やヒンジなどの折りたたみ機能の境界四角形を表します。この境界を使用して、折りたたみ機能からの相対位置に画面上の要素を配置できます。
@Composable
fun FoldFeatureDemo() {
val foldingFeatures by collectFoldingFeaturesAsState()
val foldFeature = foldingFeatures.firstOrNull()
if (foldFeature != null) {
val isSeparating = foldFeature.isSeparating
val occlusionType = foldFeature.occlusionType
val bounds = foldFeature.bounds
// Use bounds and properties to position content.
}
}
テーブルトップ ポスチャー
FoldingFeature オブジェクトに含まれる情報を使用して、アプリはテーブルトップなどの形状に対応することができます。テーブルトップとは、スマートフォンが平面に置かれ、ヒンジが水平位置で、折りたたみ式画面が半分開いた状態です。
テーブルトップ ポスチャーでは、スマートフォンを手に持たずに簡単に操作できます。テーブルトップのポスチャーは、メディアの再生、写真の撮影、ビデオ通話に最適です。
collectFoldingFeaturesAsState() の FoldingFeature.State と FoldingFeature.Orientation を使用して、デバイスがテーブルトップの形状かどうかを判断します。
@Composable
fun TabletopContent() {
val foldingFeatures by collectFoldingFeaturesAsState()
val foldFeature = foldingFeatures.firstOrNull()
val isTableTopPosture = foldFeature != null &&
foldFeature.state == FoldingFeature.State.HALF_OPENED &&
foldFeature.orientation == FoldingFeature.Orientation.HORIZONTAL
if (isTableTopPosture) {
// Tabletop layout: separate content and controls across the fold.
} else {
// Standard layout.
}
}
また、currentWindowAdaptiveInfoV2() から返される Posture プロパティをチェックして、ウィンドウがテーブルトップ ポスチャーかどうかを判断することもできます。
val adaptiveInfo = currentWindowAdaptiveInfoV2()
val isTabletop = adaptiveInfo.windowPosture.isTabletop
デバイスがテーブルトップ形状であることを確認したら、それに応じてアプリのレイアウトを更新します。メディアアプリの場合は、通常、ハンズフリーで視聴できるように、スクロールせずに見える範囲に再生を配置し、そのすぐ下にコントロールと補足コンテンツを配置します。
例
MediaPlayerActivityアプリ: Media3 Exoplayer と WindowManager を使用して折りたたみ対応の動画プレーヤーを作成する方法をご覧ください。さまざまなフォーム ファクタに合わせてメディア コンテンツをスケーリングする: Media3 を使用して Jetpack Compose でウィンドウ インセット、動的なウィンドウ サイズ設定、コンテンツのスケーリングを処理する方法について説明します。
Codelab「Jetpack WindowManager を使用して折りたたみ式デバイスのカメラアプリを最適化する」: 写真アプリにテーブルトップの形状を実装する方法を学びます。画面の上半分(スクロールせずに見える範囲)にビューファインダーを表示し、下半分にコントロールを表示します。
ブック形状
折りたたみ式ならではのもう 1 つの機能としてブックモードがあります。ブックモードとは、デバイスが半分開き、ヒンジが垂直の状態です。ブック形状は電子書籍を読むのに最適です。大きい折りたたみ式画面を製本された本のように開いて 2 ページ レイアウトにするブックモードでは、本物の本を読むようなエクスペリエンスを提供できます。
また、写真撮影に使用すれば、ハンズフリーで写真を撮る際に異なるアスペクト比でキャプチャすることもできます。
ブックポスチャーの実装方法はテーブルトップ ポスチャーと同じです。折りたたみ機能の向きが水平ではなく垂直であることを確認します。
@Composable
fun BookContent() {
val foldingFeatures by collectFoldingFeaturesAsState()
val foldFeature = foldingFeatures.firstOrNull()
val isBookPosture = foldFeature != null &&
foldFeature.state == FoldingFeature.State.HALF_OPENED &&
foldFeature.orientation == FoldingFeature.Orientation.VERTICAL
if (isBookPosture) {
// Book posture layout: two-page layout across the vertical fold.
} else {
// Standard single-page layout.
}
}
ウィンドウ サイズの変更
アプリのディスプレイ領域は、デバイス設定の変更に伴って変化する可能性があります。これには、デバイスが折りたたまれたとき、広げられたとき、回転されたとき、マルチウィンドウ モードでサイズが変更されたときなどがあります。
現在のウィンドウ サイズクラスを取得し、Jetpack Compose のサイズ変更に適応するには、Compose Material 3 Adaptive ライブラリの currentWindowAdaptiveInfoV2() コンポーズ可能な関数を使用します。currentWindowAdaptiveInfoV2() は、現在のウィンドウの WindowSizeClass(デフォルトで大および特大のブレークポイントをサポート)と、デバイスの windowPosture を提供する WindowAdaptiveInfo インスタンスを返します。
@Composable
fun AdaptiveApp() {
val adaptiveInfo = currentWindowAdaptiveInfoV2()
val windowSizeClass = adaptiveInfo.windowSizeClass
when {
windowSizeClass.isWidthAtLeastBreakpoint(
WIDTH_DP_EXPANDED_LOWER_BOUND
) -> {
// Expanded layout
}
windowSizeClass.isWidthAtLeastBreakpoint(
WIDTH_DP_MEDIUM_LOWER_BOUND
) -> {
// Medium layout
}
else -> {
// Compact layout
}
}
}
ウィンドウ サイズクラスを使用するをご覧ください。
参考情報
折りたたみ対応レイアウトと折りたたみ式デバイスについて詳しくは、以下のリソースをご覧ください。
サンプル
- Jetpack WindowManager サンプル: Jetpack WindowManager ライブラリの使用方法の例
- Jetcaster: Compose によるテーブルトップ形状の実装
Codelab
- Jetpack WindowManager による折りたたみ式デバイスとデュアル スクリーン デバイスのサポート
- Jetpack WindowManager を使用して折りたたみ式デバイスのカメラアプリを最適化する