Руководство разработчика Cloud Anchors для Android NDK (C)

Узнайте, как использовать облачные привязки в своих приложениях.

Предварительные условия

Прежде чем продолжить, убедитесь, что вы понимаете фундаментальные концепции AR и то, как настроить сеанс ARCore .

Если вы новичок в облачных привязках, убедитесь, что вы понимаете, как работают привязки и облачные привязки .

Включите API ARCore

Прежде чем использовать Cloud Anchors в своем приложении, вы должны сначала включить API ARCore в своем приложении.

Включите возможности Cloud Anchor в конфигурации сеанса.

После включения функции Cloud Anchors в вашем приложении включите возможности Cloud Anchors в конфигурации сеанса AR вашего приложения, чтобы оно могло взаимодействовать с API ARCore:

// Create a new ARCore session.
ArSession* session = NULL;
CHECK(ArSession_create(env, context, &session) == AR_SUCCESS);

// Create a session config.
ArConfig* config = NULL;
ArConfig_create(session, &config);
ArSession_getConfig(session, config);

// Enable Cloud Anchor mode.
ArConfig_setCloudAnchorMode(session, config,
                            AR_CLOUD_ANCHOR_MODE_ENABLED);

// Configure the session.
ArSession_configure(session, config);
ArConfig_destroy(config);

Разместите облачный якорь

Хостинг начинается с вызова ArSession_hostCloudAnchorAsync() . ARCore загрузит визуальные данные, позы устройства и позу привязки в API ARCore. Затем API обрабатывает эту информацию для создания трехмерной карты объектов, в конечном итоге возвращая уникальный идентификатор облачной привязки для привязки к устройству.

Вы также можете продлить срок службы размещенной привязки с помощью API ARCore Cloud Anchor Management .

Чтобы завершить размещение Cloud Anchor, вашему приложению необходимо выполнить следующие действия:

1. Вызовите ArSession_hostCloudAnchorAsync() .
2. Дождитесь обратного вызова или постоянно проверяйте состояние Future, пока оно не будет выполнено.
3. Проверьте состояние результата, чтобы определить, завершилась ли операция успешно, или интерпретируйте код ошибки, если она не удалась.
4. Поделитесь полученным идентификатором Cloud Anchor с другими клиентами и используйте его для разрешения Cloud Anchor с помощью ArSession_resolveCloudAnchorAsync() .

Проверьте качество отображения характерных точек.

ArFeatureMapQuality указывает качество характерных точек, видимых ARCore за предыдущие несколько секунд в заданной позе камеры. Облачные привязки, размещенные с использованием функций более высокого качества, обычно решаются более точно. Используйте ArSession_estimateFeatureMapQualityForHosting() , чтобы получить оценку качества карты объектов для заданной позы камеры.

Разрешить ранее размещенную привязку

Вызовите ArSession_resolveCloudAnchorAsync() чтобы разрешить размещенную облачную привязку. API ARCore периодически сравнивает визуальные особенности сцены с трехмерной картой объектов привязки, чтобы точно определить положение и ориентацию пользователя относительно привязки. Когда API находит совпадение, он возвращает положение размещенного Cloud Anchor.

Вы можете последовательно инициировать решения для нескольких облачных якорей. Одновременно может выполняться до 40 одновременных операций Cloud Anchor.

Отменить операцию или удалить облачную привязку

Вызовите ArFuture_cancel() , чтобы отменить ожидающую операцию Cloud Anchor. Вызовите ArAnchor_detach() , чтобы прекратить отслеживание и забыть об уже разрешенной облачной привязке. Ссылки на якорь необходимо освободить отдельно, вызвав ArAnchor_release() .

Проверка состояния результата операции Cloud Anchor

Используйте ArCloudAnchorState, чтобы проверить статус результата операции размещения или разрешения, включая ошибки.

Квоты API для запросов хоста и разрешения

API ARCore имеет следующие квоты на пропускную способность запросов:

Рекомендации по улучшению пользовательского опыта

Попросите пользователей сделать следующее, чтобы обеспечить удобство использования вашего приложения:

• Подождите несколько секунд после начала сеанса, прежде чем пытаться разместить привязку (путем размещения объекта и т. д.). Это дает отслеживанию некоторое время для стабилизации.
• Выбирая место для размещения якоря, постарайтесь найти область с визуальными особенностями, которые легко отличить друг от друга. Для достижения наилучших результатов избегайте отражающих поверхностей или поверхностей, лишенных визуальных особенностей, таких как пустые белые стены.

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

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

Политика прекращения поддержки

• На приложения, созданные с помощью ARCore SDK 1.12.0 или более поздней версии, распространяется политика прекращения поддержки API Cloud Anchor .
• Приложения, созданные с помощью ARCore SDK 1.11.0 или более ранней версии, не могут размещать или разрешать облачные привязки из-за использования SDK более старого, устаревшего API ARCore.

Что дальше

• Ознакомьтесь со справочной документацией Android NDK, чтобы узнать больше о способах использования ARCore в вашем приложении.