Jetpack Compose for XR

Android XR の空間機能を活用する空間 UI レイアウトを宣言的に構築します。
最新の更新 安定版リリース リリース候補版 ベータ版リリース アルファ版リリース
2026 年 9 月 23 日 - - 1.0.0-beta01 -

依存関係の宣言

XR Compose への依存関係を追加するには、Google の Maven リポジトリをプロジェクトに追加する必要があります。詳しくは、Google の Maven リポジトリをご覧ください。

アプリまたはモジュールの build.gradle ファイルに、必要なアーティファクトの依存関係を追加します。

Groovy

dependencies {
    implementation "androidx.xr.compose:compose:1.0.0-beta01"

    // Use to write unit tests
    testImplementation "androidx.xr.compose:compose-testing:1.0.0-beta01"
}

Kotlin

dependencies {
    implementation("androidx.xr.compose:compose:1.0.0-beta01")

    // Use to write unit tests
    testImplementation("androidx.xr.compose:compose-testing:1.0.0-beta01")
}

依存関係について詳しくは、ビルド依存関係の追加をご覧ください。

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

バージョン 1.0

バージョン 1.0.0-beta01

2026 年 9 月 23 日

androidx.xr.compose:compose:1.0.0-beta01 と androidx.xr.compose:compose-testing:1.0.0-beta01 がリリースされました。バージョン 1.0.0-beta01 にはこれらの commit が含まれています。

API の変更

  • 非推奨の DragPolicy を削除しました。代わりに SubspaceModifier.movable() を使用してください。（I108d4）
  • 非推奨の ResizePolicy と、SpatialPanel および SpatialExternalSurface でのその使用を削除しました。非推奨の SubspaceModifier.resizable 関数を削除します。代わりに、新しい ResizePolicy を使用して新しい SubspaceModifier.resizable を使用してください。（I59e6b）
  • ピッチ トラッキングを個別に有効または無効にできる isPitchUpdateEnabled パラメータを追加しました。（Ie9e86）
  • pitchLimits の null 可能性を削除し、PitchLimits.UNCONSTRAINED の名前を PitchLimits.FullRange に変更しました。（I0154f）
  • ExposedDropdownMenu がメンバーではなく ExposedDropdownMenuBoxScope の拡張関数になりました。新しいインポートでコードを更新する必要がある場合があります。（Ie8a65）
  • 非推奨の SurfaceProtection クラスを削除しました。代わりに SpatialExternalSurfaceProtection を使用してください。（Iab2c6）
  • OrbiterPoseProvider を受け取る Orbiter 関数は、SpatialAlignment を使用する関数に置き換えられ、非推奨になりました。（I4d12b）
  • SpatialActivityPanel では、埋め込みアクティビティを起動して管理するために SpatialActivityPanelController（rememberSpatialActivityPanelController を使用してインスタンス化）が必要になりました。（Id25c6）
  • rotateToLookAtUser から upDirection パラメータを削除し、回転制約パラメータ（isYawUpdateEnabled と pitchLimits）を追加しました。（I1370a）

バグの修正

  • InteractionPolicy に関するさまざまな問題を修正しました。コンポーザブルまたは子（Orbiter など）が破棄シーケンスを開始した直後に入力イベントが発生すると、クラッシュが発生していました。また、子がホバーイベントを受け取る問題を修正します。（Ifc477）
  • RotateToLookAtUserActivity のパネルサイズを縮小し、視野角の小さいデバイスでクリッピングが発生しないようにしました。（I8d672）

既知の問題

  • Compose XR パネルに問題があり、1 つのアクティビティで多数のパネルを作成すると、パネルが破棄された後でも表示内容が破損する可能性があります。

バージョン 1.0.0-alpha17

2026 年 8 月 12 日

androidx.xr.compose:compose:1.0.0-alpha17 と androidx.xr.compose:compose-testing:1.0.0-alpha17 がリリースされました。バージョン 1.0.0-alpha17 に含まれる commit については、こちらをご覧ください。

API の変更

  • Meter 値クラスを削除します。これは Scenecore の virtualPixelDensity に置き換えられます。（I690ee）
  • SpatialGltfModel API は試験運用版になり、使用するにはオプトインする必要があります。（I4557e）
  • system のサイズ変更可能を null 許容にしました（Ib0093）
  • テスト用に SubspaceSemanticsInfo で Density を公開しました。（I2e826）
  • ResizePolicy のデフォルト オプションの名前を system に変更し、パラメータのない新しい Default オプションを追加しました（Ic8b16）
  • FollowTarget を試験運用版としてマークしました。FollowingSubspace API 全体が試験運用版になりました。（Id4ee3）
  • GltfAnimation API を削除（Ic2894）
  • パラメータ化された MovePolicy.default() メソッドの名前を MovePolicy.system() に変更しました。標準のデフォルトの移動動作を表す val MovePolicy.Default プロパティが導入されました。（Iedcc9）
  • ExperimentalMoveAnchorPolicy のオプトイン要件を PlaneSemantic と PlaneOrientation に拡大（Ief927）
  • VolumeConstraints.offset から resetMins を削除しました（Ib2f2f）
  • 非推奨となった SceneCoreEntitySizeAdapter 関数を削除しました。（Ib6722）
  • allowUnboundedSubspace で非推奨の Subspace オーバーロードを削除しました。（I8e97f）
  • 非推奨のセマンティクス修飾子のオーバーロードを削除しました。（I4ac10）

バグの修正

  • InteractionPolicy がアタッチされた Composable の子要素が入力イベントをトリガーする問題を修正しました（Icdba6）

