Skip to main content

クイックスタート: Win32

Win32 用の PlayFab Services SDK を使い始めましょう。以下の手順に従って、プロジェクトにライブラリを組み込み、PlayFab の基本機能のサンプルコードを試してください。 このクイックスタートでは、Win32 SDK を使用して最初の PlayFab API 呼び出しを行います。続行する前に、クイックスタート: Game Manager の手順を完了し、PlayFab アカウントを所有し、PlayFab Game Manager に慣れていることを確認してください。

要件

プロジェクトのセットアップ

PlayFab SDK リリースページ から PlayFab SDK をプロジェクトにダウンロードします。 PlayFabServicesSDK.Win32.props をプロジェクトにインポートします。プロジェクトファイルで手動で行うか、Visual Studio でプロパティマネージャーウィンドウを開き、プロジェクトを右クリックして 既存のプロパティ シートの追加 を選択することで行えます。

トラブルシューティング

プロジェクトで SDK のリンクに問題がある場合、Visual Studio インストーラーを介して 17.5 ビルドツールとライブラリのインストールが必要になる場合があります。VS2022 の 変更 をクリックし、以下の 2 つのコンポーネントをインストールしてください。

初期化とログイン

ヘッダー

同梱されているすべての PlayFab 機能にアクセスするには、PFServices.h をインクルードします:

初期化

PlayFab の初期化には、PFServicesInitializePFServiceConfigCreateHandle の 2 つの関数呼び出しが必要です。この初期化の結果として PFServiceConfigHandle が得られます。このハンドルを後続のログイン呼び出しに提供することで、PlayFab バックエンドの正しいタイトルに呼び出しが向けられます。

ログイン

PFServiceConfigHandle を取得したら、それを使ってプレイヤーのログイン呼び出しを行うことができます。SDK では、PFAuthenticationLoginWithSteamAsync のような PFAuthenticationReLoginWith*Async メソッドを使用します。この関数を使用すると、SteamTicket を使ってプレイヤーを PlayFab にログインさせることができます。 ログイン呼び出しを行った後、XAsyncGetStatus で呼び出しのステータスを確認できます。ステータスは最初 E_PENDING で、呼び出しが正常に完了すると S_OK に変わります。何らかの理由で呼び出しが失敗した場合、ステータスにその失敗が反映されます。すべての PlayFab Services 呼び出しにおけるエラー処理はこのように動作します。 S_OK の結果に加えて、PFEntityHandle が返されます。このハンドルを使用して、ログイン済みプレイヤーとして後続の PlayFab 呼び出しを行います。このハンドルには、そのプレイヤーとして PlayFab サービスで認証するために必要なマテリアルが含まれています。

サービス呼び出し

プレイヤーをログインさせた後、PlayFab バックエンドへの呼び出しを行うことができます。現在のプレイヤーの PlayFab に保存されたファイルを取得する呼び出しの例を示します。

EntityKey の取得

PlayFab の一部の呼び出しにおいて、プレイヤーの PFEntityKey を知ることが有用な場合があります。PFEntityToken を取得したら、PFEntityGetEntityKeyPFEntityKey を取得できます。

GetFiles の呼び出し

すべての PlayFab 呼び出しは、リクエストオブジェクトを準備し、(ログインで得られた PFEntityHandle を使用して) 呼び出しを行い、レスポンスを受け取るオブジェクトを作成し、GetResult 関数を呼び出して新しく作成されたコンテナに値を格納するという、類似したパターンに従います。

クリーンアップ

ゲームをシャットダウンする準備ができたとき、または何らかの理由で PlayFab をクリーンアップする必要があるときは、開いているすべてのハンドルを閉じ、PFServicesUninitializeAsync を呼び出してください。

非同期 API パターン

PlayFab Services SDK は、GDK に実装されている 非同期プログラミング モデル に従います。このプログラミング モデルでは、XAsync ライブラリ が提供する Task と Task Queue を使用します。このモデルは、他の GDK 関数や拡張機能 (XBOX Services API など) と一貫しています。多少の複雑さは伴いますが、非同期操作を高度に制御することができます。 以下の例は、PFDataGetFilesAsync を非同期に呼び出す方法を示しています。

エラー処理

完了した XAsync 操作は HTTP ステータスコードを返します。エラーステータスコードは、XAsyncGetStatus() または PF*Get() API のいずれかを呼び出したときに、HTTP_E_STATUS_NOT_FOUND のような失敗を表す HRESULT として現れます。 サービスから返される詳細なエラーメッセージを確認するには、次のデバッグに関するセクションを参照してください。これらの詳細なエラーメッセージは、開発中に PlayFab サービスがクライアントからのリクエストにどのように反応するかをより深く理解するのに役立ちます。

デバッグ

PlayFab Services SDK での結果を確認し、呼び出しをデバッグする最も簡単な方法は、デバッグ トレース を有効にすることです。デバッグ トレースを有効にすると、デバッガーの出力ウィンドウで結果を確認できるだけでなく、ゲーム独自のログに結果をフックすることもできます。

リファレンス

API リファレンス ドキュメント
最終更新日 2026年9月1日