animate GO 對接指南¶

animate Games Online 在 Android 環境中支援用於商店發布的認證和付款。

如需在應用程式中對接 animate Games Online，必須先簽訂合約。簽訂合約後，請參考以下指南進行實作。

準備工作¶

1. 核發憑證並確認金鑰值¶

在 animate GO 開發者網站確認 Game ID、Client Secret 和 clientId。

2. 準備 App ID¶

在 App Center > App ID 管理 > [新增 App ID] 中，選擇 OS: Android、Store: animate Games Online，建立 App ID。
App ID 範例: com.[公司名稱].[專案名稱].android.ago

3. 核發安全金鑰¶

為加強服務間認證安全，必須在 Hive Console > App Center > 安全金鑰設定 中核發安全金鑰。

4. 在 hive_config.xml 中設定金鑰¶

Note

animate Games Online 登入僅支援 Android 平台。

如需使用 animate Games Online 登入，必須在 animate Games Online 開發者儀表板中核發所需的金鑰值。

請參考以下範例，在 hive_config.xml 檔案的 providers 標籤中輸入值。

Android

<properties>
    <!-- Omit common Hive SDK settings -->

    <!-- Hive SDK authentication settings: START -->
    <providers>
        <!-- Login with animateGO -->
        <animatego clientId="YOUR_ANIMATEGO_CLIENT_ID"/>
    </providers>
    <!-- Hive SDK authentication settings: END -->
</properties>

clientId (Android)¶

設定在 animate Games Online 開發者儀表板中核發的 animate Games Online 登入用唯一用戶端識別碼(clientId)。

5. 新增 AAR 程式庫¶

在模組層級的 build.gradle 檔案中設定對 libs 資料夾的相依性。

dependencies {
    implementation fileTree(include: ['*.aar'], dir: 'libs')
}

將 SDK 發布版本中包含的外部程式庫 (.aar) 新增到模組層級的 libs 資料夾。支援 animate Games Online IdP 登入和 Billing 時需要以下檔案。

sdk-XXXXXXXXXXXXXXXXXXXXXXX.aar
範例: sdk-bf62685719935e68ec4100c0d51aa469.aar

6. 設定登入¶

在 Hive Console > 認證 > 登入設定中，選擇要顯示 animate GO IdP 的 App ID，然後輸入 Game ID 和 Client Secret 進行登入設定。

實作 animate GO 登入¶

animate Games Online 登入以 OAuth 2.0 Authorization Code + PKCE 方式運作。若要讓登入 callback 正常運作，請在 animate Games Online 開發者儀表板中註冊應用程式的 Redirect URIs。

Redirect URIs 的格式為 <packageName>://store-login-callback。請將 <packageName> 替換為應用程式的套件名稱。

範例: com.com2us.hivesdk.android.ago://store-login-callback

之後請參考登入/登出，以 Android mobile 為基準實作。

實作 animate GO 付款¶

如需接收 animate Games Online 商店的付款結果，請在 animate Games Online 開發者儀表板中註冊 Callback URLs。

在 Callback URLs 項目中註冊以下 4 個 URL。