Extend SDKを使い始める

Last updated on July 14, 2026

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

Overview​

この記事では、サポートされている複数のプログラミング言語で Extend SDK を使用してプロジェクトを作成する基本について説明します。

Goals​

このガイドでは、以下のことを行います。

  • アプリケーションプロジェクトを作成する。
  • Extend SDK をプロジェクトの依存関係として追加する。
  • Extend SDK を使用して AGS エンドポイントを呼び出す。
  • アプリケーションを実行する。

Prerequisites​

このガイドを始めるには、以下が必要です。

  • AccelByte Gaming Services (AGS)(デモ環境)へのアクセス:
    • AB_BASE_URL 環境変数には <自分の環境のドメイン URL> を使用します。
      • AGS Public Cloud カスタマーの例: https://spaceshooter.prod.gamingservices.accelbyte.io
      • AGS Private Cloud カスタマーの例: https://dev.customer.accelbyte.io
    • クライアントタイプ Confidential で OAuth クライアントを作成します。
      • AB_CLIENT_ID 環境変数には Client ID の値を使用します。
      • AB_CLIENT_SECRET 環境変数には Client Secret の値を使用します。
  • AccelByte Python Extend SDK
  • 以下のツールへのアクセス:
    • Git
    • Python 3.10
    • Python IDE

プロジェクトを作成する​

dotnet CLI を使用して、新しいソリューションと、そのソリューション内に新しいコンソールプロジェクトを作成します。

$ mkdir -p /path/to/mysolution
$ cd /path/to/mysolution
$ dotnet new sln --name mysolution      # Create a new solution: mysolution
$ dotnet new console -o myproject       # Create a new console project myproject
$ dotnet sln add myproject/myproject.csproj     # Add myproject to mysolution

プロジェクトの依存関係に追加する​

  1. SDK の依存関係をインストールします。

    $ pip install requests httpx websockets pyyaml

  2. SDK をインストールします。{VERSION} を特定のリリースバージョンタグ(例: v0.74.0)に置き換えます。

     $ pip install git+https://github.com/AccelByte/accelbyte-python-sdk.git@{VERSION}#egg=accelbyte_py_sdk
ヒント

AGS のバージョンに一致する Python Extend SDK のバージョンを使用することを推奨します。

コードで使用する​

  1. program.cs で SDK インスタンスを作成し、ユーザー資格情報を使用してログインし、AccelByte Basic API を呼び出します。
  2. DefaultConfigRepository は、AB_BASE_URL、AB_CLIENT_ID、AB_CLIENT_SECRET 環境変数から値を取得します。
using System;
using System.Collections.Generic;

using AccelByte.Sdk.Core;
using AccelByte.Sdk.Api;
using AccelByte.Sdk.Api.Legal.Model;

namespace AccelByteExample
{
    internal class Program
    {
        static int Main(string[] args)
        {
            AccelByteSDK sdk = AccelByteSDK.Builder
                .UseDefaultHttpClient()
                .UseDefaultConfigRepository()
                .UseDefaultTokenRepository()
                .Build();

            bool login = sdk.LoginUser("myUsername", "myPassword");
            if (!login)
            {
                Console.WriteLine("Login failed");
                return 1;
            }

            try
            {
                List<RetrieveAcceptedAgreementResponse>? response = sdk.Legal.Agreement.RetrieveAgreementsPublicOp.Execute();
                if (response == null)
                    throw new Exception("Response is null");

                foreach (var agreement in response)
                    Console.WriteLine(agreement.PolicyName);
            }
            catch (HttpResponseException e)
            {
                Console.WriteLine(e.Message);
                return 2;
            }

            bool logout = sdk.Logout();
            if (!logout)
            {
                Console.WriteLine("Logout failed");
                return 1;
            }

            return 0;
        }
    }
}

コードを実行する​

必要な環境変数を設定し、Python インタープリタを使用してコードを実行します。

$ export AB_BASE_URL="<your environment's domain URL>"          # AccelByte Cloud Base URL e.g. demo environment
$ export AB_CLIENT_ID="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"        # AccelByte Cloud OAuth Client ID
$ export AB_CLIENT_SECRET="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"    # AccelByte Cloud OAuth Client Secret
$ python app.py

追加リソース​

  • Extend SDK のセットアップと使用方法については、C# Extend SDK README を参照してください。
  • ゲームをカスタマイズするための Extend SDK の一般的な使用例については、C# Extend SDK common use cases を参照してください。
  • Extend SDK を使用したサンプルプロジェクトについては、C# Extend SDK sample projects を参照してください。
  • Extend SDK がサポートするすべての操作のコード例については、C# Extend SDK reference を参照してください。
に最終更新
On this page