L'API Raw Depth fournit des données de profondeur pour une image d'appareil photo dont la précision est supérieure à celle de l'API Depth, mais ne couvre pas toujours tous les pixels. Les images de profondeur brutes, ainsi que les images de confiance correspondantes, peuvent également être traitées de manière plus approfondie, ce qui permet aux applications d'utiliser uniquement les données de profondeur suffisamment précises pour leur cas d'utilisation individuel.
Compatibilité avec les appareils
Raw Depth 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, comme un capteur de temps de vol. Cependant, l'API Raw Depth et l'API Depth complète utilisent tous les deux 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 plus précises, mais les représentations de profondeur brutes peuvent ne pas inclure d'estimation de profondeur pour tous les pixels de l'image de l'appareil photo. En revanche, l'API Depth complète fournit une estimation de la profondeur pour chaque pixel, mais 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 les mêmes dans les deux API. Seul le contenu diffère.
Le tableau suivant illustre les différences entre l'API Raw Depth et l'API Depth complète à l'aide d'une image représentant une chaise et une table dans une cuisine.
| API | Renvoie | Image de la caméra | 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 un niveau de confiance plus élevé, les pixels blancs correspondant à l'indice de confiance maximal et les pixels noirs à l'absence de confiance. En général, les zones de l'image de l'appareil photo qui présentent davantage de texture, comme un arbre, présentent un niveau de confiance de profondeur plus élevé que les régions qui n'en ont pas, comme un mur blanc. Les surfaces sans texture affichent généralement un indice de confiance de zéro.
Si l'appareil cible est équipé d'un capteur de profondeur matériel compatible, la confiance dans les zones de l'image suffisamment proches de l'appareil photo sera probablement plus élevée, même sur des surfaces sans texture.
Coût de calcul
Le coût de calcul de l'API Raw Depth représente environ la moitié de celui de l'API Depth complète.
Cas d'utilisation
L'API Raw Depth 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 dans lesquelles la précision et la précision de la profondeur sont nécessaires pour les tâches de compréhension de la géométrie. Voici quelques cas d'utilisation:
- Reconstruction 3D
- Mesure
- Détection de formes
Conditions préalables
Assurez-vous de bien comprendre les concepts fondamentaux de la RA et de configurer une session ARCore avant de continuer.
Activer la profondeur
Dans une nouvelle session ARCore, vérifiez si l'appareil d'un utilisateur est compatible avec Depth. Certains appareils compatibles avec ARCore ne sont pas compatibles avec l'API Depth en raison de contraintes de puissance de traitement. Pour économiser les 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.
}
Obtenez 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 de la profondeur brute
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;
}