エクソラサーバーの統合

このタイプの統合では、エクソラ側で以下の作業を行います：

• カタログの保存と管理
• 価格管理
• 地域価格のデータの保存
• 地域制限管理
• インベントリ管理
• プロモーションキャンペーン管理
• ユーザー認証
• ユーザーアクセス管理
• 取引処理

これらの作業のために、自分でサーバー側を設定する必要はありません。

統合フロー

Game Commerceアセットを使用してエクソラサーバーと統合するには：

1. アセットをインストールします。
2. あなたのパブリッシャーアカウントでプロジェクトを設定します。
3. 決済ステーションアクセストークンを使用して、ログインまたは独自の認証システムを実装します。
4. 仮想通貨モジュールを設定します（任意）。
5. 仮想アイテムモジュールを設定します。
6. Unityプロジェクトを設定します。

統合が完了したら、決済プロセスをテストできます。

統合チームにお問い合わせください

右下のチャットアイコンをクリックし、メッセンジャーで統合チームまでお問い合わせください。私たちはリアルタイムで回答し、問題解決をお手伝いします。

アセットをインストールする

1. Unityのダウンロード。
2. あなたの好みに合わせて、個人用またはプロフェッショナル用のUnityライセンスをお選びください。
3. Unityのプロジェクトを新規に作成します。
4. アセットのダウンロード。
5. パッケージを解凍してください。
6. UnityのエディタでAssets > Import Package > Custom Packageクリックし、アセットを選択します。
7. ゲームビルドの作成にMonoコンパイラーが使用されていることを確認してください（スタンドアロンビルドの場合のみ）。これを行うには:

1. 1. クリックEdit > Project Settingsメインメニューに表示します。
   2. そこに行ってみてOther Settings > Configurationセクションをご覧ください。
   3. 確認することはMono選択Scripting Backendフィールド。

アセットをインストールした後、Assets > Xsolla > DemoCommon > SceneディレクトリからXsollusデモシーンを起動します。デモシーンは、アセットの機能を表示し、アプリケーションロジックの可能な実装を表します。

デモシーンでは、パブリッシャーアカウントのプロジェクトがプリセットされ、ゲーム内ストアが完全に設定されています。

Xsollusデモシーンのデフォルト値：

デモシーンは2つの方法で使用することができます：

• 例えば
• ログインシステム、インベントリ、ゲーム内ストアの初期バージョンとして、迅速な結果を得て、必要に応じて機能を拡張することができます

デモシーンやそのパーツをアプリケーションで使用するには、ビルド設定で追加します：

1. Assets > Xsolla > DemoCommon > Sceneに移動して、Xsollusシーンを起動します。
2. File > Build settingsを開き、Add Open Scenesをクリックします。

アドミンページでプロジェクトを作成する

1. パブリッシャーアカウントにサインアップします。
2. プロジェクトを構成します：
   1. ゲームデータを自動的に入力するには、任意のプラットフォームでゲームへのリンクを入力します。その結果、ゲームの画像、名前、説明がプロジェクト設定に追加されます。
   2. ゲームデータを手動で入力するには、リンクがありませんで、手動でセットアップしますをクリックし、以下のことを指定してください：
      • プロジェクト言語（既定では英語が設定されています）
      • 指定されたすべての言語のプロジェクト名
      • ゲームウェブサイト（任意）
   3. プロジェクトを作成するをクリックします。

統合プロセスで、プロジェクトIDが必要になります。プロジェクトIDは、パブリッシャーアカウントのプロジェクト名の横にあります。

基本的なログインプロジェクトのセットアップ

1. パブリッシャーアカウントでのプロジェクトを開きます。
2. ログインペインで接続するをクリックするか、サイドメニューでログインを選択します。
3. ログインプロジェクトを作成するをクリックします。

4. 標準ログインプロジェクトを選択して作成とセットアップを選択します。新しいログインプロジェクトが作成されるまでお待ちください。すると、プロジェクト設定のナビゲーションページが表示されます。
5. ナビゲーションページでのログイン方法ブロックで、ゲームに最適な方法を選択し、構成するをクリックします。

1. ログイン製品では、ゲーム用に3つのオプションが用意されています：
   • クラシックログイン
     ユーザーは、ユーザー名とパスワードを入力することでゲームにログインします。さらに、ユーザーは自分のソーシャルネットワークの1つを使用してログインすることができます。
   • パスワードレスログイン
     ユーザーは、メールアドレスや電話番号に送られるワンタイムコードやリンクを使ってゲームにログインする。また、ソーシャルネットワークを利用したログインにも対応しています。
   • ソーシャルログイン
     ユーザーは、ソーシャルネットワークを通じてのみゲームに参加することができます。

6. ナビゲーションページの上部の設定ブロックで、コールバックURLをクリックして以下のパラメータを設定します：
   • コールバックURL — ユーザーが認証、電子メールの確認、パスワードのリセットに成功した後にリダイレクトされる、アプリケーション内のURLまたはパスです。有効なURLは複数指定可能です。
   • エラーコールバックURL — 認証エラーの際にユーザーがリダイレクトされるアプリケーション内のURLまたはパス。値が指定されない場合、コールバックURLの値が使用されます。

7. 変更内容を保存するをクリックします。

8. ソーシャルログインを設定するには（任意）：
   1. パンくずナビでログインプロジェクトの名前をクリックすると、ナビゲーションページに戻ることができます。
   2. 認証ブロックに移動してソーシャルログインセクションを選択します。
   3. ユーザーがアプリケーションにサインアップしたりログインしたりする際に利用するソーシャルネットワークを接続します：

