Table of Contents

Best practices untuk skenario navigasi

Dalam skenario navigasi, memberikan user experience yang smooth dan akurat sangat penting. EasyAR Mega menyediakan beberapa mode xDoF untuk menyesuaikan berbagai device capabilities dan kebutuhan environment. Memahami perbedaan antar mode ini dan memilih berdasarkan karakteristik platform adalah kunci untuk membangun aplikasi navigasi yang baik.

Memilih tracking mode yang benar

Berdasarkan Mega localization, Anda dapat memilih tracking mode yang berbeda sesuai sensor capabilities yang disediakan device dan kebutuhan aplikasi untuk meningkatkan navigation experience.

Untuk phone yang memiliki ARKit atau ARCore, Anda cukup menggunakan default 6DoF tracking mode. Dikombinasikan dengan Mega spatial localization, ini dapat memberikan continuous route navigation yang stabil dan smooth, serta user navigation experience terbaik.

Namun, untuk model kelas menengah ke bawah dengan dukungan ARKit atau ARCore yang tidak jelas, atau untuk user base yang paling luas, memilih mode xDoF yang tepat sangat penting. Mode kerja xDoF yang berbeda akan langsung memengaruhi tracking effect pada terminal device.

Untuk model seperti ini, Anda perlu menguji dan memilih mode kerjanya dengan urutan prioritas berikut:

  • Inertial navigation / mode 5DoF

    • Deskripsi: Menggunakan sensor device dan algoritma inertial navigation bawaan EasyAR untuk menerapkan 5DoF tracking, sehingga sampai batas tertentu menyediakan continuous route navigation yang stabil dan smooth.
    • Behavior: Saat user berjalan, virtual route indicator seperti arrow di ground akan tetap stabil menempel pada ground. Meski user sebentar menggoyangkan device atau mengubah arah, indicator tidak akan meloncat besar. Namun jika ada naik atau turun pada arah ketinggian, seperti naik turun tangga, virtual content tidak lagi menempel dan akan mengambang di udara atau berada di bawah ground.
    • Requirement: Device perlu memiliki gyroscope dan accelerometer berkualitas tinggi.
    • Skenario yang sesuai: Sebagian besar skenario navigasi indoor dan outdoor, sebagai fallback pilihan utama saat 6DoF tidak tersedia.
  • Mode 3DoF

    • Deskripsi: Saat device tidak memiliki accelerometer tetapi memiliki gyroscope, dapat fallback ke mode 3DoF.
    • Behavior: Dalam mode 3DoF, navigation indicator akan berputar sesuai orientation device (pitch, yaw, roll), tetapi saat user translate (maju, mundur, atau bergeser), position di space dari indicator tidak diperbarui. Indicator akan selalu menunjuk ke arah yang benar seperti compass, tetapi tidak mengikuti langkah user bergerak di map.
    • Requirement: Device setidaknya perlu memiliki gyroscope.
    • Skenario yang sesuai: Fallback saat 5DoF juga tidak tersedia. Dapat digunakan untuk direction guidance sederhana, tetapi tidak cocok untuk navigasi kompleks yang membutuhkan precise route following.
  • Mode 0DoF

    • Deskripsi: Ini adalah mode paling dasar, hampir berlaku untuk semua device, tetapi user experience juga paling terbatas.
    • Behavior: Dalam mode 0DoF, device tidak dapat merasakan movement atau rotation dirinya. Navigation indicator akan tetap di posisi tertentu pada screen, misalnya arrow di tengah screen, dan hanya menunjukkan relative direction target, misalnya target berada di kiri depan Anda.
    • Requirement: Tidak ada requirement sensor khusus.
    • Skenario yang sesuai: Sebagai fallback terakhir, atau untuk fitur sederhana "find direction", mirip compass pada navigasi tradisional.

Ringkasan perbandingan experience:

