Rápida ejecución del mini programa de muestra del plugin Mega de WeChat

Este artículo explica cómo ejecutar rápidamente el proyecto de muestra del plugin Mega para mini programas de WeChat. Aprenderá cómo:

Configurar y preparar el entorno de desarrollo del proyecto de muestra.
Ejecutar funcionalidades parciales del ejemplo: usar la localización en la nube de Mega.

Antes de comenzar

Consulte el documento ¿Está disponible mi biblioteca de localización? para confirmar que la biblioteca de localización se ha creado correctamente y se ha agregado el Mega Block.

Confirmar que el sujeto del mini programa es empresarial

Importante

El plugin Mega para mini programas solo admite sujetos empresariales. Los mini programas con sujeto personal no pueden usar el plugin Mega.

Confirme que en el portal del mini programa, en Configuración > Información básica > Información del sujeto, se muestre Persona jurídica empresarial o negocio individual.

Dado que las funciones Mega se proporcionan como un plugin, debe tener un mini programa de WeChat con sujeto empresarial como entorno anfitrión.

Incluso para ejecutar nuestro proyecto de muestra, debe configurar su propio ID de aplicación de mini programa de WeChat para depurar y obtener vistas previas en las herramientas de desarrollo.

Descargar el proyecto de muestra

Vaya a la página de descarga de herramientas de desarrollo.
Confirme la Política de privacidad de EasyAR y haga clic en descargar.
Una vez descargado, descomprima el archivo .zip localmente.

Configurar el proyecto de muestra

Inicie sesión en la herramienta de desarrollo de mini programas de WeChat.
Importe el proyecto de ejemplo utilizando la herramienta de desarrollo de mini programas de WeChat.
- Después de abrir la herramienta de desarrollo, haga clic en el botón de importar y seleccione el directorio local descomprimido.
- Asegúrese de que el AppID coincida con el AppID proporcionado al solicitar la licencia Mega y que el modo de desarrollo sea mini programa, luego haga clic en crear.
Nota

Un AppID diferente hará que falle la validación de la licencia
Configure la licencia Mega y el servicio en la nube

Abra el archivo miniprogram/components/sample-data/easyar-settings.ts y complete los campos correspondientes con la información de la licencia y el servicio obtenida en los preparativos:
- Licencia Mega
```
/** Su licencia Mega para mini programas */
export const EasyARLicenseKey: string = "";
```
Cómo obtener la licencia Mega para mini programas de WeChat

En el Centro de desarrollo de EasyAR, seleccione Mega para mini programas de WeChat.

Debe aparecer la licencia Mega para mini programas de WeChat que desea utilizar en la lista. (Si no hay una licencia disponible, verifique si su cuenta es la misma que la utilizada para crear la biblioteca de posicionamiento Mega).

Haga clic en el nombre del mini programa para obtener la licencia Mega (haga clic en copiar a la derecha y luego péguela en el archivo easyar-settings.ts como valor de EasyARLicenseKey). Confirme que el AppID asociado coincide exactamente con el AppID de su mini programa de WeChat.
- API Key y Secreto del servicio en la nube
```
/** Su API Key y Secreto del servicio en la nube */
export const EasyARAPIKey: string = "";
export const EasyARAPISecret: string = "";
```
Cómo obtener la API Key y Secreto del servicio en la nube

En el Centro de desarrollo de EasyAR, seleccione API KEY del servicio en la nube.

Si ya ha creado previamente una API Key y Secreto, puede copiarlas haciendo clic en el icono de copia a la derecha y pegarlas en el archivo easyar-settings.ts como valores de EasyARAPIKey y EasyARAPISecret.

Si no ha creado una API Key y Secreto previamente, puede crearlas de la siguiente manera:

En el Centro de desarrollo de EasyAR, seleccione API KEY del servicio en la nube > Crear API KEY.

Ingrese un nombre para la aplicación, seleccione los servicios en la nube que desea utilizar: Mega Block y/o Mega Landmark, luego haga clic en Aceptar.
- ServerAddress y AppID del servicio en la nube:
```
/** ServerAddress y AppID de su biblioteca de posicionamiento en la nube Mega */
export const MegaTrackerServerAddress: string = "";
export const MegaTrackerAppID: string = "";
```
Cómo obtener el ServerAddress y AppID de la biblioteca de posicionamiento en la nube Mega

En el Centro de desarrollo de EasyAR, seleccione Posicionamiento en la nube Block, luego elija su grupo de servicios de posicionamiento en la nube Mega.

Seleccione su biblioteca de posicionamiento en la nube Mega:

Haga clic en Claves y copie el AppID y Server Address de la biblioteca de posicionamiento (haga clic en copiar a la derecha y luego péguelos en el archivo easyar-settings.ts como valores de MegaTrackerAppID y MegaTrackerServerAddress).

Ejecutar la muestra en dispositivo físico

Haga clic en el botón de vista previa en dispositivo físico en la barra superior de la herramienta de desarrollo de miniapps, y cargue en el teléfono de desarrollo escaneando el código QR.

Precaución

No se puede simular directamente componentes de xr-frame con funciones AR en la herramienta de desarrollo.

Nota

Al ejecutar el proyecto de ejemplo por primera vez en las herramientas para desarrolladores de WeChat, si aún no se han obtenido los permisos del complemento, la herramienta generalmente mostrará una ventana emergente indicando que el complemento no está autorizado. Puede autorizar automáticamente mediante las herramientas para desarrolladores de WeChat, o consultar el flujo de acceso al complemento
Haga clic en EasyAR Mega Samples para ingresar a la escena AR del proyecto de ejemplo.

Nota

Si no puede ingresar a la escena AR del proyecto de ejemplo, puede deberse a que el dispositivo actual no es compatible con el componente de algoritmo visual de WeChat, VisionKit. Consulte limitaciones de dispositivos para más detalles.
El mensaje EasyAR Session is initializing en pantalla indica que la detección de planos de WeChat se está inicializando.

Consejo

Asegúrese de probar en un entorno con buena iluminación, evitando paredes o suelos de color liso en grandes áreas.

Balancee el teléfono de izquierda a derecha sobre una superficie plana a velocidad constante para acelerar este proceso.
Una vez completada la inicialización, sostenga el teléfono verticalmente para que la cámara capture una escena real normal. Cuando el posicionamiento sea exitoso, aparecerá Found en la información de depuración y el indicador de estado en la esquina inferior derecha cambiará de blanco a verde.