バージョン 1.0.0-alpha16

2026 年 7 月 15 日

androidx.xr.compose:compose:1.0.0-alpha16 と androidx.xr.compose:compose-testing:1.0.0-alpha16 がリリースされました。バージョン 1.0.0-alpha16 に含まれる commit については、こちらをご覧ください。

API の変更

  • ComponentOverride API を削除しました（I820c4）
  • GltfAnimation API と SpatialGltfModelAnimation API が試験運用版としてマークされました。一部のプロパティがゲッターに変換されました。（I8d689、b/524771027）
  • メートルとピクセルの間の変換を一定にすることで、全体的な密度の動作を修正しました。Meter.kt が非推奨になりました。代わりに Session.scene.virtualPixelDensity を使用できるようになりました。（I122ff、b/430097855、b/474168798）
  • サイズ変更可能な修飾子を更新し、2 つの修飾子ではなく ResizePolicy を使用するようにしました（I7fb0f、b/496257436、b/519672992）
  • SubspaceAssertions.kt のすべての公開浮動小数点ディメンションと位置の等価性アサーションに許容値 Dp = Dp(0.5f) パラメータを追加しました。デフォルトの許容動作（0.5.dp）は完全に文書化されています。（I266cb、b/521491915）
  • movePolicy パラメータを含む移動可能なオーバーロードを追加し、transformingMovable と movable を非推奨にしました（Ic88c1、b/481781189）
  • Material Expressive の仕様に準拠した、標準リストアイテムとセグメント リストアイテムの新しい非インタラクティブ バリエーションを追加しました。表現力の低いバージョンは非推奨になりました。（Ide4de、b/491994186）
  • Subspace では、allowUnboundedSubspace パラメータが非推奨となり、非表示になりました。境界なしの動作は、Subspace 修飾子で SubspaceModifier.requiredSizeIn(maxWidth = Dp.Infinity, maxHeight = Dp.Infinity, maxDepth = Dp.Infinity) を使用して実現するようになりました。FollowingSubspace から allowUnboundedSubspace パラメータが削除されました。（Ia72ae、b/433624021）
  • Session.create を suspend 関数に変換しました。（I5d27f）
  • ExoPlayer または SoundEffectPlayer を介してオーディオ再生を空間化できる SubspaceModifier.spatializedAudioOutput を追加しました（I46697、b/489421980、b/497867019）
  • ComponentActivity.requestHomeSpace() と requestFullSpace() を更新して、ステータス確認用に SpaceRequestResult を返すようにしました。（If1672）
  • AnchorEntity を AnchorSpace と呼ぶように更新しました（Ifa95e、b/513619219）
  • SpatialGltfModelSource からの制限なしの fromResource メソッド（I1f5a1、b/503047416）
  • SubspaceSemanticsMatcher メンバーは公開されています。description プロパティ、コンパニオン ファクトリ メソッド（expectValue、keyIsDefined、keyNotDefined）、メンバー関数（matches、matchesAny）、演算子（and、or、not）。（I972a4、b/460427288）
  • SubspaceModifier.semantics、SubspaceModifier.testTag、SubspaceSemanticsInfo、SubspaceSemanticsModifierNode を更新して、キュレートされた空間セマンティクス型を使用するようにしました。（I80dea、b/460427288）
  • SpatialAlignment で position を align に名前変更し、統一された align API を優先して個々の方向オフセット メソッドを削除しました。（I9bdb2、b/479805937）
  • SpatialConfiguration から非推奨の Space モード API を削除しました。（I1ef5c、b/458712461）
  • SubspaceSemanticsConfiguration を導入しました。これは、Spatial ノードのセマンティクス プロパティの構成です。このクラスは、基盤となる 2D セマンティクス機能を外部のコンシューマーに漏洩させることなく、3D セマンティクスのクエリ メソッドを安全に公開します。（Id025e、b/460427288）
  • SubspaceSemanticsPropertyReceiver を導入しました。これは、3D レイアウト コンテナのプロパティを有効なフィールド（最初は testTag と contentDescription）に制限する専用のラッパーです。（I5cf5c、b/460427288）

バグの修正

  • Semantic 修飾子の hasContentDescription を更新し、デフォルトで部分文字列マッチングを行うようにしました。（I08214）
  • 制限付き FollowBehavior.ExponentialDecay() を追加しました。これは、弾性物理学に沿ったソフト フォロー動作を提供します。（I7449c、b/485639909、b/500493335）

ほとんどの API がこの影響を受けます。具体的には、LocalSession CompositionLocal と LocalSession に依存するすべての CompositionLocals（LocalSpatialConfiguration、LocalSpatialCapabilities など）は、Session が初期化される前に null またはその非 XR バージョンに解決されるようになります。

Session が利用可能になると、正しい状態で再コンポーズがトリガーされます。（I0cfa4、b/514712835、b/514712835）

  • 一時停止の動作、キャンセル、同時実行に関する ComponentActivity.requestHomeSpace と ComponentActivity.requestFullSpace のドキュメントを明確化しました。CancellationException の伝播を検証するようテストを更新しました。（I22f75、b/493289528）

バージョン 1.0.0-alpha15

2026 年 6 月 17 日

androidx.xr.compose:compose:1.0.0-alpha15 と androidx.xr.compose:compose-testing:1.0.0-alpha15 がリリースされました。バージョン 1.0.0-alpha15 に含まれる commit については、こちらをご覧ください。

