Jalankan cepat proyek contoh plugin Mega untuk aplikasi mini WeChat

Artikel ini akan memperkenalkan cara menjalankan cepat proyek contoh plugin Mega untuk aplikasi mini WeChat. Anda akan mempelajari cara:

Menyiapkan dan mengonfigurasi lingkungan pengembangan untuk proyek contoh.
Menjalankan beberapa fungsi contoh: menggunakan pelokasian cloud Mega.

Sebelum memulai

Lihat dokumen Apakah perpustakaan pelokasian saya sudah dapat digunakan? untuk memastikan perpustakaan pelokasian telah dibuat dengan benar dan menambahkan Mega Block.

Konfirmasi subjek aplikasi mini sebagai badan usaha

Penting

Plugin aplikasi mini Mega hanya mendukung subjek badan usaha untuk aplikasi mini WeChat. Jenis subjek pribadi tidak dapat menggunakan plugin aplikasi mini Mega.

Perlu dikonfirmasi di backend aplikasi mini bahwa Pengaturan > Informasi dasar > Informasi subjek menampilkan badan hukum perusahaan atau bisnis perorangan.

Karena fungsi Mega disediakan dalam bentuk plugin aplikasi mini, Anda harus memiliki aplikasi mini WeChat dengan subjek badan usaha sebagai lingkungan inang.

Bahkan hanya untuk menjalankan proyek contoh yang kami sediakan, Anda perlu mengonfigurasi AppID aplikasi mini WeChat Anda sendiri untuk melakukan debugging dan pratinjau di alat pengembang.

Unduh proyek contoh

Kunjungi halaman unduh alat pengembang.
Setelah mengonfirmasi Kebijakan Privasi EasyAR, klik unduh.
Setelah pengunduhan selesai, ekstrak file .zip di lokal.

Konfigurasi proyek contoh

Masuk ke alat pengembang WeChat Mini Program.
Gunakan alat pengembang WeChat Mini Program untuk mengimpor proyek contoh.
- Setelah membuka alat pengembang, klik tombol impor, pilih direktori lokal yang telah diekstrak.
- Pastikan AppID cocok dengan AppID yang diisi saat mengajukan lisensi Mega, mode pengembangan adalah Mini Program, lalu klik buat.
[!CATATAN] AppID yang tidak cocok akan menyebabkan verifikasi lisensi gagal
Konfigurasi lisensi Mega dan layanan cloud

Buka file miniprogram/components/sample-data/easyar-settings.ts, isi bidang yang sesuai dalam file ini dengan informasi lisensi dan layanan dari persiapan:
- Lisensi Mega
```
/** Lisensi Mega mini program Anda */
export const EasyARLicenseKey: string = "";
```
Cara mendapatkan lisensi Mega WeChat Mini Program

Pilih Mega WeChat Mini Program di EasyAR Development Center.

Lisensi Mega WeChat Mini Program yang ingin digunakan harus ada dalam daftar. (Jika tidak ada lisensi yang tersedia, periksa apakah akun Anda dan akun yang digunakan untuk membuat perpustakaan pelacakan Mega adalah sama)

Klik nama mini program untuk mendapatkan lisensi Mega untuk mini program tersebut (klik salin di sebelah kanan, lalu tempel ke file easyar-settings.ts sebagai nilai EasyARLicenseKey), dan pastikan AppID yang terkait sepenuhnya cocok dengan AppID WeChat Mini Program Anda.
- Kunci API dan Sekret layanan cloud
```
/** Kunci API dan Sekret layanan cloud Anda */
export const EasyARAPIKey: string = "";
export const EasyARAPISecret: string = "";
```
Cara mendapatkan kunci API dan sekret layanan cloud

Pilih Cloud Service API KEY di EasyAR Development Center.

Jika sebelumnya Anda telah membuat kunci API dan sekret layanan cloud, Anda dapat menyalinnya secara berurutan dengan mengklik salin di sebelah kanan, lalu tempel ke file easyar-settings.ts sebagai nilai EasyARAPIKey dan EasyARAPISecret.

Jika Anda belum pernah membuat kunci API dan sekret layanan cloud sebelumnya, Anda dapat membuatnya dengan cara berikut:

Pilih Cloud Service API KEY > Buat API KEY di EasyAR Development Center.

Masukkan nama aplikasi, centang layanan cloud yang ingin digunakan: Mega Block dan/atau Mega Landmark, lalu klik OK.
- ServerAddress dan AppID layanan cloud:
```
/** ServerAddress dan AppID perpustakaan pelacakan cloud Mega Anda */
export const MegaTrackerServerAddress: string = "";
export const MegaTrackerAppID: string = "";
```
Cara mendapatkan ServerAddress dan AppID perpustakaan pelacakan cloud Mega

Pilih Block Cloud Localization di EasyAR Development Center, lalu pilih grup layanan pelacakan cloud Mega Anda.

Pilih perpustakaan pelacakan cloud Mega Anda:

Klik Key, lalu dapatkan AppID dan Server Address perpustakaan pelacakan cloud di bawah (klik salin di sebelah kanan, lalu tempel ke file easyar-settings.ts sebagai nilai MegaTrackerAppID dan MegaTrackerServerAddress).

Jalankan contoh di perangkat nyata

Klik tombol pratinjau perangkat nyata di bilah atas alat pengembangan applet, lalu muat ke ponsel pengembangan dengan memindai kode QR.

Hati-Hati

Tidak dapat menjalankan simulasi komponen xr-frame dengan fungsi AR langsung di alat pengembangan.

Catatan

Saat pertama kali menjalankan proyek contoh di alat pengembang WeChat, jika izin plugin belum diperoleh, alat biasanya akan muncul peringatan bahwa plugin tidak diotorisasi. Dapat diotorisasi otomatis melalui alat pengembang WeChat, atau merujuk ke Alur akses plugin
Klik EasyAR Mega Samples untuk memasuki adegan AR proyek contoh.

Catatan

Jika tidak dapat memasuki adegan AR proyek contoh, mungkin karena perangkat saat ini tidak mendukung komponen algoritma visual WeChat VisionKit, silakan lihat Pembatasan model perangkat.
Petunjuk EasyAR Session is initializing di layar menunjukkan bahwa deteksi bidang WeChat sedang diinisialisasi.

Kiat

Pastikan pengujian dilakukan di lingkungan dengan pencahayaan yang cukup, hindari dinding atau lantai polos dengan area besar.

Arahkan kamera ke lantai atau bidang datar lainnya, lalu ayunkan perlahan ke kiri dan kanan untuk mempercepat proses ini.
Setelah inisialisasi selesai, pegang ponsel secara vertikal agar kamera menangkap pemandangan nyata normal. Saat pelacakan berhasil, teks Found muncul di informasi Debug, dan indikator status di kanan bawah berubah dari putih menjadi hijau.

Table of Contents

Jalankan cepat proyek contoh plugin Mega untuk aplikasi mini WeChat

Sebelum memulai

Konfirmasi subjek aplikasi mini sebagai badan usaha

Penting

Unduh proyek contoh

Konfigurasi proyek contoh

Jalankan contoh di perangkat nyata

Hati-Hati

Catatan

Catatan

Kiat

Langkah selanjutnya

Topik terkait