Table of Contents

MegaTracker аутентификация облачного сервиса

Эта статья описывает способы указания аутентификации при использовании облачного сервиса MegaTracker.

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

Использование API Key и API Secret для аутентификации

Этот метод подходит для традиционной проверки с помощью пары ключей. Вам необходимо использовать APIKeyAccessData для создания объекта access в MegaTrackerConfigs.

const apiKeyAccess = new mega.APIKeyAccessData(
    settings.MegaTrackerAppID, // Идентификатор приложения сервиса позиционирования Mega
    settings.MegaTrackerServerAddress, // Адрес сервиса позиционирования Mega
    settings.EasyARAPIKey, // Строка APIKey
    settings.EasyARAPISecret // Строка APISecret
);
const megaTrackerConfigs: easyar.MegaTrackerConfigs = {
    access: apiKeyAccess
};
const sessionConfigs: easyar.SessionConfigs = {
    megaTrackerConfigs: megaTrackerConfigs,
    licenseKey: settings.EasyARLicenseKey
};
session = megaComponent.createSession(sessionConfigs);

В этом примере сначала создается APIKeyAccessData, используя appId библиотеки облачного позиционирования, serverAddress облачного сервиса, apiKey и apiSecret из конфигурации.

Затем созданный APIKeyAccessData используется для создания MegaTrackerConfigs. Это означает, что будет использоваться аутентификация с помощью API Key и API Secret.

Использование API Token для аутентификации

Если возможно регулярно (каждые несколько минут или часов) обновлять и выдавать APIToken на сервере, использование этого метода повышает безопасность, так как позволяет избежать прямой подписи запросов на позиционирование с помощью APISecret. Способ обновления APIToken см. в разделе Методы создания и использования токена.

Вы можете настроить таймер на фронтенде для обновления токена в соответствии со сроком его действия.

Сначала создайте TokenAccessData, используя AppID библиотеки позиционирования Mega и адрес сервиса позиционирования из настроек.

Затем используйте созданный TokenAccessData для создания MegaTrackerConfigs.

Затем создайте SessionConfigs, используя MegaTrackerConfigs и licenseKey из конфигурации.

Наконец, используйте метод createSession(sessionConfigs) компонента EasyARMegaComponent, прикрепленного к сцене xr-frame, для создания сессии.

Когда срок действия токена истечет, необходимо вызвать updateToken(apiToken) для его обновления. В противном случае сервис Mega станет недоступен, а статус в результатах позиционирования всегда будет ApiTokenExpired.

const tokenAccess = new mega.TokenAccessData(
    settings.MegaTrackerAppID, // Идентификатор приложения сервиса позиционирования Mega
    settings.MegaTrackerServerAddress, // Адрес сервиса позиционирования Mega
    "your_api_token" // Строка APIToken
);
const megaTrackerConfigs: easyar.MegaTrackerConfigs = {
    access: tokenAccess
};
const sessionConfigs: easyar.SessionConfigs = {
    megaTrackerConfigs: megaTrackerConfigs,
    licenseKey: settings.EasyARLicenseKey
};
session = megaComponent.createSession(sessionConfigs);

Этот пример демонстрирует, как использовать TokenAccessData для создания MegaTrackerConfigs и как использовать этот MegaTrackerConfigs для создания сессии с целью аутентификации с помощью APIToken.