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