ARCore für Jetpack XR bietet leistungsstarke Wahrnehmungsfunktionen für Ihre App, mit denen die reale Welt über eine Vielzahl von APIs erfasst werden kann. Einige dieser APIs helfen Ihnen, immersive Funktionen für Geräte wie XR-Headsets und kabelgebundene XR-Brillen zu verbessern. Andere helfen Ihnen, Augmented Reality-Funktionen für Geräte wie KI-Brillen zu verbessern. Wieder andere helfen Ihnen, App-Funktionen für alle Arten von Android XR-Geräten zu verbessern.
Mit ARCore für Jetpack XR können Sie beispielsweise planare Daten abrufen, Inhalte an einem festen Ort im Raum verankern oder eine raumbezogene 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, müssen Sie die erforderlichen Abhängigkeiten hinzufügen, je nachdem, welche Art von App-Erlebnissen Sie mit AR verbessern möchten.
Auf eine Sitzung zugreifen
Die Wahrnehmungsfunktionen in ARCore für Jetpack XR basieren auf einem Session, das die Jetpack XR-Laufzeit verwendet.
Wie Ihre App auf eine Sitzung zugreifen sollte, hängt von den Arten von App-Erlebnissen ab, die Sie mit Wahrnehmungsfunktionen verbessern:
- Wenn Sie mit Jetpack Compose für XR räumliche Benutzeroberflächen für immersive Erlebnisse in Ihrer App entwickeln, können Sie hier auf eine entsprechende Session zugreifen.
- In allen anderen Fällen können Sie über die Jetpack XR-Laufzeit auf eine Sitzung zugreifen. Das wird im folgenden Abschnitt auf dieser Seite beschrieben.
Auf eine Sitzung über die Jetpack XR-Laufzeit zugreifen
Um auf eine Sitzung über die Jetpack XR-Laufzeit zuzugreifen, müssen Sie sie erstellen:
Wenn Sie eine Sitzung erstellen möchten, übergeben Sie eine Aktivität an die Methode create(), wie im folgenden Beispiel gezeigt:
when (val result = Session.create(this)) { is SessionCreateSuccess -> { val xrSession = result.session // ... } else -> TODO(/* A different unhandled exception was thrown. */) }
Wenn die Aktivität einer Sitzung beendet wird, werden alle AR-Inhalte, die mit dieser Sitzung verknüpft sind, ebenfalls beendet 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 Session erforderlich sind. Details zur erforderlichen Konfiguration für die verschiedenen 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 nutzen, um die App-Nutzung auf verschiedenen XR-Geräten zu optimieren:
- Ebenen mit ARCore für Jetpack XR erkennen
- Anker mit ARCore für Jetpack XR erstellen
- Mit Händen arbeiten mit ARCore für Jetpack XR
- Kopfposition mit ARCore für Jetpack XR in Ihre App einbinden
- Mimik-Erkennung mit ARCore für Jetpack XR in Ihre App einbinden
- Tiefeninformationen in Ihrer App mit ARCore für Jetpack XR abrufen
- Geräteposition mit ARCore für Jetpack XR erfassen