Table of Contents

Autenticazione del servizio cloud MegaTracker

Questo articolo spiega come specificare il metodo di autenticazione quando MegaTracker utilizza servizi cloud.

Prima di iniziare

Utilizzo di API Key e API Secret per l'autenticazione

Questo metodo è adatto per la tradizionale autenticazione a coppia di chiavi. È necessario utilizzare APIKeyAccessData per costruire l'oggetto access in MegaTrackerConfigs.

const apiKeyAccess = new mega.APIKeyAccessData(
    settings.MegaTrackerAppID, // AppID del servizio di localizzazione Mega
    settings.MegaTrackerServerAddress, // Indirizzo del servizio di localizzazione Mega
    settings.EasyARAPIKey, // Stringa APIKey
    settings.EasyARAPISecret // Stringa APISecret
);
const megaTrackerConfigs: easyar.MegaTrackerConfigs = {
    access: apiKeyAccess
};
const sessionConfigs: easyar.SessionConfigs = {
    megaTrackerConfigs: megaTrackerConfigs,
    licenseKey: settings.EasyARLicenseKey
};
session = megaComponent.createSession(sessionConfigs);

In questo esempio, viene prima creato APIKeyAccessData utilizzando appId della libreria di localizzazione cloud, serverAddress del servizio cloud, apiKey e apiSecret dalla configurazione.

Quindi viene creato MegaTrackerConfigs utilizzando APIKeyAccessData creato. Ciò indica che verrà utilizzata l'autenticazione con API Key e API Secret.

Utilizzo di API Token per l'autenticazione

Se è possibile utilizzare un server per aggiornare e distribuire APIToken periodicamente (ogni pochi minuti o ore), questo metodo offre maggiore sicurezza evitando di firmare direttamente le richieste di localizzazione con APISecret. Per il metodo di aggiornamento di APIToken, fare riferimento a Metodo di creazione e utilizzo del token.

È possibile impostare un timer nel frontend per l'aggiornamento in base alla durata di validità del token.

Prima creare TokenAccessData utilizzando l'AppID della libreria di localizzazione Mega e l'indirizzo del servizio di localizzazione dalla configurazione.

Quindi creare MegaTrackerConfigs utilizzando TokenAccessData creato.

Successivamente creare SessionConfigs utilizzando MegaTrackerConfigs e la licenseKey dalla configurazione.

Infine, utilizzare il metodo createSession(sessionConfigs) del componente EasyARMegaComponent montato nella scena xr-frame per creare la sessione.

Quando il token scade, è necessario chiamare updateToken(apiToken) per aggiornarlo, altrimenti il servizio Mega diventa inutilizzabile e lo stato nei risultati di localizzazione sarà sempre ApiTokenExpired.

const tokenAccess = new mega.TokenAccessData(
    settings.MegaTrackerAppID, // AppID del servizio di localizzazione Mega
    settings.MegaTrackerServerAddress, // Indirizzo del servizio di localizzazione Mega
    "your_api_token" // Stringa APIToken
);
const megaTrackerConfigs: easyar.MegaTrackerConfigs = {
    access: tokenAccess
};
const sessionConfigs: easyar.SessionConfigs = {
    megaTrackerConfigs: megaTrackerConfigs,
    licenseKey: settings.EasyARLicenseKey
};
session = megaComponent.createSession(sessionConfigs);

Questo esempio dimostra come creare MegaTrackerConfigs utilizzando TokenAccessData e utilizzare questo MegaTrackerConfigs per creare una sessione per l'autenticazione con APIToken.