API の変更

  • ResizePolicy と古いサイズ変更可能な修飾子を非推奨とし、新しい SubspaceModifier.resizable オーバーロードと SubspaceModifier.transformingResizable に置き換えました。（I9e4bc）
  • SpatialGltfModel API を更新しました。SpatialGltfModelSource.fromResource を介してリソースからモデルを読み込むサポートを追加しました。SpatialGltfModelAnimation で speed を playbackSpeed に変更し、resume() メソッドを追加しました。SpatialGltfModelStatus.Loaded と Loading がオブジェクトになりました。（I523de）
  • rotateToLookAtUser を試験運用版 API としてマークしました。（I86c16）
  • 保護された変数 targetCurrentPose をローカル変数 currentTargetPoseMeter に移動して名前を変更しました。（Ia557c）
  • SpatialPanel と SpatialExternalSurface の kdoc を更新して、オブジェクトがレイアウト サイズ内でレンダリングされる場所を含めます（I72104）
  • SpatialGltfModelState 内の SpatialGltfModel 読み込みロジックをカプセル化し、失敗時の動作を明確化しました。（Ibe98b）
  • SubspaceModifer.size KDocs の depth を明確にしました（I0f84f）

バージョン 1.0.0-alpha14

2026 年 5 月 19 日

androidx.xr.compose:compose:1.0.0-alpha14 と androidx.xr.compose:compose-testing:1.0.0-alpha14 がリリースされました。バージョン 1.0.0-alpha14 に含まれる commit については、こちらをご覧ください。

API の変更

  • デフォルトのシステム処理による 3D 動作に transformingMovable を導入し、カスタムの動作を処理する movable の新しいオーバーロードを導入しました。（I50960）
  • SpatialGltfModel.fromData() を削除しました。（I4d083）
  • 新しい修飾子ノード インターフェース SubspaceMeasuredSizeAwareModifierNode を追加しました。これにより、測定パスの後に onRemeasured コールバックが提供されます。SubspaceLayoutAwareModifierNode がこの新しいインターフェースを拡張するようになりました。onSizeChanged 修飾子が onRemeasured を使用するように更新され、コールバックが配置後ではなく測定直後にトリガーされるようになりました。（Iafbae）
  • InteractionPolicy を Interface に更新しました（I0ff30）
  • Compose compileSdk を API 37 に更新しました。つまり、Compose を使用する場合は、AGP の最小バージョンが 9.2.0 である必要があります。（Id45cd）
  • Size の KDocs を更新しました（Iefa9a）

バージョン 1.0.0-alpha13

2026 年 5 月 6 日

androidx.xr.compose:compose:1.0.0-alpha13 と androidx.xr.compose:compose-testing:1.0.0-alpha13 がリリースされました。バージョン 1.0.0-alpha13 に含まれる commit については、こちらをご覧ください。

API の変更

  • Orbiter API には追加の変更が予定されています。Orbiter の非推奨通知を抑制し、今後のリリースでの Orbiter の変更に注意することをおすすめします。
  • SceneCoreEntity を使用して glTF をレンダリングするユーザーは、glTF がレンダリングされるように、GltfModel.create 呼び出しの parent パラメータに session.scene.activitySpace を渡していることを確認する必要があります。
  • デベロッパーが Compose For XR アプリに Gltf を追加できるように、SpatialGltfModel API を追加しました。デベロッパーは、Gltf モデル内のアニメーションとノードをクエリすることもできます。（I8b542、b/495422586）
  • SceneCoreEntitySizeAdapter をクラスからインターフェースに変更（I5a784、b/475292310）
  • SurfaceProtection の名前を SpatialExternalSurfaceProtection に変更しましたSpatialExternalSurface の KDocs を更新しました（Ifad0a、b/485231082）
  • currentWindowAdaptiveInfo を非推奨にし、その V2 を導入（I40ecf、b/424442112）
  • resizable 修飾子が公開され、グループ（SpatialRow など）に適用できるようになりました。（I2bcf6、b/348483527、b/489753178、b/479530787）
  • movable 修飾子が公開されました。この修飾子は、現時点では SpatialPanels と SpatialExternalSurface でうまく機能しますが、すべての SubspaceComposables で適切にサポートされるようにすることが目的です。（I9a3cd、b/479530787、b/478935063、b/478935063）
  • SpatialEnterTransition と SpatialExitTransition を @Immutable としてマーク（If1710、b/487757837）
  • このリリースでは、追加のテストが完了するまで SpatialGltfModel API は制限付きとしてマークされます。（Ibf003、b/466090694）
  • DeviceTrackingMode.LAST_KNOWN の名前を SPATIAL_LAST_KNOWN に変更（非推奨のフォールバック付き）、3DoF トラッキング用に INERTIAL_LAST_KNOWN を追加、TRACKING_DEGRADED を TrackingState に追加しました。（Ie661c、b/445466590）
  • 非推奨の SpatialLayoutSpacer を削除しました（I7b36c）
  • 非推奨のパディング API を削除しました（If1886）
  • バイアス値に floatRange を追加しました。LayoutDirection のデフォルト値を削除しました（I9d74e）

バグの修正

  • SpatialColumn、SpatialRow、SpatialCurvedRow のコードサンプルと KDoc ドキュメントを追加しました。（Iaf54f、b/495777633）

バージョン 1.0.0-alpha12

2026 年 3 月 25 日

androidx.xr.compose:compose:1.0.0-alpha12 と androidx.xr.compose:compose-testing:1.0.0-alpha12 がリリースされました。バージョン 1.0.0-alpha12 に含まれる commit については、こちらをご覧ください。

