跳轉到主要內容
設定 Microsoft Azure PlayFab 追蹤區域中事件的追蹤層級。

語法

參數

traceLevel PFTraceLevel
In
要發出的最大詳細程度。會發出此層級及較不詳細層級的事件,並捨棄較詳細的事件。依詳細程度由低至高,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 成員
偵錯追蹤
最後修改於 2026年11月5日