Executar rapidamente o projeto de exemplo do plug-in Mega para Mini Program WeChat

Este artigo apresentará como executar rapidamente o projeto de exemplo do plug-in Mega para Mini Program WeChat. Você aprenderá como:

Configurar o ambiente de desenvolvimento do projeto de exemplo.
Executar funcionalidades parciais do exemplo: usar o Mega Cloud Localization.

Antes de começar

Consulte o documento Meu banco de localização já pode ser usado? para confirmar que o banco de localização foi criado corretamente e o Mega Block foi adicionado.

Confirmar que o mini program tem uma entidade corporativa como titular

Importante

O plug-in Mega para mini programs suporta apenas entidades corporativas. Mini programs de titular pessoa física não podem usar o plug-in Mega.

Confirme no backoffice do mini program em Configurações > Informações básicas > Informações do titular que aparece Pessoa jurídica ou negócio individual.

Como as funcionalidades Mega são fornecidas como um plug-in, você precisa ter um mini program WeChat de entidade corporativa como ambiente hospedeiro.

Mesmo para executar nosso projeto de exemplo, você precisará configurar seu próprio AppID de mini program WeChat para depurar e visualizar nas ferramentas de desenvolvimento.

Baixar o projeto de exemplo

Acesse a página de download das ferramentas de desenvolvimento.
Após confirmar a Política de Privacidade EasyAR, clique para baixar.
Após o download, descompacte o pacote .zip localmente.

Configurar o projeto de exemplo

Faça login na ferramenta de desenvolvimento de mini-programas do WeChat.
Use a ferramenta de desenvolvimento de mini-programas do WeChat para importar o projeto de exemplo.
- Após abrir a ferramenta de desenvolvimento, clique no botão de importação e selecione o diretório local descompactado.
- Certifique-se de que o AppID corresponde ao AppID preenchido ao solicitar a licença Mega, com o modo de desenvolvimento como mini-programa. Clique em criar.
Nota

O AppID inconsistente causará falha na validação da licença
Configure a licença Mega e os serviços em nuvem

Abra o arquivo miniprogram/components/sample-data/easyar-settings.ts e preencha os campos correspondentes com as informações da licença e serviços preparados anteriormente:
- Licença Mega
```
/** Sua licença Mega para mini-programas */
export const EasyARLicenseKey: string = "";
```
Como obter a licença Mega para mini-programas do WeChat

No Centro de Desenvolvimento EasyAR, selecione Mega para Mini-Programa WeChat.

A lista deve incluir a licença Mega para mini-programas do WeChat que pretende usar. (Se não existir uma licença disponível, verifique se a conta usada para criar a biblioteca de localização Mega é a mesma)

Clique em nome do mini-programa para obter a licença Mega (clique em copiar à direita e cole no arquivo easyar-settings.ts como valor de EasyARLicenseKey). Confirme se o AppID associado corresponde totalmente ao AppID do seu mini-programa WeChat.
- API Key e Secret do serviço em nuvem
```
/** Sua API Key e Secret do serviço em nuvem */
export const EasyARAPIKey: string = "";
export const EasyARAPISecret: string = "";
```
Como obter a API Key e Secret do serviço em nuvem

No Centro de Desenvolvimento EasyAR, selecione API KEY do Serviço em Nuvem.

Se já tiver criado anteriormente, copie à direita e cole no arquivo easyar-settings.ts como valores de EasyARAPIKey e EasyARAPISecret.

Caso não tenha criado, proceda da seguinte forma:

Em Centro de Desenvolvimento EasyAR > API KEY do Serviço em Nuvem > Criar API KEY.

Insira o nome do aplicativo, selecione os serviços necessários: Mega Block e/ou Mega Landmark, clique em confirmar.
- ServerAddress e AppID do serviço em nuvem:
```
/** ServerAddress e AppID da sua biblioteca de localização em nuvem Mega */
export const MegaTrackerServerAddress: string = "";
export const MegaTrackerAppID: string = "";
```
Como obter ServerAddress e AppID da biblioteca de localização em nuvem Mega

No Centro de Desenvolvimento EasyAR, selecione Block Cloud Localization, depois escolha seu Grupo de Serviços de Localização em Nuvem Mega.

Selecione sua biblioteca de localização em nuvem Mega:

Clique em Chaves e obtenha abaixo o AppID e Server Address da biblioteca (copie à direita e cole no arquivo easyar-settings.ts como valores de MegaTrackerAppID e MegaTrackerServerAddress).

Executar o exemplo em dispositivo físico

Clique no botão de visualização em dispositivo real na barra superior da ferramenta de desenvolvimento de miniprograma para carregar no telefone de desenvolvimento através da leitura do código QR.

Cuidado

Não é possível simular diretamente componentes xr-frame com recursos AR na ferramenta de desenvolvimento.

Nota

Ao executar o projeto de exemplo pela primeira vez nas ferramentas de desenvolvimento do WeChat, se as permissões do plugin ainda não tiverem sido obtidas, a ferramenta geralmente exibirá um pop-up indicando que o plugin não está autorizado. A autorização pode ser feita automaticamente pelas ferramentas de desenvolvimento do WeChat ou seguindo o fluxo de acesso ao plugin
Clique em EasyAR Mega Samples para entrar na cena AR do projeto de exemplo.

Nota

Se não for possível entrar na cena AR do projeto de exemplo, pode ser devido ao dispositivo atual não suportar o componente de algoritmo visual VisionKit do WeChat. Consulte detalhes em restrições de modelo.
A mensagem EasyAR Session is initializing na tela indica que a detecção de plano do WeChat está sendo inicializada.

Dica

Garanta teste em ambiente com iluminação adequada, evitando paredes ou pisos com grandes áreas de cor sólida.

Balance o telefone suavemente para os lados apontando para o chão ou outro plano para acelerar este processo.
Após a conclusão da inicialização, posicione o telefone verticalmente para que a câmera capture uma cena real normal. Quando o posicionamento for bem-sucedido, a palavra Found aparecerá nas informações de depuração, e o indicador de status no canto inferior direito mudará de branco para verde.