跳转到主要内容
设置 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日