メインコンテンツへスキップ
イベント ベースの統計を使用して Partner Center で構成されているタイトルについて、このトピックでは、Partner Center でイベントと統計を構成し、その後、タイトルにイベントを送信して統計を更新するコードを追加する方法を示します。

Partner Center にサインインする

以下の例では、XBOX ゲーム体験を構成するために Partner Center を使用します。 会社が XBOX 向けの製品を作成する契約を締結した後、Partner Center でコンテンツを構成します。会社が Partner Center アクセスの設定をまだ完了しておらず、ゲームを開発している場合は、Microsoft のアカウント マネージャーに連絡してください。アプリを開発している場合は、XBOX App Partner Requests (xboxapps@microsoft.com) に連絡してください。ID@XBOX プログラムで作業している場合は、ID Setup (idsetup@microsoft.com) に連絡してください。 ID@XBOX プログラムでは、あらゆる規模の適格なゲーム開発者が、XBOX One (以降) でデジタル ゲームをセルフパブリッシュすることで創造性を発揮できるようにします。これにより、スタジオは成功を最大化するために必要なツールとサポートを得られます。詳細については、https://www.xbox.com/Developers を参照してください。 Partner Center にアクセスできるようになったら、Microsoft にゲームの製品グループを作成してもらう必要があります。Microsoft のアカウント マネージャーがこのプロセスを支援できます。 Microsoft がゲームの製品グループを作成した後、Partner Center を使用してゲームの XBOX services を構成します。ゲームの XBOX services 構成は、その サービス構成 とも呼ばれます。 次の手順に従って、ゲームのイベント、統計、実績、およびリーダーボードを追加できる Partner Center の場所に移動します。
  1. Partner Center にアカウントでサインインします。
  2. ゲームを含む、または含む予定の製品グループを選択します。
  3. Product Group ページで、ゲームを選択するか、Add New Product を選択して新しいエントリを作成します。
  4. 新しい製品を作成する場合、製品の名前を入力します。
  5. リソース アクセスには、Exclusive Resource Access (ERA) を選択します。
  6. ゲームの物理メディアを製造する必要があるか、それともデジタル ダウンロードのみになるかを選択します。
  7. Create Product を選択します。
  8. 左側のペインの下部で、製品が作成されたサンドボックスを展開します。 サービス構成はサンドボックス レベルで定義されます。製品を別のサンドボックスにエクスポートする場合、サービス構成もエクスポートする必要があります。
  9. サンドボックスのサブメニューで Service Configuration を選択します。このページを使用して、現在のサンドボックスでタイトルの XBOX services を構成します。

シナリオのイベントを特定して定義する

Partner Center では、実現したいプレイヤー体験を実装するルールを定義する前に、それらの体験を駆動するイベントを特定して定義する必要があります。 イベント ベースのモデルでは、実績とリーダーボードはプレイヤー統計に基づいています。したがって、定義する統計を見て、タイトルが送信する必要があるイベントを判断できます。 この例で定義する体験を駆動するために、レースの各ラップの終わりに送信するイベントを使用します。 このイベントを LapCompleted と呼びましょう。このイベントを使用して、カスタマイズされた体験を駆動します。これらの体験を駆動するために、LapCompleted イベントの一部として次のフィールドも定義します。
  • LapTime: ラップの完走に要した時間 (分) を示すフィールド。
  • CarModel: ラップの完走に使用された車のモデルを示す文字列フィールド。
  • WeatherCondition: ラップが完走されたときのトラックの天候条件を識別する文字列フィールド。
  • TrackId: ラップが完走されたトラックの ID。
