Mit ARCore for Jetpack XR stehen Ihrer App leistungsstarke Wahrnehmungsfunktionen zur Verfügung, mit denen sie die reale Welt über eine Vielzahl von APIs erfassen kann. Einige dieser APIs helfen Ihnen, immersive Erlebnisse für Geräte wie XR‑Headsets und kabelgebundene XR‑Brillen zu verbessern, andere helfen Ihnen, Augmented-Reality-Erlebnisse für Geräte wie KI‑Brillen zu verbessern, und wieder andere helfen Ihnen, App-Erlebnisse für alle Arten von Android XR‑Geräten zu verbessern.
Mit ARCore for Jetpack XR können Sie beispielsweise planare Daten abrufen, Inhalte an einem festen Ort im Raum verankern oder eine geospatiale Pose verwenden, um Inhalte an einem realen Ort zu verankern.
Bibliotheksabhängigkeiten hinzufügen
Bevor Sie mit der Verwendung von Wahrnehmungsfunktionen in Ihrer XR‑App beginnen, fügen Sie die erforderlichen Abhängigkeitenhinzu. Das hängt davon ab, welche Arten von App-Erlebnissen Sie mit AR verbessern möchten .
Auf eine Sitzung zugreifen
Die Wahrnehmungsfunktionen in ARCore for Jetpack XR basieren auf einer Session, die
die Jetpack XR Runtime verwendet.
Wie Ihre App auf eine Sitzung zugreifen sollte, hängt von den Arten von App-Erlebnissen ab, die Sie mit Wahrnehmungsfunktionen verbessern:
- Wenn Ihre App immersive Erlebnisse mit räumlicher UI mithilfe von Jetpack Compose for XR verbessert, greifen Sie über Jetpack Compose for XR auf eine Sitzung zu.
- In allen anderen Fällen können Sie über die Jetpack XR Runtime auf eine Sitzung zugreifen. Das wird im folgenden Abschnitt auf dieser Seite beschrieben.
Über die Jetpack XR Runtime auf eine Sitzung zugreifen
Wenn Sie über die Jetpack XR Runtime auf eine Sitzung zugreifen möchten, müssen Sie sie erstellen:
Übergeben Sie dazu ein [Context] an die create()
Methode. Dies Context kann ein Activity auf immersiven XR‑Geräten oder
Mobilgeräten oder ein projizierter Kontext sein.
Das Erstellen einer ARCore-Sitzung kann aufwendig sein und sollte im Hintergrund erfolgen, wie in folgendem Beispiel gezeigt:
when (val result = Session.create(context)) { is SessionCreateSuccess -> { val xrSession = result.session // ... } else -> TODO(/* A different unhandled exception was thrown. */) }
Wenn die Aktivität einer Sitzung beendet wird, werden alle mit dieser Sitzung verknüpften AR‑Inhalte gelöscht und die Sitzung ist nicht mehr gültig.
Sitzung konfigurieren
Einige Funktionen sind möglicherweise standardmäßig deaktiviert und müssen konfiguriert werden, damit sie funktionieren. Verwenden Sie configure(), um eine Sitzung zu konfigurieren, und geben Sie die
Konfigurationsoptionen an, die für Ihre Session erforderlich sind. Weitere Informationen zur erforderlichen Konfiguration für verschiedene AR‑Funktionen finden Sie auf den entsprechenden Seiten für die einzelnen AR‑Funktionen.
Nächste Schritte
Nachdem Ihre App eine Sitzung hat, können Sie sie auf verschiedene Weise verwenden, um App-Erlebnisse für verschiedene XR‑Geräte zu verbessern:
- Ebenen mit ARCore for Jetpack XR erkennen
- Anker mit ARCore for Jetpack XR erstellen
- Mit ARCore for Jetpack XR mit Händen arbeiten
- Mimik-Erkennung mit ARCore for Jetpack XR in Ihre App einbinden
- Tiefeninformationen mit ARCore for Jetpack XR in Ihrer App abrufen
- Pose eines Geräts mit ARCore for Jetpack XR verfolgen