API の変更

  • glTF をレンダリングしてアニメーションを制御する SpatialGltfModel API と SpatialGltfModelAnimation API を追加しました。SpatialGltfModelState を AutoCloseable に変更しました。リソースを解放するには、閉じる必要があります。（I11fde、b/466065486、b/481379924）。ただし、SpatialGltfModel API は、追加のテストが完了するまで、このリリースでは制限付きとしてマークされます。（Ibf003、b/466090694）
  • 非推奨の空の SubspaceModifier.rotate オーバーロードを追加しました。（Idceb6）
  • SpatialSmoothFeatheringEffect 関数の名前を spatialSmoothFeatheringEffect に変更し、描画モジュールに移動しました。SpatialExternalSurface のデフォルトのフェザリング値を null に更新しました。これにより、以前の ZeroFeatheringEffect の機能が再現されます。（I5fdaa、b/460426800）
  • onPointSourceParamsAvailable を削除しました。別の音声空間化 API が近日中に利用可能になります。（I86507、b/458513439）
  • オフセット サブスペース修飾子の RTL 動作を追加しました。また、レイアウトの方向を無視する absoluteOffset も追加しました。（I30e4b、b/474409165）

バージョン 1.0.0-alpha11

2026 年 2 月 25 日

androidx.xr.compose:compose:1.0.0-alpha11 と androidx.xr.compose:compose-testing:1.0.0-alpha11 がリリースされました。バージョン 1.0.0-alpha11 に含まれる commit については、こちらをご覧ください。

新機能

  • SpatialExternalSurfaces に SuperSampling パラメータを追加（Icd4d1）

既知の問題

  • SceneCore の SurfaceEntity の問題により、SpatialExternalSurface のインスタンスを作成するときにアプリがクラッシュすることがあります。この問題は、androidx.xr.scenecore:scenecore-*:1.0.0-alpha13、androidx.xr.compose:compose:1.0.0-alpha12、およびそれ以降のリリースで解決されています。影響を受けるアプリは最新バージョンに更新する必要があります。

API の変更

  • レイアウト方向を認識するためのサブスペース修飾子のパディング変更。（I53e25）
  • SpatialCapabilities は封印され、延長できなくなりました。（I07aef）
  • 汎用的な SpatialAlignment パラメータを受け取る SpatialRow API と SpatialColumn API は非推奨になりました。代わりに、それぞれ verticalAlignment または horizontalAlignment を受け取る API を SpatialRow と SpatialColumn に使用してください。（Iec390）
  • オーバーロード SubspaceLayout 関数 API の統合（Idd30a）
  • SubspaceModifier.lookAtUser の名前を rotateToLookAtUser に、up パラメータの名前を upDirection に変更しました。（Icafb8）
  • SpatialRow をインライン関数にしました（Ia2f20）
  • SpatialColumn をインライン関数にしました（I681be）
  • ビルボード API を削除しました（Ib76cd）

バージョン 1.0.0-alpha10

2026 年 1 月 28 日

androidx.xr.compose:compose:1.0.0-alpha10 と androidx.xr.compose:compose-testing:1.0.0-alpha10 がリリースされました。バージョン 1.0.0-alpha10 に含まれる commit については、こちらをご覧ください。

API の変更

  • 非推奨になった API - ApplicationSubspace を削除（Ia6596、b/468345186）
  • SpatialShape をシールド インターフェースに更新しました（I7e3f5、b/460426800）
  • SpatialAlignment で非推奨の API を削除しました。（Ib0b61、b/468011887）
  • SpatialLayoutSpacer を非推奨にし、SpatialSpacer を導入します。（I2ebf3、b/466071383）
  • UserSubspace API を更新し、「遅延ロック」という用語を「ソフトロック」に置き換えました。（I9ded1、b/464035984）

バージョン 1.0.0-alpha09

2025 年 12 月 3 日

androidx.xr.compose:compose:1.0.0-alpha09 と androidx.xr.compose:compose-testing:1.0.0-alpha09 がリリースされました。バージョン 1.0.0-alpha09 に含まれる commit については、こちらをご覧ください。

API の変更

  • LookAtUser と Billboard 修飾子を追加。これにより、コンテンツが常にユーザーの方向を向くようになります。（I49b99）
  • InteractionPolicy を SpatialExternalSurfaces と SpatialPanels に設定する機能を追加し、クリックやその他の 3D 入力イベントを検出できるようにします。（Iae155）
  • 幅、高さ、奥行きを Dp 値として指定するサイズと requiredSize 修飾子のオーバーロードを追加しました。（I92f79）
  • ParentLayoutParamsModifier インターフェースが DelegatableSubspaceNode を拡張するようになりました。（I1a6d4）
  • ApplicationSubspace は非推奨となり、Subspace API が推奨されます。
    • Subspace API の動作が変更され、推奨されるポーズとスケールでアプリ全体のサブスペースのみが提供されるようになりました。
    • PlanarEmbeddedSubspace API が導入され、2D コンテキストに埋め込みサブスペースが提供されます。（Id3343）
  • SubspaceModifier.Node API に shouldAutoInvalidate フラグを追加しました。（I93902）
  • required(Size|Width|Depth|Height) を追加しました。これにより、デベロッパーは親の受信測定制約を無視して、@SubspaceComposable のサイズを特定の範囲に制限できます。（Ifaa78）
  • @SubspaceComposable のサイズが変更されたときにデベロッパーが対応するための、シンプルで集約されたコールバックを提供する SubspaceModifier.onSizeChanged を追加しました。（I994f9）
  • Volume API を削除しました。Volume API の代わりに SceneCoreEntity API を使用する必要があります。（I4162b）
  • SubspaceLayoutModifierNode.requestRelayout を invalidateMeasurement/invalidatePlacement に分割します。（I14805）
  • デベロッパーが Compose で glTF をレンダリングできるようにする SpatialGltfModel API を追加しました。（Icc91f）
  • glTF を簡単にレンダリングするための SpatialGltfModel コンポーザブル API を導入しました（Iade67）

