SDK 调试

您可以启用和禁用日志记录功能。Media SDK 会在整个媒体跟踪堆栈中提供广泛的跟踪/日志记录机制。您可以通过在配置对象中设置 debugLogging 标记，来启用或禁用日志记录功能。

有关调试日志记录的代码示例

Android

// Media Heartbeat initialization
MediaHeartbeatConfig config = new MediaHeartbeatConfig();
config.debugLogging = true;

// Use this space for setting other config values
MediaHeartbeat _heartbeat = new MediaHeartbeat(this, config);

iOS

// Media Heartbeat Initialization
ADBMediaHeartbeatConfig *config = [[ADBMediaHeartbeatConfig alloc] init];
config.debugLogging = YES;

// Use this space for setting other config values
ADBMediaHeartbeat *_mediaHeartbeat =
[[ADBMediaHeartbeat alloc] initWithDelegate:self config:config];

JavaScript

// Media Heartbeat initialization
var mediaConfig = new MediaHeartbeatConfig();
mediaConfig.debugLogging = true;
this._mediaHeartbeat = new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurement);

OTT（Chromecast、Roku）

ADBMobile 库通过 setDebugLogging 方法提供调试日志记录。对于所有生产应用程序，调试日志记录应设置为 false。

Roku

ADBMobile().setDebugLogging(true)

Chromecast

ADBMobile.config.setDebugLogging(true)

日志消息

日志消息采用以下格式：

Format: [<timestamp>] [<level>] [<tag>] [<message>]
Example: [16:10:29 GMT­0700 (PDT).245] [DEBUG] [plugin::player] Resolving qos.startupTime: 0

• 时间戳：​这是当前 CPU 时间（GMT 时区）
• 级别：​定义了 4 个消息级别：
  • 信息 - 通常来自应用程序的输入数据（验证播放器名称、视频 ID 等）
  • 调试 - 调试日志，开发人员使用它调试比较复杂的问题
  • 警告 - 指示潜在的集成/配置错误或心率 SDK 错误
  • 错误 - 指示重要的集成错误或心率 SDK 错误
• 标记：​发出日志消息的子组件的名称（通常是类名称）
• 消息：​实际跟踪消息

您可以使用 Media SDK 库输出的日志来验证实施。一种有效的方法是在日志中搜索字符串 #track。这会突出显示您的应用程序发出的所有 track*() 调用。

例如，在日志中过滤 #track 的结果如下所示：

[16:10:29 GMT­0700 (PDT).222] [INFO] [plugin::player] #trackVideoLoad()
[16:10:29 GMT­0700 (PDT).230] [INFO] [plugin::player] #trackSessionStart()
[16:10:29 GMT­0700 (PDT).250] [INFO] [plugin::player] #trackPlay()
[16:10:29 GMT­0700 (PDT).759] [INFO] [plugin::player] #trackChapterStart()
[16:10:44 GMT­0700 (PDT).769] [INFO] [plugin::player] #trackAdStart()
[16:10:59 GMT­0700 (PDT).752] [INFO] [plugin::player] #trackAdComplete()
[16:10:59 GMT­0700 (PDT).770] [INFO] [plugin::player] #trackChapterStart()
[16:11:29 GMT­0700 (PDT).734] [INFO] [plugin::player] #trackPause()
[16:11:29 GMT­0700 (PDT).764] [INFO] [plugin::player] #trackComplete()
[16:11:29 GMT­0700 (PDT).766] [INFO] [plugin::player] #trackVideoUnload()