Eseguire rapidamente il progetto di esempio del plug-in Mega per mini program WeChat

Questo articolo spiega come eseguire rapidamente il progetto di esempio del plug-in Mega per mini program WeChat. Imparerai come:

Configurare l'ambiente di sviluppo per il progetto di esempio.
Eseguire funzioni parziali dell'esempio: utilizzare la localizzazione cloud Mega.

Prima di iniziare

Consultare il documento La mia libreria di localizzazione è utilizzabile? per confermare che la libreria di localizzazione sia stata creata correttamente e che sia stato aggiunto il Mega Block.

Confermare che il soggetto del mini program sia aziendale

Importante

Il plug-in Mega per mini program supporta solo soggetti aziendali. I mini program di soggetti individuali non possono utilizzare il plug-in Mega per mini program.

Verificare che nella piattaforma di gestione dei mini program in Impostazioni > Informazioni di base > Informazioni sul soggetto sia indicato Persona giuridica dell'impresa o attività individuale.

Poiché le funzionalità Mega sono fornite come plug-in per mini program, è necessario disporre di un mini program WeChat con soggetto aziendale come ambiente host.

Anche solo per eseguire il nostro progetto di esempio, è necessario configurare il proprio AppID del mini program WeChat per eseguire debug e anteprime negli strumenti di sviluppo.

Scaricare il progetto di esempio

Andare alla pagina di download degli strumenti di sviluppo.
Dopo aver confermato l'Informativa sulla privacy di EasyAR, fare clic su Scarica.
Al termine del download, decomprimere il pacchetto .zip in locale.

Configurare il progetto di esempio

Accedere allo strumento di sviluppo per mini-programmi WeChat.
Importare il progetto demo utilizzando lo strumento di sviluppo per mini-programmi WeChat.
- Dopo aver aperto lo strumento di sviluppo, fare clic sul pulsante Importa e selezionare la directory locale estratta.
- Assicurarsi che l'AppID corrisponda a quello inserito quando si richiede la licenza Mega e che la modalità di sviluppo sia Mini-programma. Fare clic su Crea.
Nota

Un AppID non corrispondente causerà il fallimento della verifica della licenza.
Configurare la licenza Mega e il servizio cloud

Aprire il file miniprogram/components/sample-data/easyar-settings.ts e inserire nei campi corrispondenti le informazioni sulla licenza e sul servizio ottenute nei passi preliminari:
- Licenza Mega per mini-programma
```
/** La tua licenza Mega per mini-programma */
export const EasyARLicenseKey: string = "";
```
Come ottenere una licenza Mega per mini-programma WeChat

Selezionare Mega per mini-programma WeChat nel Centro di sviluppo EasyAR.

Nell'elenco dovrebbe essere presente la licenza Mega per mini-programma WeChat da utilizzare. (Se non è disponibile alcuna licenza, verificare che l'account sia lo stesso usato per creare la libreria di localizzazione Mega).

Fare clic su Nome del mini-programma per ottenere la licenza Mega corrispondente (fare clic su Copia a destra, quindi incollare nel file easyar-settings.ts come valore di EasyARLicenseKey). Assicurarsi che l'AppID associato corrisponda esattamente all'AppID del tuo mini-programma WeChat.
- API Key e Secret del servizio cloud
```
/** La tua API Key e Secret del servizio cloud */
export const EasyARAPIKey: string = "";
export const EasyARAPISecret: string = "";
```
Come ottenere l'API Key e il Secret del servizio cloud

Selezionare API KEY del servizio cloud nel Centro di sviluppo EasyAR.

Se sono già stati creati in precedenza, è possibile copiarli facendo clic sul pulsante Copia a destra e incollarli nel file easyar-settings.ts come valori di EasyARAPIKey e EasyARAPISecret.

Se non sono stati creati in precedenza, è possibile crearli come segue:

Nel Centro di sviluppo EasyAR, selezionare API KEY del servizio cloud > Crea API KEY.

Inserire il nome dell'applicazione, selezionare i servizi cloud necessari: Mega Block e/o Mega Landmark, quindi fare clic su OK.
- ServerAddress e AppID del servizio cloud:
```
/** Il ServerAddress e l'AppID della tua libreria di localizzazione cloud Mega */
export const MegaTrackerServerAddress: string = "";
export const MegaTrackerAppID: string = "";
```
Come ottenere ServerAddress e AppID della libreria di localizzazione cloud Mega

Nel Centro di sviluppo EasyAR, selezionare Localizzazione cloud Block, quindi il tuo Gruppo servizi di localizzazione cloud Mega.

Selezionare la tua libreria di localizzazione cloud Mega:

Fare clic su Chiavi e copiare di seguito l'AppID e il Server Address della libreria (fare clic su Copia a destra, quindi incollare nel file easyar-settings.ts come valori di MegaTrackerAppID e MegaTrackerServerAddress).

Eseguire l'esempio su dispositivo fisico

Clicca il pulsante di anteprima live nella barra superiore degli strumenti di sviluppo del mini-programma, carica sul telefono di sviluppo scansionando il codice QR.

Attenzione

Non è possibile simulare direttamente componenti xr-frame con funzionalità AR negli strumenti di sviluppo.

Nota

Quando esegui per la prima volta il progetto di esempio negli strumenti di sviluppo WeChat, se non hai ancora ottenuto i permessi per il plugin, lo strumento mostrerà un popup che indica che il plugin non è autorizzato. Puoi autorizzarlo automaticamente tramite gli strumenti di sviluppo WeChat o fare riferimento al flusso di integrazione del plugin
Clicca EasyAR Mega Samples per accedere alla scena AR del progetto di esempio.

Nota

Se non riesci ad accedere alla scena AR del progetto di esempio, potrebbe essere dovuto al fatto che il dispositivo corrente non supporta il componente algoritmico visivo VisionKit di WeChat. Per dettagli, consulta limitazioni dei dispositivi.
La scritta EasyAR Session is initializing sullo schermo indica che il rilevamento delle superfici di WeChat si sta inizializzando.

Consiglio

Assicurati di testare in un ambiente con illuminazione adeguata, evitando pareti o pavimenti con ampie superfici monocromatiche.

Muovi il telefono uniformemente da sinistra a destra puntando verso il pavimento o altre superfici per accelerare il processo.
Al termine dell'inizializzazione, tieni il telefono in verticale in modo che la fotocamera inquadri una normale scena reale. Quando il posizionamento riesce, apparirà la scritta Found nelle informazioni di debug e l'indicatore di stato in basso a destra passerà da bianco a verde.