バグの修正

  • SceneCoreEntity のレイアウトに関するバグを修正しました。これで、制約が適切に尊重されるようになります。（I11bb8）
  • jxr-compose モジュールを Compile sdk = 34 に下げました（I2d5db）

バージョン 1.0.0-alpha08

2025 年 10 月 22 日

androidx.xr.compose:compose:1.0.0-alpha08 と androidx.xr.compose:compose-testing:1.0.0-alpha08 がリリースされました。バージョン 1.0.0-alpha08 に含まれる commit については、こちらをご覧ください。

API の変更

  • ResizePolicy を変更して、onResizeStart、onResizeUpdate、onResizeEnd を受け入れるようにしました。（I7e21f）

バグの修正

  • サブスペースを含むアクティビティを破棄する際のクラッシュを防止。（I595a1）

バージョン 1.0.0-alpha07

2025 年 9 月 24 日

androidx.xr.compose:compose:1.0.0-alpha07 と androidx.xr.compose:compose-testing:1.0.0-alpha07 がリリースされました。バージョン 1.0.0-alpha07 に含まれる commit については、こちらをご覧ください。

API の変更

  • SpatialMainPanel の KDocs を改善しました。（I27b70、b/444467891）
  • SpatialRow や SpatialColumn などの 3D レイアウトで、主軸に沿って子を配置するための SpatialArrangement を導入しました。この新しい API は、Start、End、Center、SpaceBetween、SpaceAround、SpaceEvenly など、2D Compose の使い慣れた配置オプションを提供し、LTR と RTL の両方のレイアウト方向を完全にサポートします。（I7db38、b/436289959）
  • SubspaceModifier.Node の基本インターフェースを追加し、拡張インターフェースの型安全性とユーザビリティを改善しました。たとえば、
    • CompositionLocalConsumerSubspaceModifierNode
    • LayoutCoordinatesAwareModifierNode
    • SubspaceLayoutModifierNode
    • CoreEntityNode（内部）（Iede00、b/440599394、b/440599394）
  • SpatialExternalSurface の制限を解除（I33315、b/439646773）
  • Subspace コンポーザブルに SubspaceModifier を導入し、制約パラメータを SubspaceModifier からサイズ関連の SubspaceModifiers に置き換えました。allowUnboundedSubspace が true の場合でも、サブスペースに無制限の制約を設定できます。（Ib06e6、b/433331675）
  • DragPolicy() と ResizePolicy() が SpatialPanel と SpatialExternalSurface API の一部になったため、移動可能でサイズ変更可能な SubspaceModifiers を非推奨にしました（I397bf、b/437924639）
  • 空間レイアウトで LayoutDirection のサポートを追加しました。SpatialAlignment を使用するコンポーザブルで、LTR コンテキストと RTL コンテキストの両方で要素が正しく配置されるようになりました。（I964bb、b/436300273）
  • これらの動作がサポートされているコンテナにのみ適用されるように、Panel API に Resizable パラメータと Movable パラメータを追加します。（Id491c）
  • 幅、高さ、奥行きの正確な最小値と最大値の制約を設定できる sizeIn、widthIn、heightIn、depthIn、SubspaceModifiers を追加しました。（I1af09、b/433330761）

バージョン 1.0.0-alpha06

2025 年 8 月 13 日

androidx.xr.compose:compose:1.0.0-alpha06 と androidx.xr.compose:compose-testing:1.0.0-alpha06 がリリースされました。バージョン 1.0.0-alpha06 に含まれる commit については、こちらをご覧ください。

バグの修正

  • ライフサイクル オーナーが破棄されたときに ComposeXrOwnerLocals を再作成します。（9123ce1）

バージョン 1.0.0-alpha05

2025 年 7 月 30 日

androidx.xr.compose:compose:1.0.0-alpha05 と androidx.xr.compose:compose-testing:1.0.0-alpha05 がリリースされました。バージョン 1.0.0-alpha05 に含まれる commit については、こちらをご覧ください。

新機能

  • SubspaceComposable アノテーション クラスを公開にしました。（Ic2a34、b/399432430）
  • 180 度と 360 度の球体を表す 2 つの新しい SpatialExternalSurface コンポーザブル。（I40ef2、b/391705799）
  • SubspaceModifier.aspectRatio を追加しました（Ide5ab、b/399729509、b/414762147）
  • SceneCore と XR 用 Compose の相互運用性を改善するために、SceneCoreEntity API を追加しました。（I50bb3、b/423020989）
  • スケーリングされていない GravityAligned 機能に対応する GravityAlignedsubspace API を提供しました（I07359）

