構文
パラメーター
traceLevel PFTraceLevelIn 出力する最大の詳細レベル。このレベルおよびそれより詳細度の低いレベルのイベントが出力され、より詳細なイベントは破棄されます。
PFTraceLevel の値は、詳細度の低いものから順に Off (0)、Error (1)、Warning (2)、Important (3)、Information (4)、Verbose (5) です。PlayFab トレース領域のすべてのトレース イベントを破棄するには、PFTraceLevel::Off を渡します。
戻り値
型: HRESULT トレース レベルが設定された場合はS_OK。traceLevel が PFTraceLevel::Verbose より大きい場合は E_INVALIDARG で、その場合、現在のトレース レベルは変更されません。
解説
PlayFab トレース領域には、PlayFabCore、PlayFabServices、PlayFabGameSave がログに記録するイベントが含まれます。レベルは PlayFabCore が保持し、3 つのライブラリすべてがそれを使用します。既定のレベルは PFTraceLevel::Verbose です。各 PFTraceLevel の値は、libHttpClient の HCTraceLevel の対応する値と同じです。
この関数は、PFInitialize の前を含め、いつでも呼び出すことができます。レベルはアトミックに格納されるため、この関数は任意のスレッドから呼び出すことができます。レベルは PFUninitializeAsync の後も有効なままです。
この関数は libHttpClient のトレース レベルを変更しません。libHttpClient の HTTP および WebSocket のイベントを制御するには、HCSettingsSetTraceLevel を呼び出します。PlayFab の初期化後、このフィルターを通過した PlayFab のイベントは、デバッガー (HCTraceSetTraceToDebugger) やクライアント コールバック (HCTraceSetClientCallback) など、libHttpClient のトレースで構成した出力先に送られます。また、PFInitialize の前に PFTraceEnableTraceToFile の呼び出しが成功し、ストレージ ハンドラーがファイルに書き込める場合は、トレース ファイルにも送られます。
次の例では、PlayFab と libHttpClient のすべてのトレース イベントをデバッガーに送ります。
要件
ヘッダー: PFTrace.h ライブラリ: PlayFabCore.lib サポートされているプラットフォーム: Windows、XBOX One ファミリー本体および XBOX Series 本体関連項目
PFTrace のメンバーデバッグ トレース