Table of Contents

Autenticação do serviço em nuvem MegaTracker

Este artigo descreve como especificar o método de autenticação usado quando o MegaTracker acessa serviços em nuvem.

Antes de começar

Usar autenticação com API Key e API Secret

Esse método é adequado para a autenticação tradicional por par de chaves. Você precisa usar APIKeyAccessData para construir o objeto access em MegaTrackerConfigs.

const apiKeyAccess = new mega.APIKeyAccessData(
    settings.MegaTrackerAppID, // AppID do servico de localizacao Mega
    settings.MegaTrackerServerAddress, // endereco do servico de localizacao Mega
    settings.EasyARAPIKey, // string APIKey
    settings.EasyARAPISecret // string APISecret
);
const megaTrackerConfigs: easyar.MegaTrackerConfigs = {
    access: apiKeyAccess
};
const sessionConfigs: easyar.SessionConfigs = {
    megaTrackerConfigs: megaTrackerConfigs,
    licenseKey: settings.EasyARLicenseKey
};
session = megaComponent.createSession(sessionConfigs);

Neste exemplo, primeiro são usados o appId da biblioteca de mapas de localização em nuvem, o serverAddress do serviço em nuvem, o apiKey do serviço em nuvem e o apiSecret na configuração para criar APIKeyAccessData.

Em seguida, o APIKeyAccessData criado é usado para criar MegaTrackerConfigs. Isso representa o uso da autenticação API Key e API Secret.

Usar autenticação com API Token

Se um servidor puder atualizar e entregar APIToken periodicamente (a cada alguns minutos ou horas), esse método evita usar diretamente APISecret para assinar solicitações de localização e é mais seguro. Para a forma de atualização de APIToken, consulte Criação e uso de Token.

Você pode configurar um temporizador no frontend para atualizar o Token de acordo com seu período de validade.

Primeiro, use o AppID da biblioteca de mapas de localização Mega e o endereço do serviço de localização nas configurações para criar TokenAccessData.

Depois, use o TokenAccessData criado para criar MegaTrackerConfigs.

Depois, use MegaTrackerConfigs e o licenseKey na configuração para criar SessionConfigs.

Por fim, use o método createSession(sessionConfigs) de EasyARMegaComponent montado na cena xr-frame para criar session.

Quando o Token expirar, você deverá chamar updateToken(apiToken) para atualizá-lo. Caso contrário, o serviço Mega ficará indisponível, e o status nos resultados de localização será sempre ApiTokenExpired.

const tokenAccess = new mega.TokenAccessData(
    settings.MegaTrackerAppID, // AppID do servico de localizacao Mega
    settings.MegaTrackerServerAddress, // endereco do servico de localizacao Mega
    "your_api_token" // string APIToken
);
const megaTrackerConfigs: easyar.MegaTrackerConfigs = {
    access: tokenAccess
};
const sessionConfigs: easyar.SessionConfigs = {
    megaTrackerConfigs: megaTrackerConfigs,
    licenseKey: settings.EasyARLicenseKey
};
session = megaComponent.createSession(sessionConfigs);

Este exemplo demonstra como usar TokenAccessData para criar MegaTrackerConfigs e usar este MegaTrackerConfigs para criar session com autenticação APIToken.