Jetpack Compose na potrzeby XR

Deklarowanie zależności

Aby dodać zależność od XR Compose, musisz dodać do projektu repozytorium Maven Google. Więcej informacji znajdziesz w artykule Repozytorium Maven Google.

Dodaj zależności dotyczące potrzebnych artefaktów w pliku build.gradle aplikacji lub modułu:

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

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

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

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

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Prześlij opinię

Twoja opinia pomoże nam ulepszyć Jetpacka. Jeśli odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nową kartę, zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz oddać głos na istniejący problem, klikając przycisk gwiazdki.

Tworzenie nowego problemu

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Wersja 1.0

Wersja 1.0.0-alpha15

17 czerwca 2026 r.

Publikacja androidx.xr.compose:compose:1.0.0-alpha15 i androidx.xr.compose:compose-testing:1.0.0-alpha15 Wersja 1.0.0-alpha15 zawiera te zmiany.

Zmiany w interfejsie API

• Wycofaliśmy ResizePolicy i stary modyfikator zmiany rozmiaru, zastępując je nowym przeciążeniem SubspaceModifier.resizable i SubspaceModifier.transformingResizable. (I9e4bc)
• Zaktualizowane interfejsy API SpatialGltfModel: dodano obsługę wczytywania modeli z zasobów za pomocą SpatialGltfModelSource.fromResource. Zmieniono nazwę parametru speed na playbackSpeed w SpatialGltfModelAnimation i dodano metodę resume(). SpatialGltfModelStatus.Loaded i Loading są teraz obiektami. (I523de)
• Oznaczono interfejs API rotateToLookAtUser jako eksperymentalny. (I86c16)
• Przeniesiono i zmieniono nazwę chronionej zmiennej targetCurrentPose na zmienną lokalną currentTargetPoseMeter. (Ia557c)
• Zaktualizuj dokumenty SpatialPanel i SpatialExternalSurface, aby uwzględnić miejsce renderowania obiektu w ramach jego rozmiaru układu (I72104).
• Zamknięto logikę wczytywania SpatialGltfModel w SpatialGltfModelState i wyjaśniono zachowanie w przypadku błędu. (Ibe98b)
• Wyjaśniono depth w SubspaceModifer.size kdocs (I0f84f)

Wersja 1.0.0-alpha14

19 maja 2026 r.

Publikacja androidx.xr.compose:compose:1.0.0-alpha14 i androidx.xr.compose:compose-testing:1.0.0-alpha14 Wersja 1.0.0-alpha14 zawiera te zmiany.

Zmiany w interfejsie API

• Wprowadzono transformingMovable do obsługi domyślnego ruchu 3D przez system i nowe przeciążenie dla movable do obsługi niestandardowych zachowań ruchu. (I50960)
• Pole „SpatialGltfModel.fromData()” zostało usunięte. (I4d083)
• Dodaliśmy nowy interfejs węzła modyfikatora SubspaceMeasuredSizeAwareModifierNode, który zapewnia wywołanie zwrotne onRemeasured po przejściu pomiaru. SubspaceLayoutAwareModifierNode obejmuje teraz ten nowy interfejs. Modyfikator onSizeChanged został zaktualizowany, aby używać onRemeasured. Dzięki temu wywołanie zwrotne jest uruchamiane bezpośrednio po pomiarze, a nie po umieszczeniu. (Iafbae)
• Zaktualizowano InteractionPolicy do Interface (I0ff30)
• Zaktualizowano Compose compileSdk do interfejsu API 37. Oznacza to, że podczas korzystania z Compose wymagana jest minimalna wersja AGP 9.2.0. (Id45cd)
• Zaktualizowano dokumenty kdocs Size (Iefa9a)

Wersja 1.0.0-alpha13

6 maja 2026 r.

Publikacja androidx.xr.compose:compose:1.0.0-alpha13 i androidx.xr.compose:compose-testing:1.0.0-alpha13 Wersja 1.0.0-alpha13 zawiera te zmiany.

Zmiany w interfejsie API

