语法
参数
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 成员调试跟踪
