Class ARKitFrameSource
- Espace de noms
- easyar
- Assembly
- EasyAR.Sense.dll
Composant MonoBehaviour contrôlant un appareil caméra ARKit (easyar.ARKitCameraDevice) dans la scène, fournissant une extension fonctionnelle dans l'environnement Unity.
Cette source d'images (frame source) est un dispositif de suivi de mouvement qui, dans une session AR (ARSession), restitue les données de mouvement.
public class ARKitFrameSource : FrameSource- Héritage
-
ARKitFrameSource
- Membres hérités
Champs
DesiredFocusMode
Mode de mise au point souhaité, la modification prend effet avant l'événement DeviceOpened ou OnEnable.
Remarque : Soumis aux limitations matérielles ou système, le commutateur de mise au point peut être inefficace sur certains appareils.
public ARKitCameraDeviceFocusMode DesiredFocusModeProprié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, valable uniquement si Unity XR Origin n'est pas utilisé. 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; }DesiredFrameRate
Taux de rafraîchissement d'image de caméra souhaité. Les modifications doivent être effectuées avant l'événement DeviceOpened pour prendre effet.
Utilise la valeur la plus proche dans SupportedFrameRate. Si non défini, la valeur par défaut est utilisée.
public Optional<double> DesiredFrameRate { get; set; }DesiredSize
Taille d'image de caméra souhaitée. Modifiez avant l'événement DeviceOpened pour que cela prenne effet.
La taille la plus proche dans SupportedSize sera utilisée. Si non défini, la valeur par défaut sera utilisé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; }FrameRate
La fréquence d'images actuelle de l'appareil. Disponible uniquement lorsque Opened est true.
Le set utilisera la valeur la plus proche parmi celles disponibles dans SupportedFrameRate.
public double FrameRate { get; set; }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 actuelle de l'image. Disponible uniquement lorsque Opened est true.
Le set utilisera la taille la plus proche dans SupportedSize.
Si la taille d'image est modifiée pendant l'enregistrement par FrameRecorder, la mise à jour des données d'enregistrement s'arrêtera et il faudra fermer puis recommencer l'enregistrement.
public Vector2Int Size { get; set; }SupportedFrameRate
Tous les framerates pris en charge par l'appareil actuel. Disponible uniquement lorsque Opened est true.
public List<double> SupportedFrameRate { get; }SupportedSize
Toutes les tailles d'image prises en charge par le périphérique actuel. Disponible uniquement 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 ouvrira automatiquement Open() après son démarrage.
public void Open()Événements
DeviceClosed
Événement d'arrêt de l'appareil.
public event Action DeviceClosedDeviceOpened
É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