• Interfejs Orbiter API oczekuje dodatkowych zmian, dlatego zalecamy pomijanie komunikatów o wycofaniu Orbiterów i śledzenie zmian w Orbiterach w nadchodzących wersjach.
• Osoby, które używają SceneCoreEntity do renderowania plików glTF, powinny przekazywać session.scene.activitySpace do parametru parent wywołania GltfModel.create, aby mieć pewność, że pliki glTF będą renderowane.
• Dodanie interfejsu SpatialGltfModel API, który umożliwi deweloperom dodawanie plików GLTF do aplikacji Compose For XR. Deweloperzy mogą też wysyłać zapytania dotyczące animacji i węzłów w modelach GLTF. (I8b542, b/495422586)
• Zmiana SceneCoreEntitySizeAdapter z klasy na interfejs (I5a784, b/475292310)
• Zmieniono nazwę SurfaceProtection na SpatialExternalSurfaceProtection. Zaktualizowano SpatialExternalSurface dokumenty w Google Docs (Ifad0a, b/485231082)
• Wycofaj currentWindowAdaptiveInfo i wprowadź jego wersję 2 (I40ecf, b/424442112).
• Modyfikator resizable jest teraz publiczny i ma zastosowanie do grup (np. SpatialRow). (I2bcf6, b/348483527, b/489753178, b/479530787)
• Modyfikator movable jest teraz dostępny publicznie. Ten modyfikator działa obecnie dobrze w przypadku SpatialPanels i SpatialExternalSurface, ale zamierzamy zapewnić jego prawidłowe działanie w przypadku wszystkich SubspaceComposables. (I9a3cd, b/479530787, b/478935063, b/478935063)
• SpatialEnterTransition i SpatialExitTransition oznaczone jako @Immutable (If1710, b/487757837)
• Interfejs SpatialGltfModel API jest oznaczony jako ograniczony w tej wersji do czasu przeprowadzenia dodatkowych testów. (Ibf003, b/466090694)
• Zmieniono nazwę DeviceTrackingMode.LAST_KNOWN na SPATIAL_LAST_KNOWN (z wycofanym elementem zastępczym), dodano INERTIAL_LAST_KNOWN do śledzenia 3DoF i dodano TRACKING_DEGRADED do TrackingState. (Ie661c, b/445466590)
• Usuwanie wycofanej funkcji SpatialLayoutSpacer (I7b36c)
• Usunięto wycofany interfejs API do wypełniania (If1886)
• Dodano floatRange do wartości odchylenia. Usunięto domyślną wartość atrybutu LayoutDirection (I9d74e)

Poprawki błędów

• Dodaliśmy przykłady kodu i dokumentację KDoc dla funkcji SpatialColumn, SpatialRow i SpatialCurvedRow. (Iaf54f, b/495777633)

Wersja 1.0.0-alpha12

25 marca 2026 r.

Publikacja androidx.xr.compose:compose:1.0.0-alpha12 i androidx.xr.compose:compose-testing:1.0.0-alpha12 Wersja 1.0.0-alpha12 zawiera te zmiany.

Zmiany w interfejsie API

• Dodaj interfejs SpatialGltfModel API i interfejsy SpatialGltfModelAnimation API, aby renderować pliki glTF i sterować animacjami. Zmieniono SpatialGltfModelState na AutoCloseable. Aby zwolnić zasoby, należy teraz zamknąć to okno. (I11fde, b/466065486, b/481379924). Interfejs SpatialGltfModel API jest jednak oznaczony jako ograniczony w tej wersji do czasu przeprowadzenia dodatkowych testów. (Ibf003, b/466090694)
• Dodaliśmy wycofane puste przeciążenie funkcji SubspaceModifier.rotate. (Idceb6)
• Zmieniliśmy nazwę funkcji SpatialSmoothFeatheringEffect na spatialSmoothFeatheringEffect i przenieśliśmy ją do modułu rysowania. Zaktualizowano SpatialExternalSurface domyślną wartość rozmycia do wartości null, co naśladuje działanie starej funkcji ZeroFeatheringEffect. (I5fdaa, b/460426800)
• Kontakt onPointSourceParamsAvailable został usunięty. W najbliższej przyszłości udostępnimy inny interfejs API do przestrzennego odtwarzania dźwięku. (I86507, b/458513439)
• Dodano działanie od prawej do lewej w przypadku modyfikatorów podprzestrzeni przesunięcia. Dodano też absoluteOffset, aby ignorować kierunek układu. (I30e4b, b/474409165)

Wersja 1.0.0-alpha11

25 lutego 2026 r.

Publikacja androidx.xr.compose:compose:1.0.0-alpha11 i androidx.xr.compose:compose-testing:1.0.0-alpha11 Wersja 1.0.0-alpha11 zawiera te zmiany.

Nowe funkcje

• Dodawanie parametru SuperSampling do parametru SpatialExternalSurfaces (Icd4d1)

Znane problemy

• Problem z SurfaceEntity w SceneCore może powodować awarie aplikacji podczas tworzenia instancji SpatialExternalSurface. Ten problem został rozwiązany w wersjach androidx.xr.scenecore:scenecore-*:1.0.0-alpha13 i androidx.xr.compose:compose:1.0.0-alpha12 oraz w ich kolejnych wersjach. Aplikacje, których dotyczy problem, powinny zostać zaktualizowane do najnowszych wersji.

Zmiany w interfejsie API