このイベントを Partner Center で定義します。
  1. Partner Center で、左側のペインで Test Sandbox > Service Configuration > Events & Stat Rules を選択します。
  2. New を選択して新しいイベントを作成します。Add New Event ダイアログが次のように表示されます。 Partner Center の Add New Event ダイアログのスクリーンショット。
  3. Base Event で Base を選択します。
  4. Event Name に LapCompleted を入力します。
  5. オプションで、Description にイベントの説明を入力します。
  6. Add Event Field を選択します。
  7. Field Name に LapTime を入力し、Type を Double に指定します (次のとおり)。 Partner Center の Add New Event Field ダイアログのスクリーンショット。
  8. Add Event Field を選択します。
  9. プロセスを繰り返して、次のイベント フィールドを追加します。
    • CarModel: UnicodeString
    • WeatherCondition: UnicodeString
    • TrackId: Int32
    イベントは次のスクリーンショットのようになります。 Partner Center で新しく定義された LapCompleted イベントのスクリーンショット。
  10. Save Event を選択して、サンドボックスにイベントを保存します。

統計ルールの設計

プレイヤー体験を定義したので、それらの体験を実装する統計ルールの作成を開始できます。3 つのシナリオ (注目統計、実績、リーダーボード) すべてで LapTime を使用しているため、まずそれを構成します。 この統計は、注目統計 (hero stats とも呼ばれる) として表示され、追加のメタデータを持つグローバル リーダーボードにも使用されます。 ゲームは、ゲーム内で特定のアクションが発生したときにゲーム内イベントを発火し、統計を作成するための生データと見なされます。すべてのイベントによって少なくとも 1 つの統計が作成または更新される必要があります。 (1 つのイベントで複数の統計を生成する方法の詳細は、イベント ベースの統計の概要 を参照してください。)
  1. Events & Stat Rules ページで、イベントのリストから LapCompleted イベントを選択します。
  2. Stat Rules の右にある New を選択して新しい統計ルールを作成します。選択したイベントに基づきます。Add Stat Rule ダイアログが次のように表示されます。 Partner Center の Add Stat Rule ダイアログのスクリーンショット。
  3. Stat Rule Name に FastestLap を入力します。
  4. このルールによって作成される統計に他のアプリやタイトルがアクセスできるようにしたいので、Open read access to any title チェックボックスをオンにします。 統計ルールには、イベントが統計を作成または更新する方法を定義するロジックがあります。最速ラップを追跡したいため、新しいラップ タイムが既存の最速ラップ タイムよりも小さい場合にのみ統計値を更新したいと考えます。
  5. これを行うには、Operator で Min を、Parameter で LapTime を選択します (次のとおり)。 Partner Center の統計ルールの Operator と Parameter の選択のスクリーンショット。
最後に、この特定の統計に必要な追加データ (統計 コンテキスト または メタデータ と呼ばれる) がイベントに含まれるようにする必要があります。プレイヤーの車、トラック、および天候条件です。
  1. メタデータにフィールドを追加するには、CarModel を選択し、Add Event Field を選択します。
  2. WeatherCondition および TrackId フィールドについてもこれを繰り返します (次のとおり)。 Partner Center のメタデータ付き FastestLap 統計ルールのスクリーンショット。
  3. Add Stat Rule を選択して統計ルールを作成します。

注目統計、リーダーボード、および実績の構成

注目統計

統計ルールが完成したので、GameHub の GameHub Achievement タブに統計を表示したいと考えます。したがって、注目統計 (Partner Center では hero stat と呼ばれる) を構成する必要があります。
  1. Partner Center で、左側のペインで Test Sandbox > Service Configuration > Hero Stats を選択します。
  2. New を選択して新しい注目/hero stat を追加します。
  3. Hero Stat Display Name に Fastest Lap を入力します。
  4. Display Format で ShortTimespan を選択します。Display Units で Seconds を選択します。
  5. Display Semantic で Best を選択します。これは、値が統計の最高スコアを表すことをコンパニオン アプリに示します。
  6. Select an Instance を選択し、Stat Instance で FastestLap を選択します。これは、注目統計が FastestLap の統計値に基づくことを示します。
  7. Ordinal に 1 を入力します。これは、注目統計をリスト表示する際に、この注目統計を最初に表示することを示します。
  8. Sort Order で Ascending を選択します。これは、次のように、値が低い方が値が高いよりも優れていることを示します。 Partner Center の Fastest Lap hero stat のスクリーンショット。
  9. Add New Hero Stat を選択して、注目/hero stat を作成します。

