Table of Contents

MegaTracker authentification des services cloud

Cet article explique comment spécifier la méthode d'authentification lors de l'utilisation des services cloud avec MegaTracker.

Avant de commencer

Utilisation de l'authentification par API Key et API Secret

Cette méthode convient pour la vérification traditionnelle par paire de clés. Vous devez utiliser APIKeyAccessData pour construire l'objet access dans MegaTrackerConfigs.

const apiKeyAccess = new mega.APIKeyAccessData(
    settings.MegaTrackerAppID, // AppID du service de localisation Mega
    settings.MegaTrackerServerAddress, // Adresse du service de localisation Mega
    settings.EasyARAPIKey, // Chaîne APIKey
    settings.EasyARAPISecret // Chaîne APISecret
);
const megaTrackerConfigs: easyar.MegaTrackerConfigs = {
    access: apiKeyAccess
};
const sessionConfigs: easyar.SessionConfigs = {
    megaTrackerConfigs: megaTrackerConfigs,
    licenseKey: settings.EasyARLicenseKey
};
session = megaComponent.createSession(sessionConfigs);

Dans cet exemple, APIKeyAccessData est d'abord créé en utilisant le appId de la bibliothèque de localisation cloud, l'adresse du service cloud serverAddress, la apiKey et la apiSecret du service cloud à partir de la configuration.

Ensuite, MegaTrackerConfigs est créé en utilisant le APIKeyAccessData généré. Cela signifie que l'authentification par API Key et API Secret sera utilisée.

Utilisation de l'authentification par API Token

Si vous pouvez utiliser un serveur pour mettre à jour et distribuer périodiquement (toutes les quelques minutes ou heures) un APIToken, cette méthode évite d'utiliser directement APISecret pour signer les requêtes de localisation, offrant ainsi une sécurité plus élevée. La méthode de mise à jour de l'APIToken est décrite dans Méthode de création et d'utilisation du Token.

Vous pouvez configurer un minuteur dans le frontend pour mettre à jour le token en fonction de sa durée de validité.

Commencez par créer TokenAccessData en utilisant l'AppID de la bibliothèque de localisation Mega et l'adresse du service de localisation spécifiés dans les paramètres.

Utilisez ensuite le TokenAccessData créé pour construire MegaTrackerConfigs.

Créez ensuite SessionConfigs en utilisant MegaTrackerConfigs et la licenseKey de la configuration.

Enfin, utilisez la méthode createSession(sessionConfigs) du composant EasyARMegaComponent attaché à la scène xr-frame pour créer la session.

Lorsque le Token expire, vous devez appeler updateToken(apiToken) pour le mettre à jour, sinon le service Mega deviendra indisponible et le statut dans les résultats de localisation sera toujours ApiTokenExpired.

const tokenAccess = new mega.TokenAccessData(
    settings.MegaTrackerAppID, // AppID du service de localisation Mega
    settings.MegaTrackerServerAddress, // Adresse du service de localisation Mega
    "your_api_token" // Chaîne APIToken
);
const megaTrackerConfigs: easyar.MegaTrackerConfigs = {
    access: tokenAccess
};
const sessionConfigs: easyar.SessionConfigs = {
    megaTrackerConfigs: megaTrackerConfigs,
    licenseKey: settings.EasyARLicenseKey
};
session = megaComponent.createSession(sessionConfigs);

Cet exemple montre comment utiliser TokenAccessData pour créer MegaTrackerConfigs, puis utiliser ce MegaTrackerConfigs pour créer une session afin d'utiliser l'authentification par APIToken.