Table of Contents

Class XREALFrameSource

Namespace
easyar
Assembly
EasyAR.Sense.dll

Steuert das XREAL-Kameragerät (easyar.XREALCameraDevice) in der Szene alsMonoBehaviour und bietet Funktionserweiterungen in der Unity-Umgebung.

Diese Frame-Quelle ist ein Bewegungsverfolgungsgerät, das Bewegungsdaten imARSession ausgibt.

Bei Verwendung von Testprodukten (Personal-Lizenz, Test-XR-Lizenz oder Test-Mega-Service usw.) auf benutzerdefinierten Kameras oder Head-Mounted-Displays reagiert EasyAR Sense nach jedem Start nach einer festgelegten, begrenzten Zeit nicht mehr.

public class XREALFrameSource : FrameSource
Vererbung
XREALFrameSource

Eigenschaften

AvailableCenterMode

Wird nur bei der Erstellung einer neuen Frame-Quelle bereitgestellt. Es wird nur während desAssemble()-Prozesses abgerufen.

Alle verfügbaren Zentrumsmodi.

protected override IReadOnlyList<ARSession.ARCenterMode> AvailableCenterMode { get; }

Camera

Wird nur bei der Erstellung einer neuen Frame-Quelle bereitgestellt. Es wird nur während desAssemble()-Prozesses abgerufen.

Auf Desktop-Geräten oder Mobiltelefonen repräsentiert diese Kamera dasCamera in der virtuellen Welt, das dem realen Kameragerät in der physischen Umgebung entspricht. Ihre Projektionsmatrix und Position entsprechen der echten Kamera und werden von EasyAR gesteuert. Auf einem Head-Mounted-Display dient diese Kamera nur dazu, einige Diagnosetexte vor den Augen anzuzeigen, nicht zum Rendern des Bildes. Die Kamera wird auch nicht von EasyAR gesteuert.

protected override Camera Camera { get; }

CameraFrameStarted

Wird nur bei der Erstellung einer neuen Frame-Quelle bereitgestellt. Es wird während der gesamten Lebensdauer desARSession abgerufen.

Ob die Kameraframe-Eingabe begonnen hat.

protected override bool CameraFrameStarted { get; }

DeviceCameras

Wird nur bei der Erstellung einer neuen Frame-Quelle bereitgestellt. Es wird abgerufen, wennCameraFrameStarted wahr ist.

Stellt die Gerätekamera bereit, die die Kameraframedaten liefert. Wenn die Kameraframedaten von mehreren Kameras stammen, müssen alle Kameras in der Liste enthalten sein.

Stellen Sie sicher, dass der Wert korrekt ist, wennCameraFrameStarted wahr ist.

protected override List<FrameSourceCamera> DeviceCameras { get; }

Display

Wird nur bei der Erstellung einer neuen Frame-Quelle bereitgestellt. Es wird nur während desAssemble()-Prozesses abgerufen.

Stellt Systemanzeigeinformationen bereit. Sie könnenDefaultSystemDisplay oderDefaultHMDDisplay verwenden, um Standardanzeigeinformationen zu erhalten.

protected override IDisplay Display { get; }

FrameRate

Bildratenbereich. Nur verfügbar, wennOpened wahr ist.

public double FrameRate { get; }

IsAvailable

Wird nur bei der Erstellung einer neuen Frame-Quelle bereitgestellt. Es wird nur während desAssemble()-Prozesses abgerufen.

Ob die aktuelle Frame-Quelle verfügbar ist.

Wenn der Wert null ist, wirdCheckAvailability() aufgerufen und der Wert wird nach Abschluss derCoroutine abgerufen.

protected override Optional<bool> IsAvailable { get; }

IsCameraUnderControl

Wird nur bei der Erstellung einer neuen Frame-Quelle bereitgestellt. Es wird nur während desAssemble()-Prozesses abgerufen.

