Table of Contents

Class AREngineFrameSource

Beralih ke Panduan

Ruang Nama
easyar
Rakitan
EasyAR.Sense.dll

Menghubungkan output perangkat kamera AREngine ke sumber frame input kustom EasyAR dalam adegan. Memberikan dukungan Huawei AR Engine melalui fungsi kamera kustom EasyAR Sense.

Sumber frame ini adalah perangkat pelacakan gerak yang akan mengeluarkan data gerakan di ARSession.

Sumber frame ini tidak menggunakan ``Huawei AR Engine Unity SDK``, tidak perlu ditambahkan.

public class AREngineFrameSource : FrameSource
Pewarisan
AREngineFrameSource
Anggota Pewarisan

Bidang

DesiredFocusMode

Mode fokus yang diinginkan, hanya efektif jika dimodifikasi sebelum event DeviceOpened atau sebelum OnEnable.

Catatan: Karena dibatasi oleh perangkat keras atau sistem, sakelar fokus mungkin tidak efektif di beberapa perangkat.

public AREngineCameraDeviceFocusMode DesiredFocusMode

Properti

Camera

Hanya disediakan saat membuat frame source baru. Hanya akan diakses selama proses Assemble().

Pada perangkat desktop atau ponsel, kamera ini mewakili Camera di dunia virtual yang sesuai dengan perangkat kamera di lingkungan nyata, matriks proyeksi dan posisinya akan sesuai dengan kamera nyata, dikendalikan oleh EasyAR. Pada headset, kamera ini hanya digunakan untuk menampilkan beberapa teks diagnostik di depan mata, tidak untuk rendering gambar, dan kameranya tidak dikendalikan oleh EasyAR.

protected override Camera Camera { get; }

CameraCandidate

Alternatif untuk Camera, hanya efektif jika Unity XR Origin tidak digunakan. Jika tidak disetel, akan menggunakan Camera.main.

public Camera CameraCandidate { get; set; }

CameraFrameStarted

Hanya disediakan saat membuat frame source baru. Ini akan diakses sepanjang siklus hidup ARSession.

Apakah frame kamera sudah mulai dimasukkan.

protected override bool CameraFrameStarted { get; }

DeviceCameras

Hanya disediakan saat membuat frame source baru. Ini akan diakses saat CameraFrameStarted bernilai true.

Menyediakan kamera perangkat yang memberikan data frame kamera. Jika data frame kamera disediakan oleh beberapa kamera, daftar harus mencakup semua kamera.

Pastikan nilainya benar saat CameraFrameStarted bernilai true.

protected override List<FrameSourceCamera> DeviceCameras { get; }

Display

Hanya disediakan saat membuat frame source baru. Hanya akan diakses selama proses Assemble().

Menyediakan informasi tampilan sistem. Anda dapat menggunakan DefaultSystemDisplay atau DefaultHMDDisplay untuk mendapatkan informasi tampilan default.

protected override IDisplay Display { get; }

FrameRateRange

Rentang frame rate. Hanya tersedia saat Opened bernilai true.

public Vector2 FrameRateRange { get; }

IsAvailable

Hanya disediakan saat membuat frame source baru. Hanya akan diakses selama proses Assemble().

Apakah frame source saat ini tersedia.

Jika nilainya null, CheckAvailability() akan dipanggil, nilainya akan diperoleh setelah Coroutine selesai.

protected override Optional<bool> IsAvailable { get; }

IsCameraUnderControl

Hanya disediakan saat membuat frame source baru. Hanya akan diakses selama proses Assemble().

Saat nilainya true, session akan memperbarui transform kamera dan akan merender gambar kamera.

Saat membuat ekstensi headset, ini harus false. Anda harus sepenuhnya mengontrol kamera 3D dalam scene. Anda harus menangani rendering kamera, terutama dalam mode VST.

protected override bool IsCameraUnderControl { get; }

IsHMD

Hanya disediakan saat membuat frame source baru. Hanya akan diakses selama proses Assemble().

Apakah frame source saat ini adalah headset. Jika headset, informasi diagnostik akan ditampilkan pada papan 3D di depan kamera.

Beberapa frame filter berjalan berbeda pada perangkat.

protected override bool IsHMD { get; }

Opened

Apakah kamera terbuka.

public bool Opened { get; }

Size

Ukuran gambar saat ini. Hanya tersedia saat Opened bernilai true.

public Optional<Vector2Int> Size { get; }

enabled

Memulai/menghentikan pengumpulan aliran video saat ARSession berjalan. Setelah session dimulai, pengumpulan hanya akan dimulai jika MonoBehaviour.enabled bernilai true.

public bool enabled { get; set; }

Metode

Close()

Menutup perangkat.

public void Close()

OnSessionStart(ARSession)

Hanya disediakan saat membuat frame source baru. Hanya akan diakses selama proses StartSession().

Menangani peluncuran session, jika frame source ini telah dirakit ke dalam Assembly. Metode ini dirancang untuk inisialisasi tertunda, Anda dapat melakukan pekerjaan inisialisasi khusus AR dalam metode ini.

protected override void OnSessionStart(ARSession session)

Parameter

session

OnSessionStop()

Hanya disediakan saat membuat frame source baru. Ini akan diakses selama StopSession(bool) atau proses penghentian/kerusakan session lainnya.

Menangani penghentian session, jika frame source ini telah dirakit ke dalam Assembly. Anda dapat menggunakan metode ini untuk menghancurkan sumber daya yang dibuat oleh StartSession() dan selama session berjalan, serta memulihkan status internal. Metode ini dijamin akan dipanggil sebelum session dihancurkan. Jika frame source dihancurkan sebelum session, ini tidak akan dipanggil, dan session akan rusak.

protected override void OnSessionStop()

Open()

Buka perangkat. Jika tidak memanggil Open() dan Close() secara manual, ARSession akan secara otomatis Open() setelah dimulai.

public void Open()

Peristiwa

DeviceClosed

Peristiwa perangkat ditutup.

public event Action DeviceClosed

DeviceOpened

Peristiwa perangkat terbuka, nilai bool menunjukkan berhasil atau tidak.

public event Action<bool, PermissionStatus, string> DeviceOpened