L'API Raw Depth fournit des données de profondeur pour une image d'appareil photo dont la précision est supérieure à celle des données complètes de l'API Depth, mais elle ne couvre pas toujours tous les pixels. Les images de profondeur brutes, ainsi que les images de confiance correspondantes, peuvent également être traitées plus en détail, ce qui permet aux applications d'utiliser uniquement les données de profondeur dont la précision est suffisante pour leur cas d'utilisation individuel.
Compatibilité avec les appareils
Elle est disponible sur tous les appareils compatibles avec l'API Depth. L'API Raw Depth, comme l'API Depth complète, ne nécessite pas de capteur de profondeur matériel compatible, tel qu'un capteur de durée de vol (ToF). Toutefois, les API Raw Depth et Full Depth utilisent toutes les deux tous les capteurs matériels compatibles d'un appareil.
Comparaison entre l'API Raw Depth et l'API Full Depth
L'API Raw Depth fournit des estimations de profondeur avec une plus grande précision, mais les images de profondeur brutes peuvent ne pas inclure d'estimations de profondeur pour tous les pixels de l'image de l'appareil photo. En revanche, l'API Full Depth fournit une estimation de la profondeur pour chaque pixel. Toutefois, les données de profondeur par pixel peuvent être moins précises en raison du lissage et de l'interpolation des estimations de profondeur. Le format et la taille des représentations de profondeur sont identiques dans les deux API. Seul le contenu diffère.
Le tableau suivant illustre les différences entre l'API Raw Depth et l'API Full Depth à l'aide d'une image d'une chaise et d'une table dans une cuisine.
| API | Renvoie | Image de l'appareil photo | Image de profondeur | Image de confiance |
|---|---|---|---|---|
| API Raw Depth |
|
|
|
|
| API Full Depth |
|
|
|
N/A |
Images de confiance
Dans les images de confiance renvoyées par l'API Raw Depth, les pixels plus clairs ont des valeurs de confiance plus élevées, les pixels blancs représentant un niveau de confiance total et les pixels noirs un degré de confiance élevé. En général, les zones de l'image de l'appareil photo qui présentent le plus de texture (un arbre, par exemple) ont une confiance en la profondeur brute supérieure à celle des autres zones, comme un mur blanc. Les surfaces sans texture donnent généralement un indice de confiance de zéro.
Si l'appareil cible est équipé d'un capteur de profondeur compatible, les zones de l'image suffisamment proches de l'appareil photo seront probablement plus fiables, même sur des surfaces sans texture.
Coût de calcul
Le coût de calcul de l'API Raw Depth correspond à environ la moitié du coût de calcul de l'API Depth complète.
Cas d'utilisation
L'API Raw Depth vous permet d'obtenir des représentations de profondeur qui fournissent une représentation plus détaillée de la géométrie des objets de la scène. Les données de profondeur brutes peuvent être utiles pour créer des expériences de RA qui nécessitent davantage de précision et de détails pour les tâches de compréhension de la géométrie. Voici quelques cas d'utilisation :
- Reconstruction 3D
- Mesure
- Détection de formes
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
Dans une nouvelle session ARCore, vérifiez si l'appareil de l'utilisateur est compatible avec la fonctionnalité de profondeur. 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.
var occlusionManager = // Typically acquired from the Camera game object.
// Check whether the user's device supports the Depth API.
if (occlusionManager.descriptor?.supportsEnvironmentDepthImage)
{
// If depth mode is available on the user's device, perform
// the steps you want here.
}
Obtenir la dernière image de profondeur brute
Appelez AROcclusionManager.TryAcquireEnvironmentDepthCpuImage() et utilisez AROcclusionManager.environmentDepthTemporalSmoothingRequested pour acquérir la dernière image de profondeur brute sur le processeur.
Obtenez la dernière image de confiance brute de la profondeur
Appelez AROcclusionManager.TryAcquireEnvironmentDepthConfidenceCpuImage() et utilisez AROcclusionManager.environmentDepthTemporalSmoothingRequested pour acquérir l'image de confiance sur le processeur.
// Attempt to get the latest environment depth image.
if (occlusionManager && occlusionManager.TryAcquireEnvironmentDepthConfidenceCpuImage(out XRCpuImage image))
{
using (image)
{
UpdateRawImage(m_RawEnvironmentDepthConfidenceImage, image);
}
}
else
{
m_RawEnvironmentDepthConfidenceImage.enabled = false;
}