Install the Unity SDK

Last updated on July 15, 2026

注釈：本資料はAI技術を用いて翻訳されています。

Overview​

AccelByte Gaming Services (AGS) Game SDK for Unity を使用して、ゲームに AGS の機能を実装しましょう。

GitHub 上の AGS Unity SDK

Prerequisites​

  • Unity バージョン 2020 以降
  • Game Namespace を作成する
  • IAM Client を作成する
  • Client ID を取得する
AGS Public Cloud

AGS Public Cloud は現在、Unity バージョン 2019.2 および 2019.4 以降をサポートしています。

また、BaseUrl には必ず以下の形式を使用してください。使用しない場合、ドメインの不一致により API 呼び出しがエラーを返す可能性があります。

https://<Studio ID>-<Game TitleID>.prod.gamingservices.accelbyte.io
  • 例: https://mystudio-myawesomegame.prod.gamingservices.accelbyte.io

Tutorial​

NOTE

Unity が UPM Package を使用できるようにするには、コンピューターに Git をインストールして設定する必要があります。

インストールと設定​

AGS Game SDK for Unity をダウンロードしてインストールし、AGS の設定ファイルをセットアップする方法を説明します。

AGS Public Cloud

Public Cloud tier では、Unity 用の設定ファイルをダウンロードして保存できます。

設定ファイルは、セットアップ時に Public Cloud tier のダッシュボードからダウンロードできます。その後は、AGS Admin Portal の OAuth Clients ページからもダウンロードできます。

AGS Private Cloud には、まだ設定ファイルのダウンロード機能がありません。

  1. Unity プロジェクトを開きます。

  2. Window > Package Manager > + > Add package from git URL に移動し、ポップアップに https://github.com/AccelByte/accelbyte-unity-sdk.git を貼り付けて、Add をクリックします。

    注記

    必ず最新バージョンをダウンロードしてください。

    プロジェクトで Assembly Definitions を使用している場合は、com.accelbyte.UnitySDK アセンブリを参照として追加する必要があります。

  3. SDK を設定します。

    プロジェクトで SDK を設定する方法は 2 つあります。エディタツールを使用する方法と、設定ファイルを手動で作成・編集する方法です。

    エディタツールを使用して SDK を設定する

    クライアント設定を編集するには、メニューバーの AccelByte > Edit Client Settings に移動します。サーバー設定の場合は Edit Server Settings に移動します。エディタに表示される必須項目を入力し、Save をクリックします。

    Using the editor

    これを実行すると、クライアントエディタが AccelByteSDKConfig.json と AccelByteSDKOAuthConfig.json を生成して自動的に値を入力します。サーバーエディタは AccelByteServerSDKConfig.json と AccelByteServerSDKOAuthConfig.json を生成します。すべての AccelByte SDK 設定ファイルは Assets/Resources フォルダに保存されます。

    設定ファイルを手動で作成する

    Assets/Resources フォルダにこれらのファイルを作成し、適切な形式で値を入力します。「Required」の値は、AGS Admin Portal の設定に基づいて置き換えてください。

    AccelByteSDKConfig.json

    {
        "Default": {
            "BaseUrl": "Required",
            "Namespace": "Required",
            "PublisherNamespace": "Required",
            "RedirectUri": "Required",
            "UsePlayerPrefs": false,
            "EnableDebugLog": true,
            "DebugLogFilter": "Verbose",
            "IamServerUrl": "",
            "PlatformServerUrl": "",
            "BasicServerUrl": "",
            "LobbyServerUrl": "",
            "CloudStorageServerUrl": "",
            "GameProfileServerUrl": "",
            "StatisticServerUrl": "",
            "QosManagerServerUrl": "",
            "AgreementServerUrl": "",
            "LeaderboardServerUrl": "",
            "CloudSaveServerUrl": "",
            "GameTelemetryServerUrl": "",
            "AchievementServerUrl": "",
            "UGCServerUrl": "",
            "ReportingServerUrl": "",
            "SeasonPassServerUrl": "",
            "SessionBrowserServerUrl": "",
            "SessionServerUrl": "",
            "MatchmakingV2ServerUrl": "",
            "UseTurnManager": true,
            "TurnManagerServerUrl": "",
            "TurnServerHost": "",
            "TurnServerPort": "",
            "TurnServerPassword": "",
            "TurnServerSecret": "",
            "TurnServerUsername": "",
            "PeerMonitorIntervalMs": 200,
            "PeerMonitorTimeoutMs": 2000,
            "HostCheckTimeoutInSeconds": 60,
            "GroupServerUrl": "",
            "ChatServerWsUrl": "",
            "ChatServerUrl": "",
            "GdprServerUrl": "",
            "AppId": "",
            "CustomerName": "",
            "EnableAuthHandshake": false,
            "MaximumCacheSize": 100,
            "MaximumCacheLifeTime": 100,
            "EnablePresenceBroadcastEvent": true,
            "PresenceBroadcastEventInterval": 600,
            "PresenceBroadcastEventGameState": 0,
            "PresenceBroadcastEventGameStateDescription": "",
            "EnablePreDefinedEvent": false,
            "EnableClientAnalyticsEvent": false,
            "ClientAnalyticsEventInterval": 10.0,
            "EnableAmsServerQos": false
        }
    }

    AccelByteSDKOAuthConfig.json

    {
        "Default": {
            "ClientId": "Required",
            "ClientSecret": ""
        }
    }
    important
    • ClientID、Secret、Namespace の設定は、AGS Admin Portal で確認できます。
    • AGS Public Cloud の場合は、以下の形式を使用してください。
      • Namespace の場合: <Studio ID>-<Game TitleID>
      • Publisher の場合: <Studio ID>。
    • Game Client が Public Client タイプを使用している場合は、Client Secret を空のままにしてください。
    • API の URL が分からない場合は、サポートまたはアカウントマネージャーにお問い合わせください。AGS Public Cloud を利用している場合、base URL は https://<Studio ID>-<Game TitleID>.prod.gamingservices.accelbyte.io です。
      • 例: https://mystudio-myawesomegame.prod.gamingservices.accelbyte.io
    • AGS Unity SDK のログを設定する場合は、AGS Unity SDK ログ設定ガイド を参照してください。

おめでとうございます。AGS SDK for Unity の設定が完了しました。

に最終更新
On this page