• Zmiany dopełnienia modyfikatora podprzestrzeni w celu uwzględnienia kierunku układu. (I53e25)
• SpatialCapabilities jest już zamknięty i nie można go przedłużyć. (I07aef)
• Interfejsy API SpatialRow i SpatialColumn, które akceptują ogólny parametr SpatialAlignment, zostały wycofane. Zamiast nich używaj interfejsów API, które akceptują odpowiednio parametry verticalAlignment lub horizontalAlignment dla interfejsów SpatialRow i SpatialColumn. (Iec390)
• Łączenie interfejsów API funkcji przeciążania SubspaceLayout (Idd30a)
• Zmieniono nazwę SubspaceModifier.lookAtUser na rotateToLookAtUser, a parametr up na upDirection. (Icafb8)
• Przekształcanie SpatialRow w funkcję wbudowaną (Ia2f20)
• Przekształcanie funkcji SpatialColumn w funkcję wbudowaną (I681be)
• Usunięto interfejs API billboardu (Ib76cd)

Wersja 1.0.0-alpha10

28 stycznia 2026 r.

Publikacja androidx.xr.compose:compose:1.0.0-alpha10 i androidx.xr.compose:compose-testing:1.0.0-alpha10 Wersja 1.0.0-alpha10 zawiera te zmiany.

Zmiany w interfejsie API

• Usunięcie wycofanego interfejsu API – ApplicationSubspace (Ia6596, b/468345186)
• Zaktualizowano SpatialShape do interfejsu zamkniętego (I7e3f5, b/460426800)
• Usuwanie wycofanych interfejsów API w SpatialAlignment. (Ib0b61, b/468011887)
• Wycofujemy SpatialLayoutSpacer i wprowadzamy SpatialSpacer. (I2ebf3, b/466071383)
• Zaktualizowano interfejs UserSubspace API, aby zastąpić termin „lazy locking” terminem „soft locking”. (I9ded1, b/464035984)

Wersja 1.0.0-alpha09

3 grudnia 2025 r.

Publikacja androidx.xr.compose:compose:1.0.0-alpha09 i androidx.xr.compose:compose-testing:1.0.0-alpha09 Wersja 1.0.0-alpha09 zawiera te zmiany.

Zmiany w interfejsie API

• Dodanie modyfikatorów LookAtUser i Billboard, które sprawiają, że treść jest zawsze skierowana do użytkownika. (I49b99)
• Dodaje możliwość ustawienia InteractionPolicy na SpatialExternalSurfaces i SpatialPanels, co umożliwia wykrywanie kliknięć i innych zdarzeń wejściowych 3D. (Iae155)
• Dodano przeciążenie rozmiaru i modyfikatora requiredSize z szerokością, wysokością i głębokością jako wartościami Dp. (I92f79)
• Interfejs ParentLayoutParamsModifier jest teraz rozszerzony o DelegatableSubspaceNode. (I1a6d4)
• Interfejs ApplicationSubspace został wycofany i zastąpiony interfejsem Subspace API.
  • Działanie interfejsu Subspace API zostało zmienione tak, aby udostępniać tylko podprzestrzeń w skali całej aplikacji w zalecanej pozycji i skali.
  • Wprowadzamy interfejs PlanarEmbeddedSubspace API, który umożliwia osadzanie podprzestrzeni w kontekstach 2D. (Id3343)
• Dodano flagę shouldAutoInvalidate do interfejsu API SubspaceModifier.Node. (I93902)
• Dodano required(Size|Width|Depth|Height)W interfejsach API, które umożliwiają deweloperom ograniczenie rozmiaru elementu @SubspaceComposabledo określonego zakresu, z pominięciem przychodzących ograniczeń pomiarowych elementu nadrzędnego. (Ifaa78)
• Dodano SubspaceModifier.onSizeChanged, który zapewnia deweloperom prosty, ukierunkowany wywołanie zwrotne, aby mogli reagować na zmiany rozmiaru @SubspaceComposable. (I994f9)
• Usunięto interfejs Volume API. Zamiast interfejsu Volume API należy używać interfejsu SceneCoreEntity API. (I4162b)
• Podziel SubspaceLayoutModifierNode.requestRelayout na invalidateMeasurement/invalidatePlacement. (I14805)
• Dodano interfejs SpatialGltfModel API, który umożliwia programistom renderowanie plików glTF w kompozycji. (Icc91f)
• Wprowadziliśmy SpatialGltfModel interfejs API do łatwego renderowania plików glTF (Iade67).

Poprawki błędów

• Naprawiono błąd układu w SceneCoreEntity. Powinien teraz prawidłowo uwzględniać ograniczenia. (I11bb8)
• Obniż poziom modułów jxr-compose do Compile sdk = 34 (I2d5db)

Wersja 1.0.0-alpha08

22 października 2025 r.

Publikacja androidx.xr.compose:compose:1.0.0-alpha08 i androidx.xr.compose:compose-testing:1.0.0-alpha08 Wersja 1.0.0-alpha08 zawiera te zmiany.

Zmiany w interfejsie API

• Zmieniono ResizePolicy, aby akceptować onResizeStart, onResizeUpdate i onResizeEnd. (I7e21f)

