Table of Contents

Autentikasi layanan cloud MegaTracker

Artikel ini menjelaskan cara menentukan metode autentikasi yang digunakan saat MegaTracker mengakses layanan cloud.

Sebelum memulai

Menggunakan autentikasi API Key dan API Secret

Metode ini cocok untuk autentikasi pasangan kunci tradisional. Anda perlu menggunakan APIKeyAccessData untuk membangun objek access dalam MegaTrackerConfigs.

const apiKeyAccess = new mega.APIKeyAccessData(
    settings.MegaTrackerAppID, // AppID layanan lokalisasi Mega
    settings.MegaTrackerServerAddress, // alamat layanan lokalisasi 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);

Dalam contoh ini, library peta lokalisasi cloud appId, layanan cloud serverAddress, layanan cloud apiKey, dan apiSecret dalam konfigurasi digunakan terlebih dahulu untuk membuat APIKeyAccessData.

Kemudian APIKeyAccessData yang dibuat digunakan untuk membuat MegaTrackerConfigs. Ini berarti autentikasi API Key dan API Secret akan digunakan.

Menggunakan autentikasi API Token

Jika server dapat memperbarui dan mengirimkan APIToken secara berkala (setiap beberapa menit atau beberapa jam), metode ini menghindari penggunaan langsung APISecret untuk menandatangani permintaan lokalisasi dan lebih aman. Cara memperbarui APIToken dapat merujuk ke Pembuatan dan penggunaan Token.

Anda dapat mengatur timer di frontend untuk memperbarui Token sesuai masa berlakunya.

Pertama, gunakan AppID library peta lokalisasi Mega dan alamat layanan lokalisasi dalam pengaturan untuk membuat TokenAccessData.

Kemudian gunakan TokenAccessData yang dibuat untuk membuat MegaTrackerConfigs.

Kemudian gunakan MegaTrackerConfigs dan licenseKey dalam konfigurasi untuk membuat SessionConfigs.

Terakhir, gunakan metode createSession(sessionConfigs) dari EasyARMegaComponent yang dipasang di scene xr-frame untuk membuat session.

Saat Token kedaluwarsa, Anda harus memanggil updateToken(apiToken) untuk memperbaruinya. Jika tidak, layanan Mega tidak akan tersedia, dan status pada hasil lokalisasi akan selalu ApiTokenExpired.

const tokenAccess = new mega.TokenAccessData(
    settings.MegaTrackerAppID, // AppID layanan lokalisasi Mega
    settings.MegaTrackerServerAddress, // alamat layanan lokalisasi 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);

Contoh ini menunjukkan cara menggunakan TokenAccessData untuk membuat MegaTrackerConfigs, lalu menggunakan MegaTrackerConfigs ini untuk membuat session agar menggunakan autentikasi APIToken.