Skip to main content
このガイドでは、PlayFab 統合 SDK を Windows プロジェクトに統合し、SDK を初期化して、プレイヤーを認証する方法を説明します。これは PlayFab API 呼び出しの基盤となります。

前提条件

開始する前に、クイックスタート セットアップ のセットアップ手順を完了して、開発環境とプロジェクトを構成してください。

達成できること

このクイックスタートの終わりまでに、次のことを完了できます:
  • Windows プロジェクトでの PlayFab 統合 SDK のセットアップ
  • タイトル ID を使用した SDK の初期化
  • XBOX または Steam を使用したプレイヤーの認証
  • API 呼び出しを行うためのエンティティ ハンドルの取得
  • リソースの適切なクリーンアップ

このクイックスタートで扱う内容

  1. SDK を初期化する
  2. プレイヤーを認証する
  3. リソースをクリーンアップする

ステップ 1: SDK を初期化する

必要なヘッダーをインクルードする

まず、プロジェクトに必要な PlayFab および XBOX Game Runtime ヘッダーをインクルードします。

XBOX Gaming Runtime Services を初期化する

PlayFab 統合 SDK には XBOX Game Runtime が必要です。最初にこれを初期化します。

PlayFab Core を初期化する

PlayFab SDK を初期化し、サービス構成ハンドルを作成します。ABCDEF を実際の PlayFab タイトル ID に置き換えてください。
タイトル ID は、ゲームの設定の下の Game Manager ダッシュボード で確認できます。

ステップ 2: プレイヤーを認証する

PlayFab では API 呼び出しを行う前にプレイヤーの認証が必要です。SDK は、プラットフォームと要件に応じたいくつかの認証方法を提供します。

認証方法を選択する

オプション A: XBOX でログイン (Windows/XBOX に推奨)

PFAuthenticationLoginWithXUserAsync を使用して XBOX ユーザー アカウントでログインします。これは Windows および XBOX アプリケーションに推奨される方法です。

オプション B: Steam でログイン

Steam 統合ゲームの場合、Steam 認証チケットを使用して PFAuthenticationLoginWithSteamAsync を使用します。
ログインから返される PFEntityHandle は、以降のすべての PlayFab API 呼び出しに必要です。このハンドルはアプリケーションの存続期間中利用可能に保ってください。

ステップ 3: リソースをクリーンアップする

アプリケーションのシャットダウン時には、メモリ リークを防ぎ、正常な終了を保証するために、すべてのリソースを適切にクリーンアップしてください。
適切なシャットダウンを保証するため、常に初期化とは逆の順序でリソースをクリーンアップしてください。

次のステップ

SDK を初期化してプレイヤーを認証したので、PlayFab サービスの呼び出しを開始する準備が整いました。

最初の API 呼び出しを行う

  • PlayFab サービスの呼び出し - プレイヤー データを管理し、ゲーム サービスを使用するために PlayFab API を呼び出す方法を学習します

コア概念

高度な認証

  • マルチプラットフォーム認証 - 複数の認証プロバイダーをサポート
  • カスタム ID 認証 - 独自の認証システムを使用
  • アカウント リンク - 複数の認証方法を 1 つのアカウントにリンク

トラブルシューティング

一般的な問題と解決策:

リファレンス ドキュメント

最終更新日 2026年8月25日