Poprawki błędów

• Zapobieganie awariom podczas niszczenia aktywności z przestrzenią podrzędną. (I595a1)

Wersja 1.0.0-alpha07

24 września 2025 r.

Publikacja androidx.xr.compose:compose:1.0.0-alpha07 i androidx.xr.compose:compose-testing:1.0.0-alpha07 Wersja 1.0.0-alpha07 zawiera te zmiany.

Zmiany w interfejsie API

• Ulepszone dokumenty KDocs dla SpatialMainPanel. (I27b70, b/444467891)
• Wprowadzono SpatialArrangement do rozmieszczania elementów podrzędnych wzdłuż osi głównej w układach 3D, takich jak SpatialRow i SpatialColumn. Ten nowy interfejs API udostępnia znane opcje rozmieszczenia z 2D Compose, w tym Start, End, Center, SpaceBetween, SpaceAround i SpaceEvenly, z pełną obsługą kierunków układu od lewej do prawej i od prawej do lewej. (I7db38, b/436289959)
• Dodano interfejs podstawowy dla SubspaceModifier.Node, aby zwiększyć bezpieczeństwo typów i użyteczność interfejsów rozszerzeń, takich jak:
  • CompositionLocalConsumerSubspaceModifierNode
  • LayoutCoordinatesAwareModifierNode
  • SubspaceLayoutModifierNode
  • CoreEntityNode (wewnętrzny) (Iede00, b/440599394, b/440599394)
• Usuń ograniczenia SpatialExternalSurface (I33315, b/439646773)
• Wprowadź SubspaceModifier do funkcji kompozycyjnych Subspace i zastąp parametr ograniczeń parametrem SubspaceModifier powiązanym z rozmiarem SubspaceModifiers. Jeśli allowUnboundedSubspace ma wartość Prawda, podprzestrzenie mogą nadal mieć nieograniczone ograniczenia. (Ib06e6, b/433331675)
• Wycofanie funkcji przenoszenia i zmiany rozmiaru SubspaceModifiers, ponieważ DragPolicy() i ResizePolicy() są teraz częścią interfejsów SpatialPanel i SpatialExternalSurface API (I397bf, b/437924639)
• Dodaliśmy obsługę właściwości LayoutDirection w układach przestrzennych. Komponent SpatialAlignment będzie teraz prawidłowo pozycjonować elementy w kontekstach od lewej do prawej i od prawej do lewej. (I964bb, b/436300273)
• Dodaj do interfejsów Panel API parametry Resizable i Movable, aby mieć pewność, że te zachowania można stosować tylko w przypadku obsługiwanych kontenerów. (Id491c)
• Dodano atrybuty sizeIn, widthIn, heightIn, depthIn SubspaceModifiers, które umożliwiają ustawienie dokładnych minimalnych i maksymalnych ograniczeń szerokości, wysokości i głębokości. (I1af09, b/433330761)

Wersja 1.0.0-alpha06

13 sierpnia 2025 r.

Publikacja androidx.xr.compose:compose:1.0.0-alpha06 i androidx.xr.compose:compose-testing:1.0.0-alpha06 Wersja 1.0.0-alpha06 zawiera te zmiany.

Poprawki błędów

• Ponownie utwórz ComposeXrOwnerLocals, gdy właściciel cyklu życia zostanie zniszczony. (9123ce1)

Wersja 1.0.0-alpha05

30 lipca 2025 r.

Publikacja androidx.xr.compose:compose:1.0.0-alpha05 i androidx.xr.compose:compose-testing:1.0.0-alpha05 Wersja 1.0.0-alpha05 zawiera te zmiany.

Nowe funkcje

• Udostępniono publicznie klasę adnotacji SubspaceComposable. (Ic2a34, b/399432430)
• Dwa nowe komponenty SpatialExternalSurface reprezentujące sfery 180 i 360 stopni. (I40ef2, b/391705799)
• Dodano SubspaceModifier.aspectRatio (Ide5ab, b/399729509, b/414762147)
• Dodano interfejs SceneCoreEntity API, aby zwiększyć interoperacyjność między SceneCore a Compose for XR. (I50bb3, b/423020989)
• Udostępniliśmy interfejs GravityAlignedsubspace API do obsługi funkcji bez skalowania i GravityAligned (I07359).

Zmiany w interfejsie API

