MegaTracker 클라우드 서비스 인증
이 문서는 MegaTracker가 클라우드 서비스를 사용할 때의 인증 방식을 지정하는 방법을 소개합니다.
시작하기 전에
API Key 및 API Secret 인증 사용
이 방식은 전통적인 키 쌍 인증에 적합합니다. APIKeyAccessData를 사용하여 MegaTrackerConfigs의 access 객체를 구성해야 합니다.
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 업데이트 방식은 Token 생성 및 사용 방법을 참조하십시오.
Token의 유효 기간에 따라 프런트엔드에서 타이머를 설정하여 업데이트할 수 있습니다.
먼저 설정의 Mega 로컬라이제이션 맵 라이브러리 AppID와 로컬라이제이션 서비스 주소를 사용하여 TokenAccessData를 생성합니다.
그런 다음 생성된 TokenAccessData를 사용하여 MegaTrackerConfigs를 생성합니다.
그런 다음 MegaTrackerConfigs와 구성의 licenseKey를 사용하여 SessionConfigs를 생성합니다.
마지막으로 xr-frame 장면에 마운트된 EasyARMegaComponent의 createSession(sessionConfigs) 메서드로 session을 생성합니다.
Token이 만료되면 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로 session을 생성하여
APIToken인증을 사용하는 방법을 보여줍니다.