Skip to main content
このガイドでは、Unified SDK を使用して PlayFab サービス API 呼び出しを行う方法を説明します。プレイヤーデータの管理、ファイルの取得、およびその他の PlayFab 機能との対話を行うために、さまざまな PlayFab サービスを呼び出す方法を学びます。

前提条件

開始する前に、以下を確認してください:
  • コア SDK のセットアップと認証を完了済みであること
  • ログインプロセスから取得した認証済みの PFEntityHandle
  • PlayFab タイトル ID とサービス構成が設定されていること
このガイドでは、コアクイックスタートガイドに従って、既に PlayFab SDK を初期化し、プレイヤーを認証していることを前提としています。まだの場合は、まずそのガイドを完了してください。

達成すること

このクイックスタートの終わりまでに、以下を達成します:
  • 認証済みプレイヤーのエンティティキーを取得する
  • 最初の PlayFab サービス API 呼び出しを行う
  • PlayFab サービスからのレスポンスを処理する

最初のサービス API 呼び出しを行う

認証が成功したら、ログイン中に取得した PFEntityHandle を使用して PlayFab API 呼び出しを行うことができます。この例では、現在のプレイヤーに保存されているファイルを取得する方法を示します。

ステップ 1: エンティティキーを取得する

まず、認証済みエンティティハンドルからエンティティキーを取得します:

ステップ 2: GetFiles API を呼び出す

次に、プレイヤーに関連付けられたファイルを取得するために、最初の PlayFab サービス呼び出しを行います:
🎉 おめでとうございます! Unified SDK を使用した最初の PlayFab サービス API 呼び出しに成功しました。

API 呼び出しのパターンを理解する

すべての PlayFab サービス API 呼び出しは、同様のパターンに従います:
  1. リクエストを準備する - リクエスト構造体を作成し、値を設定します
  2. 非同期呼び出しを開始する - *Async 関数を呼び出します
  3. 完了を待つ - XAsyncGetStatus を使用して操作が完了するのを待ちます
  4. 結果サイズを取得する - *GetResultSize を呼び出して必要なバッファーサイズを決定します
  5. 結果を取得する - *GetResult を呼び出して実際のデータを取得します
このパターンはすべての PlayFab サービス API に適用されるため、基本を理解すればさまざまなサービスを簡単に扱うことができます。

次のステップ

PlayFab サービスの呼び出しに成功したので、次はこれらの追加機能を探索しましょう:

一般的なサービス API

  • プレイヤーデータ管理 - カスタムプレイヤーデータを保存・取得
  • プレイヤー統計 - プレイヤーの統計と実績を追跡
  • タイトルデータ - ゲーム構成データにアクセス
  • Cloud Script - サーバーサイドロジックを実行

高度な機能

  • リーダーボード - ランキング付きの競争機能を実装
  • 経済とマネタイゼーション - 仮想通貨とアイテムを追加
  • マルチプレイヤー - マッチメイキングとロビーサービスを統合
  • アナリティクス - プレイヤーの行動とゲーム指標を追跡

ベストプラクティス

トラブルシューティング

一般的な問題と解決策: より詳細なエラー情報については、アプリケーションでトレースと診断を有効にしてください。

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

最終更新日 2026年8月25日