API の変更

  • SpatialDialog() は SpatialDialogProperties.dismissOnBack の押下設定に従います。（Ib453b、b/416797132）
  • メートル単位で表されるため、minimumPanelDimension を新しいデフォルトのディメンション サイズ Dimensions(0.1f, 0.1f, 0.1f) に更新します。（Ib852a）
  • サブスペースとオービターは、ホームスペースとアプリがバックグラウンドにあるときに内部状態を保持するようになります。ホームスペース モードでは、Subspace はフルスペース モードへの切り替えに備えてシーンをセットアップします。（I40317、b/416037751）
  • SpatialDialogs は、アプリがバックグラウンドにあるときに状態を保持するようになりました。（I6aa56）
  • ApplicationSubspace は、推奨されるスケールと位置をシステムから継承するようになりました。（I4565f、b/418834194）
  • SubspaceComposable 以外のコンテキストで SubspaceComposable が使用された場合のエラー メッセージを改善し、エラーを早期にトリガーするようにしました。（Iee2ae、b/416484684）
  • 構成可能な API の誤用時に警告が見落とされることが多いため、ExperimentalSubspaceVolumeApi を Warning から Error に更新しました。（I427aa、b/424864286）
  • サブスペースと ApplicationSubspace は recommendedContentBoxInFullSpace によって制約されるようになりました。以前は SpatialUser の画角によって制約されていました。（I41015、b/423074142）
  • SpatialElevation を更新し、最小サイズを使用することで、ハードコードされたサイズを使用しないようにしました（I2dbe6、b/427785338）
  • キー変数が変更されたときに更新されるように、SpatialAcitivityPanel をスクリムする方法を更新。（I0f64d、b/427999029）
  • デフォルトの制約値を同等の値に設定するため、VolumeConstraints.Unbounded を削除します。（Ie24ec、b/407938414）
  • SpatialFeatheringSize が公開されなくなりました（I1c15b、b/399432430）
  • Compose の Placeable と区別するため、XR の Placeable の名前を SubspacePlaceable に変更しました。（I74874）
  • Orbiter の設定を削除し、新しいパラメータとして shouldRenderInNonSpatial を追加します。また、EdgeOffset クラスを削除し、Orbiter() 関数を統合するための新しいパラメータとして orbiterOffsetType を追加します。また、OrbiterEdge を ContentEdge に名前変更します。（Iebf3d）
  • Compose の Measurable 型と区別するために、Measurable の名前を SubspaceMeasurable に変更しました。（I9726c）
  • MeasureResult の名前を SubspaceMeasureResult に変更しました（I9f34d）
  • Compose の Subspace コンポーザブルで setContent を使用するように変更し、setSubspaceContent API を削除しました。（Ifff4c、b/421427391、b/421427391）
  • MeasurePolicy の名前が SubspaceMeasurePolicy に変更されました。（I37a9b、b/422553904）
  • デフォルトなしではメンバーを追加できないため、SubspaceSemanticsInfo をシール済みインターフェースにします。（I372f9、b/423704068）
  • SpatialExternalSurface のドキュメントを更新し、ContentSecurityLevel の名前を SurfaceProtection に変更しました（I3c460、b/420982808）
  • 移動可能な修飾子にアンカーを設定できるオーバーロードされたコンストラクタを提供しました。（Ic0c70）
  • ツールチップの位置プロバイダを追加しました。これにより、デベロッパーはツールチップをアンカーの上、下、左、右のいずれに配置するかを制御できるようになりました。カレットの Shape を受け取る API を追加し、より多くのカスタム シェイプを提供できるようにしました。（Ie513c、b/374766087、b/418854637）
  • PublishedApi として CoreEntity を削除しました（Ifee05）

バグの修正

  • レンダリング時に SpatialDialog が点滅する問題を修正しました。（Ife73c、b/401619909）
  • SpatialDialog がアクティビティ パネルをスクリムできない問題を修正しました。（I8ca6c、 b/367442109）
  • XR ダイアログで一部のコンテンツが表示されない問題を修正しました（I17cd5、b/418062437）
  • コンテンツ内をクリックすると SpatialPopup が閉じられる問題を修正しました。（If262c、b/417245722）
  • resizable().movable() をチェーンしたときに SpatialPanel が新しいサイズに正しくサイズ変更されない問題を修正しました。（I02ee3、b/422264230）
  • SpatialComposeVideoPlayer で topBar がメニューと重なる問題を修正しました（Id33bc、b/427168167）
  • 角の丸みがレンダリングされない問題を修正しました（I975fe、b/428261830）

バージョン 1.0.0-alpha04

2025 年 5 月 7 日

androidx.xr.compose:compose:1.0.0-alpha04 と androidx.xr.compose:compose-testing:1.0.0-alpha04 がリリースされました。バージョン 1.0.0-alpha04 に含まれる commit については、こちらをご覧ください。

新機能

  • カスタム SubspaceModifier タイプがコンポジション ローカル値にアクセスできるようにする、CompositionLocalConsumerSubspaceModifierNode インターフェースを追加しました。
  • Compose の AndroidView 実装スタイルに準拠した新しい SpatialPanel API を追加し、以前の ViewBased SpatialPanel を非推奨にしました。
  • 制約のない制約を表す VolumeConstraints.Unbounded コンパニオン オブジェクトを追加しました。
  • 空間化された音源を許可する SubspaceModifier.onPointSourceParams を追加しました。
  • 公開 ApplicationSubspace が追加されました。これにより、アプリが空間コンテンツをレンダリングできる 3D 領域を定義するオプションの VolumeConstraints が提供されます。デフォルトでは、制約が指定されていない場合、Subspace は SpatialUser の現在の視野の幅と高さで囲まれます。画角を特定できない場合に使用する制約を指定できます。それ以外の場合は、画角の幅と高さのデフォルト値が使用されます。
  • 立体視コンテンツのレンダリングに使用できる SpatialExternalSurface を追加しました。SpatialExternalSurface は、修飾子（アルファを除く）とエッジのフェザー効果でカスタマイズできます。
  • ユーザーが空間ポインタのアイコンを設定できる新しい pointerHoverIcon サブスペース修飾子を追加しました。