Wenn der Wert wahr ist, aktualisiert die Sitzung die Transformation der Kamera und rendert das Kamerabild.

Bei der Erstellung einer Head-Mounted-Display-Erweiterung sollte dies falsch sein. Sie sollten die 3D-Kamera in der Szene vollständig kontrollieren. Sie sollten das Kamera-Rendering handhaben, insbesondere im VST-Modus.

protected override bool IsCameraUnderControl { get; }

IsHMD

Wird nur bei der Erstellung einer neuen Frame-Quelle bereitgestellt. Es wird nur während desAssemble()-Prozesses abgerufen.

Ob die aktuelle Frame-Quelle ein Head-Mounted-Display ist. Wenn es sich um ein Head-Mounted-Display handelt, werden Diagnoseinformationen auf einer 3D-Tafel vor der Kamera angezeigt.

Einige Frame-Filter verhalten sich auf dem Gerät unterschiedlich.

protected override bool IsHMD { get; }

Opened

Ob die Kamera geöffnet ist.

public bool Opened { get; }

ReceivedFrameCount

Anzahl der erfassten Frames. Wird normalerweise beim Debuggen verwendet. Wenn dieser Wert aufhört zu steigen, liegt normalerweise ein Hardwareproblem vor; Ein erneutes Einstecken könnte das Problem lösen.

public int ReceivedFrameCount { get; }

Size

Aktuelle Bildgröße. Nur verfügbar, wennOpened wahr ist.

public Vector2Int Size { get; }

enabled

Startet/Stoppt das Erfassen des Videostreams während der Laufzeit desARSession. Nach dem Start der Sitzung beginnt die Erfassung nur, wennMonoBehaviour.enabled wahr ist.

public bool enabled { get; set; }

Methoden

CheckAvailability()

Wird nur bei der Erstellung einer neuen Frame-Quelle bereitgestellt. Es wird nur während desAssemble()-Prozesses abgerufen.

Coroutine zum Überprüfen der Verfügbarkeit der Frame-Quelle, wennIsAvailable null ist.

protected override IEnumerator CheckAvailability()

Close()

Schließt das Gerät.

public void Close()

OnSessionStart(ARSession)

Wird nur bei der Erstellung einer neuen Frame-Quelle bereitgestellt. Es wird nur während desStartSession()-Prozesses abgerufen.

Behandelt den Start der Sitzung, wenn diese Frame-Quelle inAssembly eingebunden wurde. Diese Methode ist für die verzögerte Initialisierung vorgesehen. Hier können AR-spezifische Initialisierungsarbeiten durchgeführt werden.

protected override void OnSessionStart(ARSession session)

Parameter

session

OnSessionStop()

Wird nur bei der Erstellung einer neuen Frame-Quelle bereitgestellt. Es wird währendStopSession(bool) oder anderen Sitzungsstopp-/Beschädigungsprozessen abgerufen.

Behandelt das Stoppen der Sitzung, wenn diese Frame-Quelle inAssembly eingebunden wurde. Mit dieser Methode können Ressourcen, die währendStartSession() und des Sitzungsbetriebs erstellt wurden, zerstört und der interne Status wiederhergestellt werden. Diese Methode wird garantiert aufgerufen, bevor die Sitzung zerstört wird. Wenn die Frame-Quelle vor der Sitzung zerstört wird, wird sie nicht aufgerufen und die Sitzung wird beschädigt.

protected override void OnSessionStop()

Open()

Öffnet das Gerät. WennOpen() undClose() nicht manuell aufgerufen werden, wirdOpen() automatisch nach dem Starten desARSession ausgeführt.

public void Open()

Ereignisse

DeviceClosed

Ereignis beim Schließen des Geräts.

public event Action DeviceClosed

DeviceOpened

Ereignis beim Öffnen des Geräts, der boolesche Wert gibt an, ob es erfolgreich war.

public event Action<bool, PermissionStatus, string> DeviceOpened