Table of Contents

Class ThreeDofCameraDeviceFrameSource

Espace de noms
easyar
Assembly
EasyAR.Sense.dll

Composant ThreeDofCameraDeviceFrameSource pour contrôler un périphérique de caméra 3DOF dans une scène, étendant les fonctionnalités sous Unity.

Cette source d'images est un dispositif de suivi de rotation 3DOF qui donnera des données de rotation dans une ARSession.

public class ThreeDofCameraDeviceFrameSource : FrameSource
Héritage
ThreeDofCameraDeviceFrameSource
Membres hérités

Champs

DesiredFocusMode

Mode de mise au point souhaité. Les modifications prennent effet avant l'événement DeviceOpened ou l'appel de OnEnable.

Remarque : En raison des limitations matérielles ou logicielles, l'activation/désactivation de la mise au point peut être inefficace sur certains appareils.

public ThreeDofCameraDeviceFocusMode DesiredFocusMode

Propriétés

Camera

Fourni uniquement lors de la création d'une nouvelle frame source. Il ne sera accessible que pendant le processus de Assemble().

Sur ordinateur de bureau ou téléphone mobile, cette caméra représente le u:aUnityEngine.Camera correspondant dans le monde virtuel à l'appareil photo physique dans l'environnement réel. Sa matrice de projection et sa position correspondront à celles de la caméra réelle, contrôlée par EasyAR. Sur un casque de réalité virtuelle (HMD), cette caméra sert uniquement à afficher du texte de diagnostic devant les yeux, et n'est pas utilisée pour le rendu visuel. La caméra n'est pas non plus contrôlée par EasyAR.

protected override Camera Camera { get; }

CameraCandidate

Alternative à Camera, ne fonctionne que lorsque l'origine XR Unity n'est pas utilisée. Utilise Camera.main si non défini.

public Camera CameraCandidate { get; set; }

CameraFrameStarted

À fournir uniquement lors de la création d'une nouvelle source d'images. Elle sera accessible pendant tout le cycle de vie du ARSession.

Si l'image de la caméra est entrée.

protected override bool CameraFrameStarted { get; }

DesiredSize

Taille d'image de caméra souhaitée. Les modifications doivent être effectuées avant l'événement DeviceOpened pour être prises en compte.

La taille la plus proche dans SupportedSize sera utilisée. Si non définie, la valeur par défaut est appliquée.

public Optional<Vector2Int> DesiredSize { get; set; }

DeviceCameras

Fourni uniquement lors de la création d'une nouvelle source d'images. Il sera consulté lorsque CameraFrameStarted est vrai.

Caméra(s) de l'appareil qui fournit(ssent) les données d'images de caméra. Si les données d'images proviennent de plusieurs caméras, la liste doit inclure toutes les caméras.

Garantit que la valeur est correcte lorsque CameraFrameStarted est vrai.

protected override List<FrameSourceCamera> DeviceCameras { get; }

Display

Fourni uniquement lors de la création d'une nouvelle frame source. Il ne sera accessible que pendant le processus de Assemble().

Fournit les informations du système d'affichage. Vous pouvez utiliser DefaultSystemDisplay ou DefaultHMDDisplay pour obtenir les informations d'affichage par défaut.

protected override IDisplay Display { get; }

FrameRateRange

Plage de taux de rafraîchissement. Disponible uniquement lorsque Opened est vrai.

public Vector2 FrameRateRange { get; }

IsAvailable

Fourni uniquement lors de la création d'une nouvelle source de frame. Il n'est accessible que pendant le processus de Assemble().

Indique si la source de frame actuelle est disponible.

Si la valeur est nulle, CheckAvailability() sera appelée, et la valeur sera récupérée après la fin de la Coroutine.

protected override Optional<bool> IsAvailable { get; }

IsCameraUnderControl

À fournir uniquement lors de la création d'une nouvelle frame source. Il ne sera accessible que pendant le processus de Assemble().

Lorsque la valeur est true, la session met à jour le transform de la caméra et effectue le rendu de l'image de la caméra.

Lors de la création d'une extension de casque, cela doit être false. Vous devez avoir un contrôle total sur la caméra 3D dans la scène. Vous devez gérer le rendu de la caméra, en particulier en mode VST.

protected override bool IsCameraUnderControl { get; }

IsHMD

À fournir uniquement lors de la création d'une nouvelle frame source. Elle ne sera accessible que durant le processus Assemble().

Indique si la frame source actuelle est un casque de réalité virtuelle. Si c'est un casque, les informations de diagnostic s'afficheront sur un panneau 3D devant la caméra.

Certains frame filters fonctionnent différemment selon les appareils.

protected override bool IsHMD { get; }

Opened

L'appareil photo est-il ouvert ?

public bool Opened { get; }

Size

Taille d'image actuelle. Disponible uniquement lorsque Opened est true.

set utilisera la taille la plus proche dans SupportedSize.

Si la taille de l'image est modifiée pendant l'enregistrement par FrameRecorder, les données d'enregistrement arrêteront de se mettre à jour et il faudra fermer puis réenregistrer.

public Vector2Int Size { get; set; }

SupportedSize

Toutes les tailles d'image prises en charge par l'appareil actuel. N'est disponible que lorsque Opened est true.

public List<Vector2Int> SupportedSize { get; }

enabled

Le runtime ARSession démarre/arrête la collecte des données du flux vidéo. La collecte ne commence qu'une fois la session démarrée *et* lorsque MonoBehaviour.enabled est à true.

public bool enabled { get; set; }

Méthodes

Close()

Éteindre l'appareil.

public void Close()

OnSessionStart(ARSession)

À fournir uniquement lors de la création d'une nouvelle source de trames. On y accède uniquement pendant le processus de StartSession().

Traite le démarrage de la session si cette source de trames est déjà assemblée dans Assembly. Cette méthode est conçue pour une initialisation différée, où vous pouvez effectuer des travaux d'initialisation spécifiques à la RA.

protected override void OnSessionStart(ARSession session)

Paramètres

session

OnSessionStop()

Fourni uniquement lors de la création d'une nouvelle source d'images. Elle sera consultée pendant StopSession(bool) ou d'autres processus d'arrêt/endommagement de session.

Traite l'arrêt de la session, si cette source d'images a été intégrée à Assembly. Vous pouvez utiliser cette méthode pour détruire les ressources créées par StartSession() et pendant l'exécution de la session, et restaurer l'état interne. L'appel de cette méthode est garanti avant la destruction de la session. Si la source d'images est détruite avant la session, elle ne sera pas appelée et la session sera endommagée.

protected override void OnSessionStop()

Open()

Ouvrez l'appareil. Si Open() et Close() ne sont pas appelés manuellement, ARSession ouvre automatiquement Open() après démarrage.

public void Open()

Événements

DeviceClosed

Événement d'arrêt de l'appareil.

public event Action DeviceClosed

DeviceOpened

Événement d'ouverture de l'appareil, une valeur bool indique si l'opération a réussi.

public event Action<bool, PermissionStatus, string> DeviceOpened