Table of Contents

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 認証を使用する方法を示します。