API の変更

  • すべての Jetpack XR パッケージの RequiresApi(34) 制限を削除しました。Jetpack XR は現在 API レベル 34 以上のデバイスでのみ利用できるため、この制限は冗長でした。（Iae0f8）
  • Kotlin 2.0 でリリースされたプロジェクトを使用するには、KGP 2.0.0 以降が必要です。（Idb6b5）
  • 埋め込みアクティビティのない空間パネルで、戻る操作が機能するようになりました。戻る操作を機能させるには、Android マニフェストで android:enableOnBackInvokedCallback="true" を指定する必要があります。
  • 空間ダイアログで戻る操作が機能するようになりました。バックハンドリングを機能させるには、Android マニフェストで android:enableOnBackInvokedCallback="true" を指定する必要があります。
  • Compose ベースと View ベースの SpatialPanel は、コンテンツに基づいてサイズを調整できるようになりました。
  • デベロッパーは、独自のカスタム SpatialElevationLevel 値を設定できるようになり、事前定義されたレベルに制限されなくなりました。
  • elevation パラメータを使用して、オービターの高度レベルをカスタマイズできるようになりました。
  • サブスペースは、デフォルトで SpatialUser の画角の幅と高さで制限できるようになりました。画角を特定できない場合は、画角の幅と高さのデフォルト値が使用されます。
  • Movable 修飾子に新しいコールバック onMoveStart と onMoveEnd を追加しました。onMoveStart コールバックと onMoveEnd コールバックは、ユーザーが移動可能な修飾子を使用してサブスペース コンポーザブルの移動を開始および終了したときに呼び出されます。
  • SpatialRow や SpatialPanel などの空間 API から name パラメータが削除されました。空間コンポーズ ツリーのデバッグには、代わりに SubspaceModifier.testTag を使用します。
  • spatialElevationLevel と content のみを持つ SpatialPopup のサポートされていないオーバーロードを削除しました。onDimissRequest をサポートするインターフェースを使用してください。
  • Movable 修飾子の onPoseChange コールバックが削除されました。代わりに onMove を使用してください
  • SubspaceModifiers は、切り離されている場合や切り離し中の場合は、効果を適用しなくなります。
  • 既存の SpatialRow API が SpatialRow と SpatialCurvedRow に分割されました。以前に SpatialRow の curveRadius パラメータを使用していた場合は、同じ動作を提供する SpatialCurvedRow を代わりに使用してください。
  • 同様に新しいシステム イメージで実行した場合、MainPanel と ActivityPanel にタイトルバーが表示されなくなりました。
  • アルファ修飾子とスケール修飾子がスタック可能になり、最終的に適用されるアルファ値またはスケール値の値を乗算するようになります。
  • Movable 修飾子の onPoseChange コールバックが最適化され、ポーズの動きがよりスムーズになりました。
  • 移動可能およびサイズ変更可能な修飾子は、状態の変更が再コンポーズをトリガーするように、メインスレッドでコールバックを実行するようになりました。
  • レイアウト フェーズと測定フェーズに状態の監視を追加し、SubspaceLayout の状態が変化するとレイアウトが再実行されるようにしました。
  • 既存の修飾子をより適切に再利用できるように、最適化された修飾子チェーンの更新。

バグの修正

  • SpatialDialog が表示されたときにスクリムが停止しました。（Ic4594）
  • 修飾子ノードが切り離されている間に行われたレイアウトの再リクエストは無視されるようになりました。
  • Movable 修飾子と Resizable 修飾子によってトリガーされるレイアウト再設定フェーズを削除しました。
  • MainPanel() コンポーザブルで、ディメンションのいずれかが直接またはレイアウト計算（SpatialRow/SpatialColumn 計算など）中にゼロに設定された場合に発生するクラッシュを修正しました。代わりに、パネルが非表示になります。この修正はレイアウト フェーズでのクラッシュに特に対処するものであり、ユーザー操作によるパネルのサイズ変更は別途処理されます。非表示のパネルに UI アフォーダンスがありません。
  • サイズ変更可能な修飾子からの maintainAspectRatio に関する問題を修正しました。アスペクト比が維持されるようになりました。
  • ネストされたサブスペースが単一フレームで誤った位置に配置される問題を修正しました。
  • 角丸が適用されるべきときに適用されないことがある問題を修正しました。
  • NestedSubspaces が 1 フレームだけ間違った場所に表示されることがなくなります。

バージョン 1.0.0-alpha03

2025 年 2 月 26 日

androidx.xr.compose:compose:1.0.0-alpha03 と androidx.xr.compose:compose-testing:1.0.0-alpha03 がリリースされました。前回のアルファ版からの大きな変更はありません。バージョン 1.0.0-alpha03 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-alpha02

2025 年 2 月 12 日

androidx.xr.compose:compose:1.0.0-alpha02 と androidx.xr.compose:compose-testing:1.0.0-alpha02 がリリースされました。バージョン 1.0.0-alpha02 に含まれる commit については、こちらをご覧ください。

