資格システム

どのように動作するか

資格システムにより、開発者は1つまたは複数のゲームの所有権を付与できます。

主な特徴：

ユーザーのゲームリストを取得する
所有権を与える

使用に適した方

少なくとも2つのDRMフリーおよび/またはSteamゲームを持っているゲーム開発者。

入手方法

前提条件

パブリッシャーアカウントを作成します。
Game Keysモジュールをセットアップします。セットアップ時に、DRM情報ブロックでDRM-freeおよび/またはSteamオプションを選択します。

統合フロー

手動または自動キーアクティベーションを実装して、ゲームの所有権に関するデータをシステムに送信します。
資格システムを操作するためのAPIメソッドを実装します。

Note:

パブリッシャーアカウントのGame Keysモジュールのセットアップが完了すると、アクティブ化されたキーを持つユーザーが自動的にシステムに追加されます。キーが無効になっている場合、ゲームはユーザーに対して非アクティブとしてマークされます。

手動キーアクティベーション

手動のDRMフリーキーアクティベーションが実装されます：

エクソラランチャー経由
ランディングページの経由：
- エクソラログインを使用する場合はJWT；
- 独自の認証システムを使用する場合はユーザーID。

SteamキーはSteamで有効化されます。システムにゲームアクセス権を追加するためのAPIメソッドを実装します。

自動キーアクティベーション

DRMフリーキー自動的に有効化を設定するには：

購入前にユーザー認証を追加します。購入後、認証されたユーザーのゲームキーがアクティブになります。
パブリッシャーアカウント>ストア>ゲームキーに移動します。
リストから必要なキーパッケージを選択します。
キーと配布ページで、DRMフリーキーの有効化トグルをオンにします。
"is_activation_required":trueパラメーターをトークンまたは購入用のaccess_dataに追加します。統合タイプとパラメーターの詳細な説明を参照してください。

例

{
    "purchase": {
        "pin_codes": {
            "codes": [
                {
                    "digital_content": "test_pack2",
                    "drm": "drmfree",
                    "is_activation_required": true
                }
            ]
        }
    },
    "settings": {
        "project_id": 17558
    },
    "user": {
        "id": {
            "value": "54AC70C177B6583F"
        }
    }
}

ユーザー認証

エクソラログインを使用して、ユーザーの認証、Steamアカウント、ゲーム内アカウント、ソーシャルネットワークアカウントの接続を行うことができます。エクソラログインは、資格システムと自動的に連携します。

独自の統合システムを使用する場合、次のことが必要です：

パブリッシャーアカウントのトークンを介して統合を有効にする。
認証方法を作成します。
必要に応じて、ゲーム内アカウントをSteamアカウントに接続する機能を追加します。
APIメソッドを呼び出すには、決済ステーションアクセストークンを使用します。Steamアカウントと統合するには、トークンとともにSteamID64形式でuser.steam_idパラメーターを渡す必要があることに注意してください。

Steamとの統合

Steamでユーザーのゲームのリストを確認するには、次を実行します：

あなたのappID（ゲーム識別子）とSteam開発者キーをアカウントマネージャーまたは統合マネージャーに送信します。
ゲーム内アカウントをSteamアカウントに接続する機能を実装します。

ゲームのアクセスを付与して、リストを取得するために、APIメソッドを呼び出すとき、エクソラはSteamアクセス権をチェックして、ユーザーがすでに払い戻しを要求した場合を回避します。