Table of Contents

Class ARKitFrameSource

Spazio dei nomi
easyar
Assembly
EasyAR.Sense.dll

Componente MonoBehaviour per controllare il dispositivo fotocamera ARKit (easyar.ARKitCameraDevice) nella scena, fornendo estensioni funzionali in ambiente Unity.

Questa sorgente di frame è un dispositivo di tracciamento del movimento che emette dati di movimento all'interno di ARSession.

public class ARKitFrameSource : FrameSource
Ereditarietà
ARKitFrameSource
Membri ereditati

Campi

DesiredFocusMode

Modalità di messa a fuoco desiderata. Le modifiche sono efficaci solo se effettuate prima dell'evento DeviceOpened o di OnEnable.

Nota: a causa di limitazioni hardware o di sistema, l'attivazione/disattivazione della messa a fuoco potrebbe non funzionare su alcuni dispositivi.

public ARKitCameraDeviceFocusMode DesiredFocusMode

Proprietà

Camera

Fornito solo alla creazione di una nuova sorgente frame. Accessibile solo duranteAssemble().

Su dispositivi desktop o mobili, questa fotocamera rappresenta la controparteCamera nel mondo virtuale del dispositivo fotocamera reale nell'ambiente fisico. La sua matrice di proiezione e posizione corrisponderanno alla fotocamera reale, controllata da EasyAR. Su un visore, questa fotocamera serve solo per visualizzare testo diagnostico davanti agli occhi, non per il rendering della scena; la fotocamera non è controllata da EasyAR.

protected override Camera Camera { get; }

CameraCandidate

Alternativa a Camera, valida solo se non si utilizza Unity XR Origin. Se non impostato, verrà utilizzato Camera.main.

public Camera CameraCandidate { get; set; }

CameraFrameStarted

Fornito solo alla creazione di una nuova sorgente frame. Accessibile per l'intero ciclo di vita diARSession.

Se i frame della fotocamera hanno iniziato ad essere inseriti.

protected override bool CameraFrameStarted { get; }

DesiredFrameRate

Frame rate desiderato per l'immagine della fotocamera. Le modifiche sono efficaci solo se effettuate prima dell'evento DeviceOpened.

Utilizzerà il valore più vicino in SupportedFrameRate. Se non impostato, verrà utilizzato il valore predefinito.

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

DesiredSize

Dimensione desiderata per l'immagine della fotocamera. Le modifiche sono efficaci solo se effettuate prima dell'evento DeviceOpened.

Utilizzerà la dimensione più vicina in SupportedSize. Se non impostato, verrà utilizzato il valore predefinito.

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

DeviceCameras

Fornito solo alla creazione di una nuova sorgente frame. Accessibile solo quandoCameraFrameStarted è true.

Fornisce la fotocamera del dispositivo che fornisce i dati del frame fotocamera. Se i dati del frame fotocamera sono forniti da più fotocamere, l'elenco deve includerle tutte.

Assicurarsi che il valore sia corretto quandoCameraFrameStarted è true.

protected override List<FrameSourceCamera> DeviceCameras { get; }

Display

Fornito solo alla creazione di una nuova sorgente frame. Accessibile solo duranteAssemble().

Fornisce le informazioni sul sistema di visualizzazione. Puoi usareDefaultSystemDisplay oDefaultHMDDisplay per ottenere le informazioni di visualizzazione predefinite.

protected override IDisplay Display { get; }

FrameRate

Frame rate corrente del dispositivo. Disponibile solo quando Opened è true.

Il setter utilizzerà il valore più vicino in SupportedFrameRate.

public double FrameRate { get; set; }

IsAvailable

Fornito solo alla creazione di una nuova sorgente frame. Accessibile solo duranteAssemble().

Se la sorgente frame corrente è disponibile.

Se il valore è null,CheckAvailability() verrà chiamato e il valore verrà ottenuto dopo il completamento diCoroutine.

protected override Optional<bool> IsAvailable { get; }

IsCameraUnderControl

Fornito solo alla creazione di una nuova sorgente frame. Accessibile solo duranteAssemble().

Quando è true, la sessione aggiorna il transform della fotocamera e renderizza l'immagine della fotocamera.

Durante la creazione di un'estensione per visore, dovrebbe essere false. Dovresti controllare completamente la fotocamera 3D nella scena. Dovresti gestire il rendering della fotocamera, specialmente in modalità VST.

protected override bool IsCameraUnderControl { get; }

IsHMD

Fornito solo alla creazione di una nuova sorgente frame. Accessibile solo duranteAssemble().

Se la sorgente frame corrente è un visore. Se è un visore, le informazioni di diagnostica verranno visualizzate su un pannello 3D davanti alla fotocamera.

Alcuni filtri frame funzionano diversamente sui dispositivi.

protected override bool IsHMD { get; }

Opened

Se la fotocamera è aperta.

public bool Opened { get; }

Size

Dimensione immagine corrente. Disponibile solo quando Opened è true.

Il setter utilizzerà la dimensione più vicina in SupportedSize.

Se la dimensione dell'immagine viene modificata durante la registrazione di FrameRecorder, i dati di registrazione smetteranno di aggiornarsi; è necessario chiudere e riavviare la registrazione.

public Vector2Int Size { get; set; }

SupportedFrameRate

Tutti i frame rate supportati dal dispositivo corrente. Disponibile solo quando Opened è true.

public List<double> SupportedFrameRate { get; }

SupportedSize

Tutte le dimensioni immagine supportate dal dispositivo corrente. Disponibile solo quando Opened è true.

public List<Vector2Int> SupportedSize { get; }

enabled

Inizia/Interrompe la raccolta del flusso video durante l'esecuzione diARSession. Dopo l'avvio della sessione, la raccolta inizia solo quandoMonoBehaviour.enabled è true.

public bool enabled { get; set; }

Metodi

Close()

Chiude il dispositivo.

public void Close()

OnSessionStart(ARSession)

Fornito solo alla creazione di una nuova sorgente frame. Accessibile solo duranteStartSession().

Gestisce l'avvio della sessione, se questa sorgente frame è stata assemblata inAssembly. Questo metodo è progettato per l'inizializzazione differita; puoi eseguire qui il lavoro di inizializzazione specifico per AR.

protected override void OnSessionStart(ARSession session)

Parametri

session

OnSessionStop()

Fornito solo alla creazione di una nuova sorgente frame. Accessibile duranteStopSession(bool) o altri processi di arresto/danneggiamento della sessione.

Gestisce l'arresto della sessione, se questa sorgente frame è stata assemblata inAssembly. Puoi usare questo metodo per distruggere le risorse create duranteStartSession() e il funzionamento della sessione, e ripristinare lo stato interno. Sarà chiamato prima della distruzione della sessione. Se la sorgente frame viene distrutta prima della sessione, non verrà chiamato e la sessione sarà danneggiata.

protected override void OnSessionStop()

Open()

Apre il dispositivo. Se non vengono chiamati manualmente Open() e Close(), l'apertura avverrà automaticamente dopo l'avvio di ARSession.

public void Open()

Eventi

DeviceClosed

Evento di chiusura del dispositivo.

public event Action DeviceClosed

DeviceOpened

Evento di apertura del dispositivo. Il valore bool indica se ha avuto successo.

public event Action<bool, PermissionStatus, string> DeviceOpened