Table of Contents

Authentification du service cloud MegaTracker

Cet article décrit comment spécifier la méthode d'authentification utilisée lorsque MegaTracker accède aux services cloud.

Avant de commencer

Utiliser l'authentification API Key et API Secret

Cette méthode convient à l'authentification 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, // chaine APIKey
    settings.EasyARAPISecret // chaine APISecret
);
const megaTrackerConfigs: easyar.MegaTrackerConfigs = {
    access: apiKeyAccess
};
const sessionConfigs: easyar.SessionConfigs = {
    megaTrackerConfigs: megaTrackerConfigs,
    licenseKey: settings.EasyARLicenseKey
};
session = megaComponent.createSession(sessionConfigs);

Dans cet exemple, le appId de la bibliothèque de cartes de localisation cloud, le serverAddress du service cloud, le apiKey du service cloud et apiSecret dans la configuration sont d'abord utilisés pour créer APIKeyAccessData.

Ensuite, le APIKeyAccessData créé est utilisé pour créer MegaTrackerConfigs. Cela signifie que l'authentification API Key et API Secret sera utilisée.

Utiliser l'authentification API Token

Si un serveur peut mettre à jour et distribuer périodiquement APIToken (toutes les quelques minutes ou heures), cette méthode évite d'utiliser directement APISecret pour signer les requêtes de localisation et est plus sûre. Pour la méthode de mise à jour de APIToken, consultez Création et utilisation de Token.

Vous pouvez définir un minuteur côté frontend pour mettre à jour le Token selon sa période de validité.

Utilisez d'abord l'AppID de la bibliothèque de cartes de localisation Mega et l'adresse du service de localisation dans les paramètres pour créer TokenAccessData.

Utilisez ensuite le TokenAccessData créé pour créer MegaTrackerConfigs.

Utilisez ensuite MegaTrackerConfigs et le licenseKey dans la configuration pour créer SessionConfigs.

Enfin, utilisez la méthode createSession(sessionConfigs) de EasyARMegaComponent montée dans la scène xr-frame pour créer session.

Lorsque le Token expire, vous devez appeler updateToken(apiToken) pour le mettre à jour. Sinon, le service Mega sera indisponible et l'état 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" // chaine 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 session avec l'authentification APIToken.