1. 1. • 目的のソーシャルネットワークに接続するには、⚙ アイコンをクリックし、接続するを選択します。

1. 1. • 複数のソーシャルネットワークを一度に接続するには、必要なペインを選択します（枠線が緑色になる）。それで、管理ドロップダウンメニューから、接続するを選択します。

1. 1. • 利用可能なすべてのソーシャルネットワークを一度に接続するには、すべて選択をクリックします。それで、管理ドロップダウンメニューから、接続するを選択します。

9. OAuth 2.0認証を設定するには：
   1. パンくずナビでログインプロジェクトの名前をクリックすると、ナビゲーションページに戻ることができます。
   2. セキュリティ ブロックに移動してOAuth 2.0セクションを選択します。
   3. OAuth 2.0を追加するをクリックします。
   4. OAuth 2.0リダイレクトURIを指定して接続するをクリックします。
   5. クライアントIDをコピーして保存します。

10. ユーザーデータストレージを変更します（任意）。デフォルトでは、ユーザーデータはエクソラ側で保存または処理されます。PlayFab、Firebase、または独自のカスタムストレージを接続する場合は、以下の手順に従ってください。ユーザーデータストレージを接続する。

統合のプロセスで、以下のパラメータが必要になります：

• ログインID。これを取得するには、パブリッシャーアカウントを開き、ログイン > ダッシュボードセクションに移動して、ログインプロジェクト名の横にあるIDをコピーするをクリックします。

• クライアントID。これは、パブリッシャーアカウントでのログイン > ログインプロジェクト > セキュリティ > OAuth 2.0セクションにあります。

仮想通貨モジュールをセットアップする

1. パブリッシャーアカウントであなたのプロジェクトを開きます。
2. ストアペインで接続をクリックします。サイドメニューのストアをクリックすると、パブリッシャーアカウントの任意のセクションからでもゲーム内ストア設定を行うことができます。

3. 仮想通貨ペインの接続>をクリックします。

4. 仮想通貨を作成する：
   1. 仮想通貨を作成するをクリックします。

1. 2. 以下の情報を指定します：
      • SKU
      • 通貨名
      • 仮想通貨の一単位の価格
      • デフォルトの通貨
      • ハード仮想通貨の機能（任意）
      • イメージ（任意）
   3. 通貨を作成するをクリックします。

5. 仮想通貨のパッケージを作成します：
   1. パッケージに移動します。
   2. パッケージを作成するをクリックします。

1. 3. 以下の情報を指定します：
      • SKU
      • パッケージ名
      • 短い説明
      • 仮想通貨
      • パッケージ内の通貨単位の数量
      • 価格
      • デフォルトの通貨
      • イメージ（任意）

1. 4. ストアに表示するトリガーをオンにします。
   5. パッケージを作成するをクリックします。

仮想アイテムモジュールを設定する

1. パブリッシャーアカウントであなたのプロジェクトを開きます。
2. ストアペインで接続をクリックします。サイドメニューのストアをクリックすると、パブリッシャーアカウントの任意のセクションからでもゲーム内ストア設定を行うことができます。

3. 仮想アイテムペインの接続>をクリックします。

4. グループを作成するをクリックします。

5. グループコードとグループ名を指定します。
6. ストアでグループを表示するトグルをオンに設定します。
7. グループを作成するをクリックします。

8. アイテムを作成します：
   1. それぞれに次の情報を指定します：
      • そのアイテムが所属する1つまたはそれ以上のグループ
      • SKU
      • 名称と短い説明
      • 実際の通貨と仮想通貨の価格
      • 画像（任意）

2. 環境設定セクションの項目プロパティフィールドで、アイテムのタイプに応じて、次のプロパティのいずれかを選択します：
   • 消耗品
   • 非消耗品
   • 非更新サブスクリプション
3. アイテムを作成するをクリックします。

9. グループのステータスが有効であることを確認します。

Unityプロジェクトをセットアップする

1. あなたのUnityプロジェクトを開きます。
2. メインメニューでWindow > Xsolla > Edit Settingsをクリックします。
3. Inspectorパネルでプロジェクトパラメータを指定します：
   1. Login IDフィルドで、パブリッシャーアカウントからログインIDを指定します。

1. 2. Project IDフィルドで、パブリッシャーアカウントからプロジェクトIDを指定します。
   3. サンドボックスモードを有効にするには、Enable sandbox?ボックスにチェックを入れます。
   4. Authorization methodフィルドで、OAuth2.0を選択します。
   5. OAuth2.0 client IDフィルドで、パブリッシャーアカウントでOAuth 2.0を設定する際に受け取ったクライアントIDを指定します。

その結果、パブリッシャーアカウントのプロジェクトがデモシーンに接続されます。

4. デモシーンAssets > Xsolla > DemoCommon > Scene > Xsollusを起動して認証およびその他の機能が正しく動作していることを確認してください。
5. アプリケーションのログインシステムやゲーム内ストアなどのページのインターフェースを設計します。

6. SDKメソッドを使って、アプリケーションロジックに応じたイベント処理を設定します。段階的なチュートリアルに従って、SDKの基本的な機能を使い始めることができます。

支払処理をテストする

アセットの設定が完了した後、決済プロセスをテストします。デフォルトでは、どのユーザーに対しても、すべてのはサンドボックスモードで行われます。テスト用の銀行カードを使って、決済の成功をシミュレーションします。

実際の決済を行って支払処理をテストするには：

1. エクソラと契約を結んでいることを確認してください。
2. Unityプロジェクトで、InspectorパネルのEnable sandbox?チェックボックスからチェックを外します。

続きを読む