Быстрый запуск демонстрационного проекта плагина Mega для мини-программы WeChat

В этой статье описывается, как быстро запустить демонстрационный проект плагина Mega для мини-программы WeChat. Вы узнаете, как:

Настроить среду разработки для демонстрационного проекта.
Опробовать облачную локализацию Mega в демонстрационном проекте.
Отобразить файл маски из результатов картографирования и проверить совмещение модели с реальной обстановкой.

Перед началом

См. Доступна ли мне функция локализации?, чтобы убедиться, что база локализации создана правильно и карты добавлены.

Убедитесь, что мини-программа зарегистрирована на предприятие

Важно

Плагин Mega для мини-программ поддерживает только мини-программы WeChat, зарегистрированные на предприятие. Мини-программы, зарегистрированные на физическое лицо, не могут использовать этот плагин.

В панели управления мини-программой откройте Настройки > Основная информация > Сведения о владельце и убедитесь, что указан тип юридическое лицо или индивидуальный предприниматель.

Поскольку функции Mega предоставляются в виде плагина, для его запуска нужна мини-программа WeChat, зарегистрированная на предприятие.

Даже для запуска нашего демонстрационного проекта необходимо указать AppID собственной мини-программы WeChat, чтобы отлаживать и предварительно просматривать его в инструментах разработчика.

Скачивание демонстрационного проекта

Перейдите на страницу загрузки инструментов разработчика.
Ознакомьтесь с Политикой конфиденциальности EasyAR и нажмите кнопку загрузки.
После завершения загрузки распакуйте пакет .zip локально.

Настройка демонстрационного проекта

Войдите в инструменты разработчика мини-программ WeChat.
Импортируйте демонстрационный проект через инструменты разработчика мини-программ WeChat.
- Откройте инструменты разработчика, нажмите кнопку импорта и выберите каталог, распакованный на компьютере.
- Убедитесь, что AppID совпадает с AppID, указанным при запросе лицензии Mega, выберите режим разработки Мини-программа и нажмите Создать.
Примечание

Несовпадение AppID приведет к ошибке проверки лицензии
Настройка лицензии Mega и облачного сервиса

Откройте файл miniprogram/components/sample-data/easyar-settings.ts и заполните соответствующие поля согласно информации о лицензии и сервисе из подготовительных шагов:
- Лицензия Mega
```
/** Ваша лицензия Mega для мини-программы */
export const EasyARLicenseKey: string = "";
```
Как получить лицензию Mega WeChat Mini Program

В EasyAR Developer Center выберите Mega WeChat Mini Program.

В списке должна быть лицензия Mega WeChat Mini Program, которую нужно использовать. Если доступной лицензии нет, проверьте, совпадает ли ваша учетная запись с учетной записью, использованной для создания базы локализации Mega.

Нажмите имя Mini Program, чтобы получить ее лицензию Mega. Нажмите Copy справа, вставьте в easyar-settings.ts как значение EasyARLicenseKey и убедитесь, что связанный AppID полностью совпадает с AppID вашего WeChat Mini Program.
- API Key и Seceret облачного сервиса
```
/** Ваши API Key и Seceret облачного сервиса */
export const EasyARAPIKey: string = "";
export const EasyARAPISecret: string = "";
```
Как получить API Key и Seceret облачного сервиса

В EasyAR Developer Center выберите Cloud Service API KEY.

Если API Key и Seceret облачного сервиса уже были созданы, нажмите Copy справа по очереди и вставьте их в easyar-settings.ts как значения EasyARAPIKey и EasyARAPISecret.

Если API Key и Seceret облачного сервиса раньше не создавались, создайте их следующим образом:

В EasyAR Developer Center выберите Cloud Service API KEY > Create API KEY.

Введите имя приложения, выберите нужные облачные сервисы: Mega Block и/или Mega Landmark, затем нажмите Confirm.
- ServerAddress и AppID облачного сервиса：
```
/** ServerAddress и AppID вашей облачной базы локализации Mega */
export const MegaTrackerServerAddress: string = "";
export const MegaTrackerAppID: string = "";
```
Как получить ServerAddress и AppID облачной базы локализации Mega

