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

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

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

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

Обратитесь к документу Готов ли мой локализационный блок к использованию?, чтобы убедиться, что локализационный блок создан правильно и добавлен в Mega Block.

Подтвердите, что основная учетная запись Mini Program является корпоративной

Важно

Плагин Mega для Mini Program поддерживает только корпоративные учетные записи WeChat Mini Program. Mini Program с личной учетной записью не могут использовать плагин Mega для Mini Program.

Необходимо подтвердить в административной панели Mini Program в разделе Настройки > Основная информация > Информация об учетной записи, что указан тип Юридическое лицо предприятия или Индивидуальное предпринимательство.

Поскольку функционал Mega предоставляется в виде плагина для Mini Program, у вас должна быть корпоративная WeChat Mini Program, которая будет выступать в качестве хост-среды.

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

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

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

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

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

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

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

В Центре разработки EasyAR выберите Mega WeChat Mini Program.

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

Нажмите на название Mini Program, чтобы получить лицензию Mega для этой программы (нажмите «Копировать» справа, затем вставьте в файл 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 выберите Cloud Service API KEY.

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

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

В Центре разработки EasyAR выберите Cloud Service API KEY > Create API KEY.

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

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

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

Нажмите Keys, ниже последовательно получите AppID и Server Address библиотеки локализации (нажмите «Копировать» справа, затем вставьте в файл easyar-settings.ts как значения MegaTrackerAppID и MegaTrackerServerAddress).

Запуск демо на устройстве

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

Осторожно

Нельзя напрямую имитировать работу компонента xr-frame с функцией AR в инструментах разработки.

Примечание

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

Примечание

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

Совет

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

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