• SpatialDialog() będzie zgodny z konfiguracją naciśnięcia SpatialDialogProperties.dismissOnBack. (Ib453b, b/416797132)
• Zaktualizuj wartość minimumPanelDimension do nowego domyślnego rozmiaru wymiaru Dimensions(0.1f, 0.1f, 0.1f) ze względu na jego reprezentację w metrach. (Ib852a)
• Podprzestrzenie i Orbiter będą teraz zachowywać swój stan wewnętrzny w przestrzeni domowej i gdy aplikacja działa w tle. W trybie obszaru domowego Subspace nadal będzie konfigurować scenę w ramach przygotowań do przejścia na tryb pełnego obszaru. (I40317, b/416037751)
• SpatialDialogs zachowają teraz swój stan, gdy aplikacja będzie działać w tle. (I6aa56)
• Urządzenie ApplicationSubspace będzie teraz dziedziczyć zalecaną skalę i pozycję z systemu. (I4565f, b/418834194)
• Dodaliśmy lepszy komunikat o błędzie i wcześniej wywołujemy błąd, gdy w kontekście innym niż SubspaceComposable używany jest znak SubspaceComposable. (Iee2ae, b/416484684)
• Zmieniamy ExperimentalSubspaceVolumeApi z ostrzeżenia na błąd, ponieważ ostrzeżenia są często pomijane w przypadku nieprawidłowego użycia interfejsów API z możliwością komponowania. (I427aa, b/424864286)
• Przestrzeń podrzędna i ApplicationSubspace są teraz ograniczone przez recommendedContentBoxInFullSpace. Wcześniej był on ograniczony polem widzenia SpatialUser. (I41015, b/423074142)
• Zaktualizuj SpatialElevation, aby używać minimalnego rozmiaru i nie używać już zakodowanego na stałe rozmiaru (I2dbe6, b/427785338)
• Zaktualizuj sposób, w jaki sprawdzamy SpatialAcitivityPanel, aby aktualizować go, gdy zmieniana jest kluczowa zmienna. (I0f64d, b/427999029)
• Usuń VolumeConstraints.Unbounded i ustaw domyślne wartości ograniczeń na równoważne. (Ie24ec, b/407938414)
• SpatialFeatheringSize nie jest już publiczny (I1c15b, b/399432430)
• Zmieniliśmy nazwę XR Placeable na SubspacePlaceable, aby odróżnić ją od Placeable w Compose. (I74874)
• Usunięcie ustawień Orbiter i dodanie shouldRenderInNonSpatial jako nowego parametru. Dodatkowo usuwamy klasę EdgeOffset i dodajemy orbiterOffsetType jako nowy parametr, aby ujednolicić funkcje Orbiter(). Oprócz zmiany nazwy OrbiterEdge na ContentEdge. (Iebf3d)
• Nazwa Measurable została zmieniona na SubspaceMeasurable, aby odróżnić ten typ od typu Measurable w narzędziu Compose. (I9726c)
• Zmień nazwę MeasureResult na SubspaceMeasureResult (I9f34d)
• Usunięto interfejs API setSubspaceContent na rzecz używania komponentu setContent w Compose z komponentem Subspace. (Ifff4c, b/421427391, b/421427391)
• Nazwa MeasurePolicy została zmieniona na SubspaceMeasurePolicy. (I37a9b, b/422553904)
• Przekształć SubspaceSemanticsInfo w zamknięty interfejs, ponieważ bez ustawień domyślnych nie będziemy mogli dodawać członków. (I372f9, b/423704068)
• Zaktualizowano dokumentację SpatialExternalSurface, zmieniono nazwę ContentSecurityLevel na SurfaceProtection (I3c460, b/420982808)
• Dodano przeciążony konstruktor modyfikatora przenośnego, który umożliwia zakotwiczenie. (Ic0c70)
• Dodaliśmy więcej dostawców pozycji dla etykietek, dzięki czemu deweloperzy mogą teraz określać, czy etykietka ma być umieszczana nad, pod, po lewej czy po prawej stronie elementu zakotwiczonego. Dodaj interfejs API, który przyjmuje kształt karetki, aby można było podać więcej niestandardowych kształtów. (Ie513c, b/374766087, b/418854637)
• Usunięto CoreEntity jako PublishedApi (Ifee05)

Poprawki błędów

• Rozwiązaliśmy problem polegający na tym, że podczas renderowania symbol SpatialDialog migał. (Ife73c, b/401619909)
• Rozwiązaliśmy problem polegający na tym, że SpatialDialog nie mógł przyciemnić panelu aktywności. (I8ca6c, b/367442109)
• Naprawiono problem z wyświetlaniem niektórych treści w oknie XR (I17cd5, b/418062437)
• Rozwiązaliśmy problem polegający na tym, że po kliknięciu w treści zamykało się okno SpatialPopup. (If262c, b/417245722)
• Rozwiązaliśmy problem polegający na tym, że podczas łączenia resizable().movable() panel SpatialPanel nie zmieniał prawidłowo rozmiaru. (I02ee3, b/422264230)
• Naprawiono nakładanie się elementu topBar na menu w SpatialComposeVideoPlayer (Id33bc, b/427168167)
• Stały promień narożnika nie jest renderowany (I975fe, b/428261830)

Wersja 1.0.0-alpha04

7 maja 2025 r.