Tracking mode Behavior saat user bergerak User experience Rekomendasi
6DoF Virtual route stabil mengikuti berbagai movement user di real space Terbaik, immersive dan akurat ⭐⭐⭐⭐⭐
5DoF (inertial navigation) Virtual route stabil mengikuti movement user, tetapi gagal saat ketinggian berubah Kedua terbaik, fallback pilihan utama saat 6DoF gagal ⭐⭐⭐⭐
3DoF Route indicator berputar mengikuti orientation device, tetapi tidak mengikuti movement user Umum, dapat menunjukkan arah tetapi kurang sense of spatial following ⭐⭐⭐
0DoF Indicator tetap di screen dan hanya menampilkan arah target Dasar, hanya memberikan informasi arah

Catatan khusus untuk platform WeChat Mini Program

Penting: Mega WeChat MiniProgram Plugin pada platform WeChat Mini Program belum sepenuhnya merilis dukungan untuk fitur 5DoF (inertial navigation), 3DoF, dan 0DoF.

Pada WeChat Mini Program, tahap saat ini terutama mendukung navigation experience mode 6DoF.

  • Current behavior: Setelah user memulai navigasi berbasis Mega dalam Mini Program, jika running device itu sendiri tidak mendukung mode 6DoF, ARSession akan gagal start dan melaporkan error pada terminal.
  • Development recommendation: Saat merencanakan fitur navigasi pada WeChat Mini Program, desainlah dengan premis mode 6DoF. Lihat dokumentasi resmi WeChat untuk daftar device support, atau periksa apakah device didukung melalui API call kami.
const easyarPlugin: easyar.EasyARWechatMiniprogramPlugin = requirePlugin("easyar-wechat-miniprogram") as easyar.EasyARWechatMiniprogramPlugin;

if (easyarPlugin.isMegaTrackerSupported() === false) {
    const message = `当前设备不支持 VK v1 和 v2,请参考微信官方文档:https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/visionkit/plane.html`;
    wx.showModal({
        title: "设备不支持",
        content: message,
        showCancel: false,
    });
    console.error(message);
}

Solusi alternatif untuk platform WeChat Mini Program

Untuk developer yang perlu membangun aplikasi navigasi dengan complete device support di WeChat Mini Program, kami sangat menyarankan untuk langsung menggunakan produk SightPlus AR Navigation kami.

Produk navigasi ini adalah solusi yang dioptimalkan khusus untuk ekosistem Mini Program dan memiliki keunggulan berikut:

  • Ready to use: Tidak perlu integrasi Mega SDK yang kompleks. Anda dapat cepat mengintegrasikannya melalui API call sederhana.
  • Broad compatibility: Kompatibel luas dengan berbagai terminal device, mendukung hampir semua device dari 0DoF hingga 6DoF.
  • Complete features: Mendukung fitur navigasi lanjutan seperti route planning lengkap, yaw correction, turn prompts, dan digital human guidance.
  • Supporting tools lengkap: Menyediakan backend dan tools lengkap untuk information management, road network deployment, POI adjustment, route calculation services, dan lainnya.
  • Experience optimization: Dioptimalkan secara mendalam untuk karakteristik performance dan interaction WeChat Mini Program agar memastikan user experience yang smooth.

Bagaimana memulai?
Kunjungi halaman resmi AR Navigation untuk mempelajari cara cepat mengintegrasikan dan menggunakan produk navigasi kami untuk membangun aplikasi Mini Program Anda.

Ringkasan best practice

  • Saat mengembangkan App pada device Android/iOS atau pada headset device yang mendukung 6DoF, prioritaskan mode Mega + 6DoF untuk mendapatkan navigation experience terbaik. Sesuai kondisi actual running device, fallback ke 5DoF, 3DoF, dan 0DoF untuk memaksimalkan broad device compatibility.
  • Pada platform WeChat Mini Program, tahap saat ini hanya mendukung running pada device mode 6DoF, atau langsung integrasikan SightPlus AR Navigation untuk memperoleh complete device support dan product features yang kaya.