Known issue dan limitation plugin Mega WeChat Mini Program

Artikel ini menjelaskan known issue dan limitation plugin Mega Mini Program selama penggunaan.

Known issue WeChat

Defect yang saat ini telah dikonfirmasi pada WeChat xr-frame atau VisionKit. Saat terjadi, fungsi AR akan gagal. Perhatikan skenario pemicu terkait saat development.

Exception plane detection WeChat

Dalam kondisi tertentu, seperti muncul white wall besar pada gambar atau kamera terhalang dalam waktu lama, plane detection yang disediakan WeChat dapat masuk ke state abnormal. Dalam state ini, MegaTracker tidak dapat bekerja normal.

Untuk metode penanganan, lihat Plane AR tracker exception handling.

Waktu inisialisasi Session lama

AR Session hanya dapat menyelesaikan inisialisasi setelah inisialisasi plane detection WeChat selesai. Dalam beberapa kasus, inisialisasi plane detection WeChat memerlukan waktu lama.

Alasan AR Session perlu menunggu inisialisasi xr-frame ARTracker selesai dapat dilihat di How MegaTracker works on xr-frame.

Referensi status: Dokumentasi status WeChat Mini Program AR tracker.
Contoh listening:

<xr-ar-tracker id="xrARTracker" mode="Plane" bind:ar-tracker-state="handleARTrackerState"></xr-ar-tracker>

handleARTrackerState({detail}) {
    if (detail.value.state == xrFrameSystem.EARTrackerState.Detected) {
        console.log('Plane is now detected by XR-Frame ARTracker.');
    }
}

worldPosition node tidak langsung diperbarui pada frame saat ini

Dalam contoh ini, trs.worldPosition tidak diperbarui tepat waktu:

public onTick(delta, data) {
    const trs = this.el.getComponent(xrFrameSystem.Transform);
    // WorldPosition node ini sebelum diperbarui
    console.log(`World Position before update: ${trs.worldPosition.x}, ${trs.worldPosition.y}, ${trs.worldPosition.z}`);
    // LocalPosition node ini sebelum diperbarui
    console.log(`Local Position before update: ${trs.Position.x}, ${trs.Position.y}, ${trs.Position.z}`);
    trs.position.x += 0.1;
    trs.position.y += 0.1;
    trs.position.z += 0.1;
    // WorldPosition node ini belum diperbarui
    console.log(`World Position after update: ${trs.worldPosition.x}, ${trs.worldPosition.y}, ${trs.worldPosition.z}`);
    // LocalPosition node ini diperbarui
    console.log(`Local Position after update: ${trs.Position.x}, ${trs.Position.y}, ${trs.Position.z}`);
}

Saat development, disarankan selalu menggunakan LocalTransform, yaitu el.getComponent(xrFrameSystem.Transform).position dan el.getComponent(xrFrameSystem.Transform).rotation.

Exception saat mengganti screen orientation

Jika "auto" diisi pada window dalam global configuration app.json WeChat Mini Program,

setelah device keluar dari Mini Program dalam landscape mode lalu masuk kembali dalam portrait mode, AR view dapat menjadi abnormal.

Karena itu, jangan gunakan "auto" dalam aplikasi AR Mini Program kapan pun.

Batasan penggunaan

Persyaratan wajib agar fitur berjalan. Jika tidak terpenuhi, fitur tidak tersedia, tetapi dapat dihindari dengan menyesuaikan configuration atau environment.

Batasan perangkat

Device yang menjalankan plugin Mega Mini Program setidaknya harus mendukung WeChat VisionKit V1 plane interface. Untuk hasil ideal, disarankan menggunakan device yang mendukung WeChat VisionKit V2 plane interface.

Daftar device yang didukung: lihat V2 plane AR interface support list.
Metode pengecekan cepat:
1. Scan QR code Sample resmi WeChat Mini Program.
2. Setelah masuk ke Mini Program, navigasi ke Interface > VisionKit visual capability > Horizontal plane AR-v2 untuk cepat menentukan apakah device saat ini didukung.

Jika perlu menggunakan layanan Mega pada device yang tidak mendukung VisionKit, lihat Navigation scene best practices dan gunakan EasyAR Sense AR navigation product yang mendukung hampir semua device.

Konfigurasi wajib PlaneMode

Karena batasan dukungan beberapa interface WeChat, planeMode harus diset ke 1.

<xr-scene ar-system="modes:Plane; planeMode: 1" bind:ready="handleReady">

Batasan fitur GPS

Align Block melalui GPS belum didukung.

Menempatkan annotation data melalui GPS belum didukung.

Table of Contents