新機能

  • 空間ダイアログがアクティブなときに、アクティビティ パネルのコンテンツをスクリムできるようになりました。
  • Orbiter API が SubspaceComposable コンテキストで使用できるようになり、オービターが最も近い SubspaceLayout ベースのコンポーザブルの親にアタッチされるようになります。
  • カスタムの配置ベースの修飾子を許可する LayoutCoordinatesAwareModifierNode を導入しました。
  • SubspaceModifier.Node にアタッチ/デタッチ ライフサイクル メソッドを追加しました。
  • 移動可能な修飾子に scaleWithDistance を追加しました。scaleWithDistance が有効になっている場合、移動されたサブスペース要素は拡大または縮小されます。また、移動前に設定されていた明示的なスケールも維持されます。

API の変更

  • SessionCallbackProvider を削除し、SpatialCapabilities に置き換えました。

その他の変更

  • minSDK を 24 に減らしました。すべての Jetpack XR API は、引き続き実行時に API 34 を必要とします。
  • Orbiter EdgeOffset.inner、EdgeOffset.outer、EdgeOffset.overlap コンストラクタは @Composable メソッドではなくなり、コンポーザブルでないコンテキストで使用できるようになりました。
  • 最新の UX 仕様に合わせて空間の高度レベルを更新しました。
  • MeasurableLayout に SubspaceSemanticsInfo インターフェースを実装します。
  • SubspaceModifierElement の名前を SubspaceModifierNodeElement に変更しました。

バグの修正

  • SubspaceModifier の順序を安定させるための修正。SubspaceModifier の動作がより安定します。オフセット、回転、拡大縮小、移動可能、サイズ変更可能の修飾子を任意の順序で使用できるようになりました。

バージョン 1.0.0-alpha01

2024 年 12 月 12 日

androidx.xr.compose:compose-*1.0.0-alpha01 がリリースされました。

初回リリースの機能

  • Jetpack Compose for XR のデベロッパー向け初回リリース。既存の 2D アプリを XR に移植する場合でも、XR アプリをゼロから作成する場合でも、行や列などの使い慣れた Compose のコンセプトを使用して、XR で空間 UI レイアウトを作成できます。このライブラリは、サブスペースと空間コンポーザブル（空間パネルやオービターなど）を提供します。これにより、既存の 2D Compose または Views ベースの UI を空間レイアウトに配置できます。Volume サブスペース コンポーザブルが導入され、3D モデルなどの SceneCore エンティティを UI に相対的に配置できるようになりました。詳しくは、デベロッパー ガイドをご覧ください。

    • Subspace: このコンポーザブルはアプリの UI 階層内の任意の場所に配置できるため、ファイル間のコンテキストを失うことなく、2D UI と空間 UI のレイアウトを維持できます。これにより、UI ツリー全体で状態をホイストしたり、アプリを再設計したりすることなく、既存のアプリ アーキテクチャなどのものを XR と他のフォーム ファクタの間で簡単に共有できます。

    • SpatialPanel: スペース パネルは、アプリのコンテンツを表示できるサブスペース コンポーザブルです。たとえば、動画の再生、静止画、その他のコンテンツをスペース パネルに表示できます。

    • オービター: オービターは空間 UI コンポーネントです。対応する空間パネルに接続するように設計されており、その空間パネルに関連するナビゲーションとコンテキスト アクション アイテムが含まれています。たとえば、動画コンテンツを表示する空間パネルを作成した場合、オービター内に動画再生コントロールを追加できます。

    • Volume: UI を基準にして、3D モデルなどの SceneCore エンティティを配置します。

  • 空間レイアウト: SpatialRow、SpatialColumn、SpatialBox、SpatialLayoutSpacer を使用して、複数の空間パネルを作成し、空間レイアウト内に配置できます。SubspaceModifier を使用してレイアウトをカスタマイズします。

  • 空間 UI コンポーネント: これらの要素は 2D UI で再利用できます。空間属性は、空間機能が有効になっている場合にのみ表示されます。

    • SpatialDialog: パネルが z 軸方向に少し奥に移動し、ダイアログが浮き上がって表示されます。
    • SpatialPopUp: パネルが z 軸方向に少し奥に移動し、ポップアップが浮き上がって表示される
    • SpatialElevation: SpatialElevationLevel を設定して標高を追加できます。

  • SpatialCapabilities: ユーザーがアプリやシステムを操作するにつれて、空間機能は変化する可能性があります。また、アプリ自体によって変化することもあります（ホームスペースやフルスペースへの移動など）。問題を回避するには、アプリで LocalSpatialCapabilities.current をチェックして、現在の環境でサポートされている API を特定する必要があります。isSpatialUiEnabled: 空間 UI 要素（SpatialPanel など） isContent3dEnabled: 3D オブジェクト isAppEnvironmentEnabled: 環境 isPassthroughControlEnabled: アプリケーションがパススルー状態を制御できるかどうか isSpatialAudioEnabled: 空間オーディオ

既知の問題

  • 現在、Jetpack Compose for XR を使用するには minSDK 30 が必要です。回避策として、次のマニフェスト エントリ <uses-sdk tools:overrideLibrary="androidx.xr.scenecore, androidx.xr.compose"/> を追加すると、minSDK が 23 の状態でビルドして実行できるようになります。
  • Jetpack XR アプリでは現在、AndroidManifest で android.permission.SCENE_UNDERSTANDING 権限をリクエストする必要があります。
  • マニフェストの PROPERTY_XR_ACTIVITY_START_MODE プロパティを使用してアプリがフルスペースで直接起動される場合、アクティビティ/アプリケーションは最初にホームスペースで開いてから、フルスペースに移行します。
  • Volume コンポーザブルの glTF が、初期状態で間違った位置でちらつくことがあります。
  • 大幅に移動されたパネルで SpatialDialog を使用すると、コンテンツが間違った方向に移動します。