В EasyAR Developer Center выберите Block Cloud Localization, затем выберите вашу группу облачного сервиса локализации Mega.

Выберите вашу облачную базу локализации Mega:

Нажмите Key, затем ниже по очереди получите AppID и Server Address облачной базы локализации. Нажмите Copy справа и вставьте их в easyar-settings.ts как значения MegaTrackerAppID и MegaTrackerServerAddress.
Быстрая проверка с файлом маски из результатов построения карты

Скачайте файл маски в формате glb через пункт Скачать файл маски в облачной базе локализации. Он позволяет показать трёхмерную белую модель реального пространства и проверить её совмещение без создания аннотаций.

Примечание

Этот способ доступен только для результатов построения карты версии 9.6 или новее.

Найдите проверяемый Block в облачной базе локализации и нажмите Скачать файл маски в столбце Действия. Проверяйте результат на месте, соответствующем этому Block.

Во всплывающем окне выберите Низкая точность и нажмите Скачать, чтобы снизить нагрузку при загрузке и отображении модели на телефоне.

Поместите загруженные файлы glb в каталог assets проекта Mini Program (miniprogram/assets/ в примере), сохранив исходные положение, поворот и масштаб каждой модели.

В файле miniprogram/components/sample-easyar-mega/index.ts задайте для src в конфигурации occlusionMeshAssets путь относительно корневого каталога проекта Mini Program. Конфигурация по умолчанию:
```
const occlusionMeshAssets = [
    {
        assetId: "occlusionMesh00",
        type: "gltf",
        src: "assets/Low_Poly_occlusion.glb",
        options: {}
    },
];
```
Если загруженная маска содержит несколько файлов GLB, добавьте в occlusionMeshAssets запись для каждого файла с уникальным assetId и соответствующим src. Пример загружает файлы, прикрепляет сетки маски к локализованному Block и применяет встроенные материалы отображения и окклюзии. Переключатель Файл маски на странице показывает или скрывает сетки. Ресурсы освобождаются вместе с компонентом примера; дополнительная логика загрузки или освобождения не требуется.

Запуск примера на реальном устройстве

Нажмите кнопку предварительного просмотра на реальном устройстве в верхней панели инструментов разработчика мини-программ и отсканируйте QR-код, чтобы загрузить проект на телефон.

Осторожно

Компоненты xr-frame с функциями AR нельзя запускать непосредственно в симуляторе инструментов разработчика.

Примечание

При первом запуске демонстрационного проекта в инструментах разработчика WeChat, если доступ к плагину ещё не предоставлен, появится уведомление об отсутствии разрешения. Предоставьте разрешение в инструментах разработчика WeChat или изучите процедуру подключения плагина
Нажмите EasyAR Mega Samples, чтобы открыть AR-сцену демонстрационного проекта.

Примечание

Если AR-сцена демонстрационного проекта не открывается, возможно, устройство не поддерживает компонент компьютерного зрения WeChat VisionKit. См. ограничения по устройствам.
Сообщение EasyAR Session is initializing на экране означает, что обнаружение плоскости WeChat находится на этапе инициализации.

Совет

Убедитесь, что тестирование проводится при хорошем освещении, и избегайте больших однотонных стен или однотонных полов.

Направьте камеру на пол или другую плоскую поверхность и равномерно перемещайте телефон влево и вправо, чтобы ускорить процесс.
После инициализации держите телефон вертикально, чтобы камера снимала реальную обстановку. При успешной локализации в информации Debug появится Found, а индикатор в правом нижнем углу сменит цвет с белого на зелёный.
Проверка совмещения файла маски с реальной обстановкой

После настройки отображения файла маски дождитесь загрузки модели и успешной локализации в соответствующем Block. Включите переключатель Файл маски на странице, чтобы увидеть трёхмерную белую модель поверх изображения камеры и проверить её совмещение с реальной обстановкой.