Table of Contents

MegaTracker 클라우드 서비스 인증

이 문서는 MegaTracker가 클라우드 서비스를 사용할 때 인증 방식을 지정하는 방법을 설명합니다.

시작하기 전에

API Key 및 API Secret을 사용한 인증

이 방식은 기존의 키 쌍 검증에 적합합니다. MegaTrackerConfigs의 access 객체를 구성하기 위해 APIKeyAccessData를 사용해야 합니다.

const apiKeyAccess = new mega.APIKeyAccessData(
    settings.MegaTrackerAppID, // Mega 위치 서비스 AppID
    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);

이 예시에서는 먼저 구성의 클라우드 위치 라이브러리 appId, 클라우드 서비스 serverAddress, 클라우드 서비스 apiKey 및 apiSecret을 사용하여 APIKeyAccessData를 생성했습니다.

그런 다음 생성된 APIKeyAccessData를 사용해 MegaTrackerConfigs를 생성했습니다. 이는 API Key와 API Secret 인증을 사용함을 나타냅니다.

API Token을 사용한 인증

서버가 APIToken을 정기적으로(몇 분 또는 몇 시간마다) 업데이트하고 발급할 수 있는 경우, 이 방식을 사용하면 위치 요청에 APISecret을 직접 사용하여 서명하는 것을 피할 수 있어 보안성이 더 높습니다. APIToken 업데이트 방법은 토큰 생성 및 사용 방법을 참조하십시오.

토큰의 유효 기간에 따라 프론트엔드에 타이머를 설정하여 업데이트할 수 있습니다.

먼저 설정의 Mega 위치 라이브러리 AppID와 위치 서비스 주소를 사용하여 TokenAccessData를 생성합니다.

그런 다음 생성된 TokenAccessData를 사용해 MegaTrackerConfigs를 생성합니다.

그런 다음 MegaTrackerConfigs와 구성의 licenseKey를 사용하여 SessionConfigs를 생성합니다.

최종적으로 xr-frame 장면에 부착된 EasyARMegaComponent의 createSession(sessionConfigs) 메서드를 사용해 세션을 생성합니다.

토큰이 만료되면 updateToken(apiToken)을 호출하여 업데이트해야 합니다. 그렇지 않으면 Mega 서비스를 사용할 수 없으며, 위치 결과의 상태는 항상 ApiTokenExpired로 유지됩니다.

const tokenAccess = new mega.TokenAccessData(
    settings.MegaTrackerAppID, // Mega 위치 서비스 AppID
    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 인증을 사용하는 방법을 보여줍니다.