Das Jetpack XR SDK enthält alle Tools und Bibliotheken, die Sie zum Erstellen immersiver und Augmented-Reality-Inhalte für Android XR-Geräte benötigen.
Vollständig immersive Erlebnisse bieten
Spezielle High-Fidelity-Geräte wie XR-Headsets und kabelgebundene XR-Datenbrillen als Zielgeräte festlegen. Verwenden Sie moderne Android-Entwicklungstools wie Kotlin und Compose sowie Tools der vorherigen Generation wie Java und Views. Sie können Ihre Benutzeroberfläche räumlich gestalten, 3D-Modelle laden und rendern und die reale Welt semantisch verstehen.
Wenn Sie bereits eine App für Mobilgeräte oder große Bildschirme für Android haben, können Sie sie mit dem Jetpack XR SDK in eine neue Dimension bringen. Dazu werden vorhandene Layouts räumlich dargestellt und Ihre Inhalte mit 3D-Modellen und immersiven Umgebungen erweitert. In unseren Qualitätsrichtlinien findest du Empfehlungen zur Anpassung deiner bestehenden Android-App für Spatial Computing.
Augmented-Reality- und hilfreiche Funktionen entwickeln
Leichte und elegante Audio- und Display-Brillen. Verwenden Sie moderne Android-Entwicklungstools wie Kotlin und Jetpack Compose Glimmer. Verwenden Sie APIs, die die Projektion von App-Inhalten von einem Smartphone auf die Brille ermöglichen.
Jetpack-Bibliotheken verwenden
Die Jetpack XR SDK-Bibliotheken bieten ein umfassendes Toolkit zum Erstellen von umfangreichen, immersiven Erlebnissen, leichtgewichtigen, erweiterten Erlebnissen und allem dazwischen. Die folgenden Bibliotheken sind Teil des Jetpack XR SDK:
- Jetpack Compose for XR: Mit diesem Tool können Sie deklarativ räumliche UI-Layouts erstellen, die die räumlichen Funktionen von Android XR nutzen.
- Material Design für XR: Mit Material-Komponenten und ‑Layouts entwickeln, die sich an XR anpassen.
- Jetpack SceneCore: Android XR-Szenengraf mit 3D-Inhalten erstellen und bearbeiten
- ARCore für Jetpack XR: Mit Wahrnehmungsfunktionen digitale Inhalte in die reale Welt bringen.
- Jetpack Compose Glimmer: Ein UI-Toolkit zum Erstellen von Augmented-Reality-Erlebnissen für Android XR, das für Display-Brillen optimiert ist.
- Jetpack Projected: APIs, die die Projektion von Apps von einem Smartphone auf eine Audio- oder Display-Brille ermöglichen.
API-Entwicklung während der Entwicklervorschau
Die Jetpack XR SDK-Bibliotheken sind Teil der Android XR-Entwicklervorschau. Diese APIs befinden sich noch in der Entwicklung. Bekannte Probleme finden Sie in den Versionshinweisen zur Bibliothek:
- Versionshinweise zu Jetpack Compose for XR
- Versionshinweise zu ARCore for Jetpack XR
- Jetpack SceneCore-Versionshinweise
- Versionshinweise zur XR-Laufzeit
- Versionshinweise zu Jetpack Compose Glimmer
- Geplante Versionshinweise für Jetpack
Wenn ein Problem auftritt, das nicht in einer dieser Listen aufgeführt ist, melden Sie den Fehler bitte oder geben Sie Feedback.
Jetpack Compose für XR
Mit Jetpack Compose for XR können Sie räumliche Komponenten wie Zeilen und Spalten verwenden, um räumliche Benutzeroberflächen und Layouts mit einem vertrauten, deklarativen Compose-Modell zu erstellen.
Diese Bibliothek bietet auch Subspace-Composeables wie räumliche Bereiche und Orbiters, mit denen Sie Ihre vorhandene 2D-Compose- oder ansichtsbasierte UI in einem räumlichen Layout platzieren können. Andere Subspace-Composeables verarbeiten andere Arten von räumlichen Anwendungsfällen, z. B. SceneCoreEntity, mit dem Sie Entitäten wie 3D-Modelle relativ zu Ihrer Benutzeroberfläche platzieren können.
Sie können Jetpack Compose für XR verwenden, unabhängig davon, ob Sie Ihre vorhandene Android-App räumlich gestalten oder eine neue XR-App von Grund auf erstellen.
Weitere Informationen finden Sie im Entwicklerleitfaden für die räumliche Benutzeroberfläche und in der Bibliotheks- und API-Referenzdokumentation.
Material Design für XR
Material Design bietet Komponenten und Layouts, die für XR angepasst werden können. Wenn Sie mit adaptiven Layouts arbeiten. Weitere Informationen zur Implementierung von Material Design für XR
Jetpack SceneCore
Mit der Jetpack SceneCore-Bibliothek können Sie 3D-Inhalte, die durch Entitäten definiert sind, relativ zueinander und zu Ihrer Umgebung platzieren und anordnen. Mit SceneCore können Sie:
- Räumliche Umgebungen festlegen
- Instanzen eines
PanelEntityerstellen - 3D-Modelle platzieren und animieren
- Spatial Audio-Quellen angeben
- Fügen Sie Entitäten Komponenten hinzu, damit sie bewegt und in der Größe angepasst werden können und sich in der realen Welt verankern lassen.
Die Jetpack SceneCore-Bibliothek bietet auch Unterstützung für die Spatialisierung von Anwendungen, die mit Ansichten erstellt wurden. Weitere Informationen finden Sie im Leitfaden zum Arbeiten mit Ansichten.
Weitere Informationen finden Sie in der API-Referenz.
ARCore für Jetpack XR
Die ARCore for Jetpack XR-Bibliothek basiert auf der vorhandenen ARCore-Bibliothek und bietet Funktionen zum Verschmelzen digitaler Inhalte mit der realen Welt. Diese Bibliothek umfasst Bewegungserkennung, persistente Anker, Trefferprüfung und Ebenenerkennung mit semantischen Labels (z. B. Boden, Wände und Tischplatten). Diese Bibliothek nutzt den zugrunde liegenden Wahrnehmungsstack, der von OpenXR unterstützt wird. Dadurch wird die Kompatibilität mit einer Vielzahl von Geräten gewährleistet und Apps werden zukunftssicher.
Weitere Informationen finden Sie unter Mit ARCore für Jetpack XR arbeiten.
Jetpack Compose Glimmer
Jetpack Compose Glimmer ist ein UI-Toolkit zum Erstellen von Augmented-Reality-Android XR-Erlebnissen, die für Display-Brillen optimiert sind. Erstellen Sie ansprechende, minimalistische und komfortable Benutzeroberflächen für Geräte, die den ganzen Tag getragen werden.
- Auf schnelle Erfassbarkeit und Lesbarkeit ausgelegt: Im Gegensatz zu Smartphones ist die primäre Anzeige ein optisches, transparentes Display. Jetpack Compose Glimmer bietet brillenspezifische Designs, vereinfachte Farbpaletten und Typografie, damit Ihre Inhalte gut lesbar, schnell zu verarbeiten und nie ablenkend sind.
- Für Wearable-spezifische Interaktionen optimiert: Wir haben Interaktionsmodelle für die Verwendung von Brillen optimiert. Jetpack Compose Glimmer-Komponenten bieten klare Fokusstatus, z. B. optimierte Umrisse anstelle von ablenkenden Ripple-Effekten, und sind für gängige physische Eingaben wie Tippen, Wischen auf dem Rahmen und natürlich Sprache ausgelegt.
- Vertraute deklarative UI-Muster verwenden: Da Jetpack Compose Glimmer vollständig auf Jetpack Compose basiert, können Sie alles verwenden, was Sie bereits über die deklarative UI-Erstellung in Android wissen. Wir bieten eine vollständige Palette an vordefinierten zusammensetzbaren Kernfunktionen wie Text, Icon, Button und spezialisierte Komponenten wie TitleChip, die alle für die Brille optimiert sind.
Jetpack Projected
Wenn Sie Apps für Audio- und Display-Brillen entwickeln, wird Ihre App auf einem Host-Begleitgerät wie einem Android-Smartphone ausgeführt, das die XR-Inhalte Ihrer App projiziert. Mit Jetpack Projected können diese Android-Hostgeräte mit Audio- oder Display-Brillen kommunizieren, wenn die Hostgeräte XR-Projektionsfunktionen haben.
- Auf projizierte Gerätehardware zugreifen: Ein Gerätekontext, der an das projizierte Gerät (Audio- oder Display-Brille) gebunden ist. Dieser Kontext des Geräts mit der Projektionsfläche bietet Zugriff auf die Hardware des Geräts mit der Projektionsfläche, z. B. die Kamera. Spezielle Aktivitäten, die eigens für die Anzeige auf Audio- oder Display-Brillen erstellt wurden, fungieren bereits als projizierter Kontext. Wenn ein anderer Teil Ihrer App (z. B. eine Smartphone-Aktivität oder ein Dienst) auf die Hardware der Brille zugreifen muss, kann er einen projizierten Kontext abrufen.
- Berechtigungsanfragen vereinfachen: Audio- und Display-Brillen folgen dem Android-Standardberechtigungsmodell. Es gibt brillenspezifische Berechtigungen, die zur Laufzeit angefordert werden müssen, bevor Ihre App auf Gerätehardware wie die Kamera zugreifen kann. Der Berechtigungsassistent optimiert diese Mechanismen für Berechtigungsanfragen sowohl auf dem Smartphone als auch auf der Datenbrille, um eine einheitliche Anfrage zu ermöglichen.
- Geräte- und Displayfunktionen prüfen: Prüfen Sie, ob das projizierte Gerät ein Display hat und ob es visuelle Inhalte darstellen kann. Passen Sie Ihre App an die Funktionen des Geräts an. Beispielsweise möchten Sie möglicherweise mehr Audiokontext bereitstellen, wenn das Gerät kein Display hat oder das Display ausgeschaltet ist.
- Auf Kameraaktionen der App zugreifen: Deine App kann auf Kameraaktionen des Nutzers zugreifen, z. B. um die Kamera in einer Streaming-App ein- oder auszuschalten.
XR-App-Nutzung mit dem Android XR-Emulator testen
Der Android XR-Emulator ist eine spezielle Version des Android-Emulators, die für die Entwicklung von XR-Apps entwickelt wurde. Damit können Sie Ihre XR-Apps in der vertrauten Umgebung von Android Studio testen und debuggen. Sie können virtuelle Geräte für jeden Typ von Android XR-Gerät erstellen, von immersiven Geräten wie XR-Headsets und kabelgebundenen XR-Datenbrillen bis hin zu Smart Glasses wie Audio- und Display-Brillen.
Wenn Sie Ihre App ausführen und Fehler beheben möchten, finden Sie in den folgenden Anleitungen Informationen für den Einstieg:
- Virtuelle Geräte für XR‑Headsets und XR‑Datenbrillen erstellen
- Virtuelle Geräte für Audio- und Display-Brillen erstellen
OpenXR™ und das OpenXR-Logo sind Marken von The Khronos Group Inc. und in China, der Europäischen Union, Japan und dem Vereinigten Königreich als Marken eingetragen.