Table of Contents

Class ARKitFrameSource

Espaço de nomes
easyar
Assembly
EasyAR.Sense.dll

Um componente MonoBehaviour que controla o dispositivo de câmera ARKit (easyar.ARKitCameraDevice) na cena, fornecendo extensões de funcionalidade no ambiente Unity.

Esta fonte de quadros é um dispositivo de rastreamento de movimento que produz dados de movimento no ARSession.

public class ARKitFrameSource : FrameSource
Herança
ARKitFrameSource
Membros herdados

Campos

DesiredFocusMode

O modo de foco desejado. Eficaz apenas se modificado antes do evento DeviceOpened ou de OnEnable.

Nota: Devido a limitações de hardware ou sistema, a alternância de foco pode ser ineficaz em alguns dispositivos.

public ARKitCameraDeviceFocusMode DesiredFocusMode

Propriedades

Camera

Fornecido apenas ao criar uma nova fonte de quadros. Só é acessado duranteAssemble().

Em dispositivos desktop ou móveis, esta câmera representa oCamera correspondente no mundo virtual ao dispositivo de câmera no ambiente real; sua matriz de projeção e posição corresponderão à câmera real, controlada pelo EasyAR. Em headsets, esta câmera é usada apenas para exibir texto de diagnóstico diante dos olhos, não para renderizar a cena, e não é controlada pelo EasyAR.

protected override Camera Camera { get; }

CameraCandidate

Alternativa ao Camera, válida apenas se o Unity XR Origin não for usado. Se não definido, usará Camera.main.

public Camera CameraCandidate { get; set; }

CameraFrameStarted

Fornecido apenas ao criar uma nova fonte de quadros. Será acessado durante todo o ciclo de vida doARSession.

Se os quadros da câmera começaram a ser inseridos.

protected override bool CameraFrameStarted { get; }

DesiredFrameRate

Taxa de quadros de imagem de câmera desejada. Eficaz apenas se modificado antes do evento DeviceOpened.

Usará o valor mais próximo em SupportedFrameRate. Se não definido, usará o padrão.

public Optional<double> DesiredFrameRate { get; set; }

DesiredSize

Tamanho de imagem de câmera desejado. Eficaz apenas se modificado antes do evento DeviceOpened.

Usará o tamanho mais próximo em SupportedSize. Se não definido, usará o padrão.

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

DeviceCameras

Fornecido apenas ao criar uma nova fonte de quadros. Será acessado quandoCameraFrameStarted for true.

Fornece a câmera do dispositivo que fornece os dados do quadro. Se os dados vierem de várias câmeras, a lista deve incluir todas.

Garanta que o valor esteja correto quandoCameraFrameStarted for true.

protected override List<FrameSourceCamera> DeviceCameras { get; }

Display

Fornecido apenas ao criar uma nova fonte de quadros. Só é acessado duranteAssemble().

Fornece informações de exibição do sistema. Você pode usarDefaultSystemDisplay ouDefaultHMDDisplay para obter as informações padrão.

protected override IDisplay Display { get; }

FrameRate

Taxa de quadros atual do dispositivo. Disponível apenas quando Opened for true.

Set usará o valor mais próximo em SupportedFrameRate.

public double FrameRate { get; set; }

IsAvailable

Fornecido apenas ao criar uma nova fonte de quadros. Só é acessado duranteAssemble().

Se esta fonte de quadros está disponível.

Se o valor for null,CheckAvailability() será chamado, e o valor será obtido após o término daCoroutine.

protected override Optional<bool> IsAvailable { get; }

IsCameraUnderControl

Fornecido apenas ao criar uma nova fonte de quadros. Só é acessado duranteAssemble().

Quando true, a sessão atualizará o transform da câmera e renderizará a imagem da câmera.

Ao criar uma extensão para headset, deve ser false. Você deve controlar totalmente a câmera 3D na cena. Você deve processar a renderização da câmera, especialmente no modo VST.

protected override bool IsCameraUnderControl { get; }

IsHMD

Fornecido apenas ao criar uma nova fonte de quadros. Só é acessado duranteAssemble().

Se esta fonte de quadros é um headset. Se for, informações de diagnóstico serão exibidas em uma placa 3D diante da câmera.

Alguns filtros de quadro funcionam diferentemente no dispositivo.

protected override bool IsHMD { get; }

Opened

Se a câmera está aberta.

public bool Opened { get; }

Size

O tamanho de imagem atual. Disponível apenas quando Opened for true.

Set usará o tamanho mais próximo em SupportedSize.

Se o tamanho da imagem for alterado durante a gravação do FrameRecorder, os dados gravados pararão de atualizar; é necessário fechar e reiniciar a gravação.

public Vector2Int Size { get; set; }

SupportedFrameRate

Todas as taxas de quadros suportadas pelo dispositivo atual. Disponível apenas quando Opened for true.

public List<double> SupportedFrameRate { get; }

SupportedSize

Todos os tamanhos de imagem suportados pelo dispositivo atual. Disponível apenas quando Opened for true.

public List<Vector2Int> SupportedSize { get; }

enabled

Inicia/Para a captura do fluxo de vídeo durante a execução doARSession. Após a sessão iniciar, a captura só começará quandoMonoBehaviour.enabled for true.

public bool enabled { get; set; }

Métodos

Close()

Fecha o dispositivo.

public void Close()

OnSessionStart(ARSession)

Fornecido apenas ao criar uma nova fonte de quadros. Só é acessado duranteStartSession().

Lida com a inicialização da sessão, se esta fonte de quadros foi montada naAssembly. Este método é projetado para inicialização tardia; você pode realizar trabalhos de inicialização específicos de AR aqui.

protected override void OnSessionStart(ARSession session)

Parâmetros

session

OnSessionStop()

Fornecido apenas ao criar uma nova fonte de quadros. Será acessado duranteStopSession(bool) ou outros processos de parada/corrupção da sessão.

Lida com a parada da sessão, se esta fonte de quadros foi montada naAssembly. Use este método para destruir recursos criados duranteStartSession() e operação da sessão, e restaurar o estado interno. É garantido que será chamado antes da destruição da sessão. Se a fonte de quadros for destruída antes da sessão, não será chamado e a sessão ficará corrompida.

protected override void OnSessionStop()

Open()

Abre o dispositivo. Se Open() e Close() não forem chamados manualmente, o ARSession abrirá automaticamente após a inicialização.

public void Open()

Eventos

DeviceClosed

Evento de fechamento do dispositivo.

public event Action DeviceClosed

DeviceOpened

Evento de abertura do dispositivo, o valor bool indica sucesso.

public event Action<bool, PermissionStatus, string> DeviceOpened