Publikacja androidx.xr.compose:compose:1.0.0-alpha04 i androidx.xr.compose:compose-testing:1.0.0-alpha04 Wersja 1.0.0-alpha04 zawiera te zmiany.

Nowe funkcje

• Dodano interfejs CompositionLocalConsumerSubspaceModifierNode, który umożliwia niestandardowym typom SubspaceModifier dostęp do lokalnych wartości kompozycji.
• Dodaliśmy nowy interfejs API SpatialPanel, który jest zgodny ze stylem implementacji AndroidView i wycofuje poprzedni interfejs ViewBased SpatialPanel.
• Dodaliśmy obiekt towarzyszący VolumeConstraints.Unbounded, który reprezentuje nieograniczone ograniczenia.
• Dodano SubspaceModifier.onPointSourceParams, aby umożliwić przestrzenne źródło dźwięku.
• Dodano publiczny element ApplicationSubspace, który oferuje opcjonalny element VolumeConstraints do zdefiniowania obszaru 3D, w którym aplikacja może renderować treści przestrzenne. Domyślnie, jeśli nie określono żadnych ograniczeń, podprzestrzeń będzie ograniczona bieżącym polem widzenia elementu SpatialUser pod względem szerokości i wysokości. Użytkownicy mogą podać ograniczenia, które będą używane, jeśli nie można określić pola widzenia. W przeciwnym razie używane są domyślne wartości szerokości i wysokości pola widzenia.
• Dodano SpatialExternalSurface, którego można używać do renderowania treści stereoskopowych. SpatialExternalSurface można dostosować za pomocą modyfikatorów (z wyjątkiem przezroczystości) i efektu rozmycia krawędzi.
• Dodaliśmy nowy pointerHoverIconmodyfikator podprzestrzeni, który umożliwia użytkownikom ustawienie ikony wskaźnika przestrzennego.

Zmiany w interfejsie API

• Usunięto ograniczenie RequiresApi(34) we wszystkich pakietach Jetpack XR. To ograniczenie było zbędne, ponieważ Jetpack XR jest obecnie dostępny tylko na urządzeniach z poziomem API 34 lub wyższym. (Iae0f8)
• Projekty wydane w Kotlinie 2.0 wymagają użycia KGP w wersji 2.0.0 lub nowszej. (Idb6b5)
• Obsługa przycisku Wstecz będzie teraz działać w przypadku paneli przestrzennych bez osadzonych aktywności. Aby działała obsługa przycisku Wstecz, w manifeście Androida musisz określić android:enableOnBackInvokedCallback="true".
• Funkcja cofania będzie teraz działać w przestrzennych oknach. Aby działało cofanie, musisz określić android:enableOnBackInvokedCallback="true" w manifeście Androida.
• Komponenty SpatialPanel oparte na kompozycji i widoku mogą teraz dostosowywać swój rozmiar do zawartości.
• Deweloperzy mogą teraz ustawiać własne wartości SpatialElevationLevel i nie są ograniczeni do wstępnie zdefiniowanych poziomów.
• Poziom orbity można teraz dostosowywać za pomocą parametru elevation.
• Podprzestrzeń może być teraz domyślnie ograniczona polem widzenia SpatialUser pod względem szerokości i wysokości. Jeśli nie można określić pola widzenia, używane są domyślne wartości szerokości i wysokości pola widzenia.
• Dodano nowe wywołania zwrotne onMoveStart i onMoveEnd do modyfikatora Movable. Wywołania zwrotne onMoveStart i onMoveEnd są wywoływane, gdy użytkownik zaczyna i kończy przesuwanie elementu kompozycyjnego podprzestrzeni za pomocą modyfikatora movable.
• Parametr name został usunięty z interfejsów API przestrzennych, takich jak SpatialRow i SpatialPanel. Do debugowania drzew kompozycji przestrzennych używaj zasady SubspaceModifier.testTag.
• Usunięto nieobsługiwane przeciążenie funkcji SpatialPopup, które ma tylko parametry spatialElevationLevel i content. Użyj interfejsu, który obsługuje onDimissRequest.
• Wywołanie zwrotne onPoseChange z modyfikatora Movable zostało usunięte. Użyj w zamian zasady onMove.
• SubspaceModifiers nie będą już stosować efektów, jeśli są odłączone lub właśnie się odłączają.
• Dotychczasowy interfejs API SpatialRow został podzielony na SpatialRow i SpatialCurvedRow. Jeśli wcześniej używasz parametru SpatialRowcurveRadius, teraz używaj parametru SpatialCurvedRow, który działa tak samo.
• MainPanel i ActivityPanel nie mają już pasków tytułu, gdy są uruchamiane na podobnie aktualnym obrazie systemu.
• Modyfikatory przezroczystości i skali można teraz łączyć, a ich wartości będą mnożone, aby uzyskać ostateczną wartość przezroczystości lub skali.
• onPoseChange Wywołanie zwrotne z modyfikatora Movable zostało zoptymalizowane pod kątem płynniejszego ruchu w pozycji.
• Modyfikatory, które można przesuwać i zmieniać ich rozmiar, będą teraz wywoływać swoje wywołania zwrotne w głównym wątku, aby zmiany stanu powodowały rekompozycję.
• Dodano obserwację stanu do faz układu i pomiaru, aby zmiany stanu w SubspaceLayout powodowały ponowne ułożenie.
• Zoptymalizowane aktualizacje łańcucha modyfikatorów, które umożliwiają lepsze ponowne wykorzystywanie istniejących modyfikatorów.

