L'API ARCore Depth est désormais compatible avec Geospatial Depth, ce qui augmente automatiquement la portée et la vitesse de cette API lorsque Streetscape Geometry est également activé. Dans un emplacement où la couverture VPS est activée et où Streetscape Geometry est activé, les images de sortie de l'API Depth incluent le relief et la géométrie des bâtiments récupérés dans la zone jusqu'à 65 mètres de la position actuelle. Ces données de profondeur récupérées à partir de la géométrie sont fusionnées avec les observations de profondeur locales et mises à jour lorsque l'utilisateur change de lieu.
<ph type="x-smartling-placeholder"> <ph type="x-smartling-placeholder">
Les appels d'API ARCore Depth fournissent désormais les observations locales de l'appareil photo, ainsi que les bâtiments et le relief de Streetscape Geometry, fusionnés en une seule représentation de profondeur.
Compatibilité avec les appareils
Geospatial Depth est disponible sur tous les appareils compatibles avec l'API Depth. Cette fonctionnalité ne nécessite pas de capteur de profondeur matériel compatible, comme un capteur de temps de vol (ToF). Cependant, l'API Depth utilise tous les capteurs matériels compatibles d'un appareil.
Impact sur la performance
La profondeur géospatiale introduit un petit calcul ponctuel au début de la session pour intégrer la géométrie Streetscape dans la représentation de la profondeur lors du téléchargement initial. Toutefois, elle n'augmente pas de manière mesurable le coût du calcul de la profondeur.
Plage de profondeur
Sans la profondeur géospatiale, les plages habituelles des images de profondeur sont comprises entre 20 et 30 mètres, et la densité et la précision des observations de profondeur sont réduites au-delà de cette plage. Lorsque l'option "Geospatial Depth" (Profondeur géospatiale) est activée, les valeurs de profondeur échantillonnées de manière dense atteignent la valeur maximale de 65,535 mètres, même avec un faible mouvement initial.
<ph type="x-smartling-placeholder">
Cas d'utilisation
L'API ARCore Depth peut être utilisée pour tous les cas d'utilisation existants déjà pris en charge. Grâce à Geospatial Depth, les images de profondeur obtenues dans des emplacements compatibles avec les serveurs VPS seront remplies plus rapidement qu'auparavant avec une profondeur longue portée, ce qui permet de cibler des profondeurs de longue portée en extérieur. Voici quelques exemples d'utilisation :
- Occlusion à l'échelle du bâtiment du contenu virtuel et d'autres effets visuels
- Navigation en extérieur
- Mesures de distance
Limites
La profondeur géospatiale n'est disponible que dans les zones compatibles avec la localisation VPS et la géométrie Streetscape. Dans d'autres, l'API ARCore Depth fonctionnera normalement sans les valeurs Geospatial.
Prérequis
Assurez-vous de bien maîtriser les concepts fondamentaux de la RA. et comment configurer une session ARCore avant de continuer.
Activer la profondeur géospatiale
Dans une nouvelle session ARCore, vérifier si l'appareil d'un utilisateur est compatible avec Depth et l'API Geospatial. Les appareils compatibles ARCore ne sont pas tous compatibles avec l'API Depth en raison de contraintes de puissance de traitement.
Pour économiser des ressources, la profondeur est désactivée par défaut sur ARCore. Activez le mode Profondeur pour que votre application utilise l'API Depth. Activez également le mode Géospatial et la géométrie Streetscape pour utiliser la profondeur géospatiale.
int32_t is_depth_supported = 0; int32_t is_geospatial_supported = 0; // Check whether the user's device supports the Depth API. ArSession_isDepthModeSupported(ar_session, AR_DEPTH_MODE_AUTOMATIC, &is_depth_supported); ArSession_isGeospatialModeSupported(ar_session, AR_GEOSPATIAL_MODE_ENABLED, &is_geospatial_supported); ArConfig* ar_config = NULL; ArConfig_create(ar_session, &ar_config); if (is_depth_supported && is_geospatial_supported) { // These three settings are needed to use Geospatial Depth. ArConfig_setDepthMode(ar_session, ar_config, AR_DEPTH_MODE_AUTOMATIC); ArConfig_setGeospatialMode(ar_session, ar_config, AR_GEOSPATIAL_MODE_ENABLED); ArConfig_setStreetscapeGeometryMode(ar_session, ar_config, AR_STREETSCAPE_GEOMETRY_MODE_ENABLED); } CHECK(ArSession_configure(ar_session, ar_config) == AR_SUCCESS); ArConfig_destroy(ar_config);
Une fois l'option "Geospatial Depth" activée, vous pouvez accéder aux représentations de profondeur via des appels d'API existants, comme décrit dans le guide du développeur sur les profondeurs.
// Retrieve the depth image for the current frame, if available. ArImage* depth_image = NULL; // If a depth image is available, use it here. if (ArFrame_acquireDepthImage16Bits(ar_session, ar_frame, &depth_image) != AR_SUCCESS) { // No depth image received for this frame. // This normally means that depth data is not available yet. // Depth data will not be available if there are no tracked // feature points. This can happen when there is no motion, or when the // camera loses its ability to track objects in the surrounding // environment. return; }
Étapes suivantes
- Découvrez comment utiliser Streetscape Geometry dans votre expérience de réalité augmentée.