​

Lobby and Matchmaking SDK エラーの処理

このページは、PlayFab Lobby and Matchmaking SDK がエラーをどのように公開し、それらをどのように処理すべきかについてのガイダンスを提供するクイック リファレンスとして提供されます。 以下のトピックについて説明します:

• 同期エラーと非同期エラー
• エラー コードとエラー メッセージ

​

同期エラーと非同期エラー

多くの SDK API は非同期です。PFMultiplayerCreateAndJoinLobby のような API を呼び出して操作を開始し、その後、その非同期操作は PFLobbyCreateAndJoinLobbyCompletedStateChange のような「state change」で完了します。 つまり、非同期の Lobby and Matchmaking Client API を使用する場合、処理する必要があるエラーには 2 種類あります:

1. 同期エラー
2. 非同期エラー

SDK の非同期モデルと state changes の詳細については、非同期操作 のドキュメント ページを参照してください。 PFLobbyGetLobbyId のような同期 API の場合は、同期エラーのみを処理する必要があります。

​

同期エラー

「同期エラー」は API 呼び出しの戻り値として提供される HRESULTs です。これらのエラーは通常、不正なパラメーターで API を呼び出す、ライブラリが無効な状態のときに API を呼び出す、またはメモリを割り当てる際の内部ライブラリの失敗によるものです。API が同期エラーを返した場合、API によって提供される出力パラメーターは無効と見なす必要があります。 非同期 API (例: PFMultiplayerCreateAndJoinLobby) を呼び出す場合、同期エラーの値は、リクエストされた操作を開始できたかどうかのみを表します。非同期操作の結果を理解する方法については、非同期エラー セクションを参照してください。

​

非同期エラー

「非同期エラー」は、各操作の非同期完了に関連付けられた state change の result フィールドで HRESULTs として提供されます。これらのエラーは通常、同期エラーよりもタイトルにとって重要です。非同期で報告されるエラーの種類の一部の非網羅的なリストには、次のものが含まれます:

• サービスのスロットリング エラー
• クライアント上で同期的に検証できない無効なパラメーター エラー
• リアルタイム メッセージ サービスとのやり取りに関するエラー
• 接続性エラー

同期エラーと非同期エラーの両方について人間可読なエラー メッセージを取得するためのガイダンスについては、エラー コードとエラー メッセージ セクションを参照してください。

​

エラー コードとエラー メッセージ

エラー (同期か非同期かを問わず) は、HRESULT (4 バイトの数値エラー コード) の形式でライブラリから提示されます。これらのコンパクトなエラー コードは、テレメトリや、予期しないタイトルの動作をデバッグするために使用される他の診断ツールへの記録に理想的です。 これらのエラー コードは、PFMultiplayerGetErrorMessage を呼び出すことで人間可読なメッセージに変換できます。これらのエラー メッセージは開発者のみが確認することを想定しています。ローカライズされておらず、エンド ユーザーが読むことを意図していないため、内部の開発ログに最適です。 さらに、エラー メッセージ付きの SDK のエラー コードのリストは PlayFab Multiplayer SDK エラー コード で確認できます。