Poprawki błędów

• Zatrzymanie przyciemniania po wyświetleniu ikony SpatialDialog. (Ic4594)
• Żądania ponownego układu wysyłane, gdy węzły modyfikatora są odłączone, będą teraz ignorowane.
• Usunięto fazy zmiany układu wywoływane przez modyfikatory Movable i Resizable.
• Naprawiliśmy awarię w funkcji kompozycyjnej MainPanel(), która występowała, gdy jeden z wymiarów był ustawiony na zero, bezpośrednio lub podczas obliczania układu, np. obliczania SpatialRow/SpatialColumn. Panel zostanie teraz ukryty. Pamiętaj, że ta poprawka dotyczy konkretnie awarii podczas fazy układu. Zmiana rozmiaru panelu na zero w wyniku interakcji użytkownika będzie obsługiwana osobno. Ukryty panel nie ma elementów interfejsu.
• Rozwiązanie problemu z symbolem maintainAspectRatio w przypadku modyfikatora o zmienianym rozmiarze. Współczynnik proporcji powinien zostać zachowany.
• Rozwiązaliśmy problem z zagnieżdżonymi podprzestrzeniami, które były nieprawidłowo pozycjonowane w przypadku pojedynczej klatki.
• Rozwiązaliśmy problem polegający na tym, że zaokrąglone rogi czasami nie były stosowane, gdy powinny.
• NestedSubspaces nie będzie już wyświetlać się w nieprawidłowej lokalizacji przez 1 klatkę.

Wersja 1.0.0-alpha03

26 lutego 2025 r.

Wersje androidx.xr.compose:compose:1.0.0-alpha03 i androidx.xr.compose:compose-testing:1.0.0-alpha03 nie zawierają żadnych istotnych zmian w porównaniu z ostatnią wersją alfa. Wersja 1.0.0-alpha03 zawiera te zmiany.

Wersja 1.0.0-alpha02

12 lutego 2025 r.

Publikacja androidx.xr.compose:compose:1.0.0-alpha02 i androidx.xr.compose:compose-testing:1.0.0-alpha02 Wersja 1.0.0-alpha02 zawiera te zmiany.

Nowe funkcje

• Panel aktywności może teraz przyciemniać swoją zawartość, gdy aktywne jest okno przestrzenne.
• Interfejs Orbiter API jest teraz dostępny w kontekstach SubspaceComposable i będzie dołączać elementy Orbiters do najbliższego elementu nadrzędnego opartego na SubspaceLayout.
• Wprowadzono LayoutCoordinatesAwareModifierNode, aby umożliwić stosowanie niestandardowych modyfikatorów opartych na pozycjonowaniu.
• Dodaliśmy metody cyklu życia dołączania/odłączania do SubspaceModifier.Node.
• Do modyfikatora ruchomego dodano element scaleWithDistance. Gdy opcja scaleWithDistance jest włączona, przeniesiony element podprzestrzeni powiększy się lub zmniejszy. Zachowa też skalę, którą miał przed przeniesieniem.

Zmiany w interfejsie API

• Usunięto SessionCallbackProvider na rzecz SpatialCapabilities.

Inne zmiany

• Zmniejszono minSDK do 24. Wszystkie interfejsy Jetpack XR API nadal wymagają interfejsu API 34 w czasie działania.
• Konstruktory Orbiter EdgeOffset.inner, EdgeOffset.outer i EdgeOffset.overlap nie są już @Composable metodami, co umożliwia ich używanie w kontekstach niekomponowalnych.
• Zaktualizuj poziomy wysokości przestrzennej, aby były zgodne z najnowszą specyfikacją UX.
• Zaimplementuj interfejs SubspaceSemanticsInfo w usłudze MeasurableLayout.
• Zmieniono nazwę SubspaceModifierElement na SubspaceModifierNodeElement.

Poprawki błędów

• Poprawki stabilizujące zamawianie SubspaceModifier. SubspaceModifier powinna działać bardziej niezawodnie. Modyfikatory przesunięcia, obrotu, skalowania, przenoszenia i zmiany rozmiaru powinny być teraz używane w dowolnej kolejności.

Wersja 1.0.0-alpha01