グローバル リーダーボード

同じラップ タイム 統計を使用して、リーダーボードを構成し、各プレイヤーが自分のラップ タイムが世界中の他のすべてのプレイヤーに対してどのようにランク付けされているかを確認できるようにします。
  1. Partner Center で、左側のペインで Test Sandbox > Service Configuration > Leaderboards を選択します。
  2. New を選択して新しいグローバル リーダーボードを作成します。
  3. Leaderboard ID に FastestLap を入力します。
  4. Select an Instance を選択し、先ほど作成した FastestLap 統計ルールを選択し、Add Stat Instance を選択します。
  5. Sort で Ascending を選択します (次のとおり)。この選択は、タイムが低い方が優れていることを示します。 Partner Center の Fastest Lap リーダーボードのスクリーンショット。
  6. Add New Leaderboard を選択して新しいグローバル リーダーボードを作成します。
プレイヤー統計が更新されると、リーダーボードもランキングの変更を反映するように更新されます。 リーダーボードを作成する際に既存のプレイヤー統計がある場合、新しいリーダーボードをそれらの統計で更新するには数時間かかることがあります。

イベント ベースの実績

タイトル管理の実績の使用を推奨します。ただし、まだイベント ベースの実績を使用しているタイトルについては、次のようにイベントを使用してサービス上での実績の解除を駆動できます。 イベントを使用してイベント ベースの実績を解除するには
  1. Partner Center で、左側のペインで Test Sandbox > Service Configuration > Achievements & Challenges を選択します。
  2. New を選択して新しい実績を追加します。
  3. Achievement Name に Under 60 seconds を入力します。
  4. Description に Completed a lap in under 60 seconds を入力します。この説明は、実績が解除されたときにプレイヤーに表示されます。
  5. Not Achieved Description に Complete a lap in under 60 seconds を入力します。この説明は、実績がまだロックされているときにプレイヤーに表示されます。
  6. Achievement Icon として使用する 1920 × 1080 ピクセルの .png ファイルを次のようにアップロードします。 Partner Center の Add New Achievement ダイアログのスクリーンショット。
  7. Add Achievement を選択して実績を作成します。
  8. 実績のリストで Under 60 seconds の実績が選択されていることを確認します。Rewards の右にある New を選択して、実績を解除したプレイヤーに報酬を与えます。
  9. この実績の解除に対して 20 gamerscore ポイントをプレイヤーに与えます。Reward Type で Gamerscore を選択します。
  10. Value に 20 を入力します (次のとおり)。 Partner Center の Add New Award ダイアログのスクリーンショット。
  11. Add Reward を選択します。
  12. 実績のリストで Under 60 seconds の実績がまだ選択されていることを確認します。Rules の右にある New を選択して、実績を解除する条件を定義します。
  13. Rule Name に Under 60 seconds rule を入力します。この値はプレイヤーには表示されないため、任意の名前を付けることができます。
  14. Action で Min を選択します。これは、選択した統計 インスタンスが閾値以下のときに実績が解除されることを示します。
  15. Threshold に 60 を入力します。
  16. Select an Instance を選択し、FastestLap 統計ルールを選択し、Add Stat Instance を選択します。
  17. Add Rule を選択して、次のように実績のルールを作成します。 Partner Center の実績の Add New Rule ダイアログのスクリーンショット。

ゲームからイベントを送信するコードを追加する

XBOX services がプレイヤー シナリオを更新するために使用する LapCompleted イベントを定義したので、プレイヤーがゲームでレース ラップを完走したときにイベントを送信するコードをゲームに追加する必要があります。 イベントを書き込むには、イベント名 LapCompleted で XblEventsWriteInGameEvent 関数を呼び出します。 Flat C API

関連項目

イベントの概要
最終更新日 2026年10月20日