語法
參數
traceLevel PFTraceLevelIn 要發出的最大詳細程度。會發出此層級及較不詳細層級的事件,並捨棄較詳細的事件。依詳細程度由低至高,
PFTraceLevel 值為 Off (0)、Error (1)、Warning (2)、Important (3)、Information (4) 和 Verbose (5)。傳遞 PFTraceLevel::Off 可捨棄 PlayFab 追蹤區域中的所有追蹤事件。
傳回值
類型:HRESULT 如果已設定追蹤層級,則傳回S_OK。如果 traceLevel 大於 PFTraceLevel::Verbose,則傳回 E_INVALIDARG;在此情況下,目前的追蹤層級不會變更。
備註
PlayFab 追蹤區域包含PlayFabCore、PlayFabServices 和 PlayFabGameSave 所記錄的事件。PlayFabCore 會儲存層級,而這三個程式庫都會使用它。預設層級為 PFTraceLevel::Verbose。每個 PFTraceLevel 值都等於 libHttpClient 之 HCTraceLevel 的對應值。
您可以隨時呼叫此函式,包括在 PFInitialize 之前。層級會以不可部分完成的方式儲存,因此您可以從任何執行緒呼叫此函式。層級在 PFUninitializeAsync 之後仍然有效。
此函式不會變更 libHttpClient 的追蹤層級。若要控制 libHttpClient 的 HTTP 和 WebSocket 事件,請呼叫 HCSettingsSetTraceLevel。PlayFab 初始化之後,通過此篩選的 PlayFab 事件會送往您透過 libHttpClient 追蹤設定的輸出,例如偵錯工具 (HCTraceSetTraceToDebugger) 和用戶端回呼 (HCTraceSetClientCallback)。如果在 PFInitialize 之前呼叫 PFTraceEnableTraceToFile 成功,且儲存體處理常式可以寫入檔案,這些事件也會送往追蹤檔案。
下列範例會將所有 PlayFab 和 libHttpClient 追蹤事件傳送至偵錯工具。
需求
標頭: PFTrace.h 程式庫: PlayFabCore.lib 支援的平台: Windows、XBOX One 系列主機與 XBOX Series 主機另請參閱
PFTrace 成員偵錯追蹤