12 grudnia 2024 r.

Publikacja androidx.xr.compose:compose-*1.0.0-alpha01

Funkcje pierwszej wersji

• Pierwsza wersja Jetpack Compose na XR dla deweloperów. Używaj znanych koncepcji Compose, takich jak wiersze i kolumny, aby tworzyć przestrzenne układy interfejsu w XR. Możesz przenieść istniejącą aplikację 2D do XR lub utworzyć nową aplikację XR od podstaw. Ta biblioteka udostępnia kompozycje podprzestrzenne i przestrzenne, takie jak panele przestrzenne i orbity, które umożliwiają umieszczanie istniejącego interfejsu 2D opartego na Compose lub widokach w układzie przestrzennym. Wprowadza komponent Volume subspace, który umożliwia umieszczanie elementów SceneCore, takich jak modele 3D, względem interfejsu. Więcej informacji znajdziesz w tym przewodniku dla programistów:

  • Subspace: ten komponent można umieścić w dowolnym miejscu w hierarchii interfejsu aplikacji, co pozwala zachować układy interfejsu 2D i przestrzennego bez utraty kontekstu między plikami. Ułatwia to udostępnianie elementów takich jak istniejąca architektura aplikacji między XR a innymi urządzeniami bez konieczności przenoszenia stanu przez całe drzewo interfejsu lub przebudowywania aplikacji.

  • SpatialPanel: panel przestrzenny to komponent przestrzenny, który umożliwia wyświetlanie treści aplikacji. Możesz na przykład wyświetlać odtwarzanie wideo, obrazy statyczne lub inne treści w panelu przestrzennym.

  • Orbiter: orbiter to przestrzenny komponent interfejsu. Jest przeznaczony do dołączania do odpowiedniego panelu przestrzennego i zawiera elementy nawigacyjne oraz czynności kontekstowe związane z tym panelem. Jeśli na przykład utworzysz panel przestrzenny do wyświetlania treści wideo, możesz dodać elementy sterujące odtwarzaniem wideo w orbiterze.

  • Objętość: umieszczaj elementy SceneCore, takie jak modele 3D, względem interfejsu.

• Układ przestrzenny: możesz utworzyć wiele paneli przestrzennych i umieścić je w układzie przestrzennym za pomocą SpatialRow, SpatialColumn, SpatialBox i SpatialLayoutSpacer. Użyj SubspaceModifier, aby dostosować układ.

• Komponenty interfejsu przestrzennego: te elementy można ponownie wykorzystać w interfejsie 2D, a ich atrybuty przestrzenne będą widoczne tylko wtedy, gdy włączone są funkcje przestrzenne.

  • SpatialDialog: panel lekko się cofnie w głąb, aby wyświetlić wysunięte okno.
  • SpatialPopUp: panel zostanie lekko przesunięty do tyłu w osi Z, aby wyświetlić wyskakujące okienko.
  • SpatialElevation: parametr SpatialElevationLevel można ustawić tak, aby dodać wysokość.

• SpatialCapabilities: możliwości przestrzenne mogą się zmieniać w miarę interakcji użytkowników z aplikacją lub systemem, a nawet być zmieniane przez samą aplikację – na przykład podczas przechodzenia do przestrzeni domowej lub pełnej. Aby uniknąć problemów, aplikacja musi sprawdzać wartość LocalSpatialCapabilities.current, aby określić, które interfejsy API są obsługiwane w bieżącym środowisku. isSpatialUiEnabled: elementy interfejsu przestrzennego (np.SpatialPanel); isContent3dEnabled: obiekty 3D; isAppEnvironmentEnabled: środowisko; isPassthroughControlEnabled: czy aplikacja może kontrolować stan przekazywania; isSpatialAudioEnabled: dźwięk przestrzenny.

Znane problemy

• Obecnie do korzystania z Jetpack Compose XR wymagany jest pakiet SDK o minimalnej wersji 30. Aby obejść ten problem, możesz dodać ten wpis w pliku manifestu <uses-sdk tools:overrideLibrary="androidx.xr.scenecore, androidx.xr.compose"/>, aby móc tworzyć i uruchamiać aplikację z wersją minSDK 23.
• Aplikacje Jetpack XR wymagają obecnie w pliku AndroidManifest uprawnienia android.permission.SCENE_UNDERSTANDING.
• Gdy aplikacja uruchamia się bezpośrednio w pełnej przestrzeni za pomocą właściwości PROPERTY_XR_ACTIVITY_START_MODE w pliku manifestu, działania/aplikacje są początkowo otwierane w przestrzeni domowej, a potem przechodzą do pełnej przestrzeni.
• Pliki glTF w komponentach Volume Composables mogą początkowo migać w niewłaściwym miejscu.
• Użycie elementu SpatialDialog w panelu, który został znacznie przesunięty, spowoduje przesunięcie treści w niewłaściwym kierunku.