メインコンテンツへスキップ

クイックスタート: iOS

iOS 向けの PlayFab Services SDK を始めましょう。次の手順に従って、ライブラリをプロジェクトに含め、基本的な PlayFab 機能のサンプルコードを試してください。 このクイックスタートは、iOS SDK を使用して最初の PlayFab API 呼び出しを行うのに役立ちます。続行する前に、クイックスタート: Game Manager の手順を完了し、PlayFab アカウントを持っており、PlayFab Game Manager に慣れていることを確認してください。

要件

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

PlayFab SDK リリースページから PlayFab iOS SDK をプロジェクトにダウンロードします。

PlayFab C SDK を独自のプロジェクトに統合する

バイナリをゲームに追加する

ダウンロードまたはソースからビルドしてバイナリを入手した後、ゲーム/アプリに簡単に統合できます。以下のバイナリをゲームに追加する必要があります:
  • HttpClient_iOS.xcframework
  • PlayFabCore_iOS.xcframework
  • PlayFabServices_iOS.xcframework
これらを追加するには、以下の手順に従います:
  1. XCode で目的のターゲットに移動し、それを選択します。
  2. General セクションで下にスクロールし、“Frameworks, Libraries, and Embedded Content” セクションで ”+” 記号を選択します。
  3. PlayFabServices / PlayFabCore / HttpClient バイナリを検索し、xcframework フォルダーを選択します。(xcframework フォルダー内に移動して特定のライブラリを選択することもできますが、xcframework バンドルをインポートすることをおすすめします。デバイスとシミュレーターのビルドの両方で機能するためです。)
  4. バイナリを正常にインポートすると、HttpClient_iOS、PlayFabCore_iOS、および PlayFabServices_iOS が Frameworks, Libraries, and Embedded Content の下にリスト表示されます。

ヘッダー検索パスの追加

バイナリを追加したら、ヘッダー検索パスも正しく設定されていることを確認する必要があります。
  1. プロジェクトに移動します。
  2. “Build Settings” を選択し、“Header Search Paths” を検索します。
  3. SDK ヘッダーを含めるようにプロパティ値を更新します。include フォルダーにあるヘッダーへの参照を追加します。例:

初期化とサインイン

次の手順に従って、いくつかの PlayFab サンプル呼び出しを動作させます。

ヘッダー

含まれるすべての PlayFab 機能にアクセスするために PFServices.h をインクルードします。

初期化

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

サインイン

PFServiceConfigHandle を取得したら、それを使用してプレイヤーのログイン呼び出しを行うことができます。SDK では、PFAuthenticationLoginWithAppleAsync のような PFAuthenticationLoginWith*Async メソッドを使用します。この関数を使用すると、Apple ユーザーの identity token を使用してプレイヤーを PlayFab にログインさせることができます。(Sign in with Apple でのユーザーの認証に関する Apple のドキュメントを参照してください)。 ログイン呼び出しを行った後、XAsyncGetStatus で呼び出しのステータスを確認できます。ステータスは E_PENDING から始まり、呼び出しが正常に完了すると S_OK に変わります。何らかの理由で呼び出しが失敗した場合、ステータスはその失敗を反映します。すべての PlayFab Services 呼び出しのエラー処理はこのように機能します。 S_OK の結果とともに、PFEntityHandle が返されます。このハンドルを使用して、ログインしたプレイヤーとして後続の PlayFab 呼び出しを行います。これには、そのプレイヤーとして PlayFab サービスで認証するために必要なあらゆるマテリアルが含まれています。

サービス呼び出し

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

EntityKey の取得

PlayFab への一部の呼び出しに役立つのは、プレイヤーの PFEntityKey を知ることです。PFEntityToken を取得したら、PFEntityGetEntityKey で PFEntityKey を取得できます。

GetFiles の呼び出し

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

クリーンアップ

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

非同期 API パターン

PlayFab Services SDK は、GDK で実装された非同期プログラミングモデルに従います。このプログラミングモデルには、XAsync ライブラリによって提供されるタスクとタスクキューの使用が含まれます。このモデルは、他の GDK 関数や拡張機能 (XBOX Services API など) と一貫しています。若干の複雑さは導入しますが、非同期操作に対する高度な制御ももたらします。 この例は、PFDataGetFilesAsync への非同期呼び出しを行う方法を示しています。

エラー処理

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

デバッグ

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

関連項目

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