Skip to main content
このチュートリアルでは、PlayFab SDK を使用して API エラーにアクセスし、認識し、処理する方法を示します。 ここで説明するプラクティスは、admin、server、client の各 SDK に等しく適用できますが、パターンは選択する言語に 大きく 依存します。 簡単に言えば、選択するパターンはどの SDK (admin/server/client) にも有効ですが、実装の詳細は あなたの プログラミング言語と環境に固有のものになります。

エラーのキャッチとアクセス

PlayFab SDK は通常、エラー オブジェクトを返すことでエラーを報告します。次のスニペットは、エラーを検出しアクセスする方法を示しています。
一般に、エラー オブジェクトが定義されている (null ではない) 場合、エラーが発生したことを示します。その後さらにエラーを検査できます。

エラーの検査

エラーを検査する最も一般的な方法は、コードから認識することです。グローバル API メソッド エラー コード で説明されているとおり、生成される各エラーには人間可読なエラー コードと数値エラー コードが含まれます。
コード 単独で エラーを認識し、それに従って処理するのに十分です。
例として LoginWithEmailAddress API メソッドを取り上げます。このメソッドの ドキュメント に記載されているとおり、実行時に次の内部エラーがスローされる可能性があります:
  • InvalidTitleId 1004
  • AccountNotFound 1001
  • InvalidEmailOrPassword 1142
  • RequestViewConstraintParamsNotAllowed 1303
次のメソッドは、そのようなエラーを検査して認識する方法を示しています。

エラーの処理

エラーが特定されると、処理/回復の戦略はエラーの種類と性質によって異なります。無効な引数 などのエラーは、再試行しても成功しません。その API 呼び出しを成功させるには、リクエストを修正する必要があります。 再試行戦略を適用できるエラーのサブセットがあります。再試行可能 なエラーの種類は グローバル API メソッド エラー コード に記載されています。 再試行戦略を適用する際は、次の要件を満たすようにしてください:
  • 再試行のたびに、再試行間の遅延を 指数関数的に増加 させる必要があります。これにより、呼び出しが成功する確率が 高まり、ゲームが PlayFab サーバーにスパムを送信するのを防げます (スパム送信は さらに多くの 拒否された呼び出しにつながります)。
  • この再試行戦略は 選択的に 適用し、再試行する価値のあるコードにのみ使用してください。
再試行しても安全なコードの一覧は、グローバル API メソッド エラー コード チュートリアルを参照してください。
最終更新日 2026年8月13日