SDK 调试 sdk-debugging
您可以启用和禁用日志记录功能。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 GMT0700 (PDT).245] [DEBUG] [plugin::player] Resolving qos.startupTime: 0
-
时间戳: 这是当前 CPU 时间(GMT 时区)
-
级别: 定义了 4 个消息级别:
- 信息 - 通常来自应用程序的输入数据(验证播放器名称、视频 ID 等)
- 调试 - 调试日志,开发人员使用它调试比较复杂的问题
- 警告 - 指示潜在的集成/配置错误或心率 SDK 错误
- 错误 - 指示重要的集成错误或心率 SDK 错误
-
标记: 发出日志消息的子组件的名称(通常是类名称)
-
消息: 实际跟踪消息
您可以使用 Media SDK 库输出的日志来验证实施。一种有效的方法是在日志中搜索字符串 #track
。这会突出显示您的应用程序发出的所有 track*()
调用。
例如,在日志中过滤 #track
的结果如下所示:
[16:10:29 GMT0700 (PDT).222] [INFO] [plugin::player] #trackVideoLoad()
[16:10:29 GMT0700 (PDT).230] [INFO] [plugin::player] #trackSessionStart()
[16:10:29 GMT0700 (PDT).250] [INFO] [plugin::player] #trackPlay()
[16:10:29 GMT0700 (PDT).759] [INFO] [plugin::player] #trackChapterStart()
[16:10:44 GMT0700 (PDT).769] [INFO] [plugin::player] #trackAdStart()
[16:10:59 GMT0700 (PDT).752] [INFO] [plugin::player] #trackAdComplete()
[16:10:59 GMT0700 (PDT).770] [INFO] [plugin::player] #trackChapterStart()
[16:11:29 GMT0700 (PDT).734] [INFO] [plugin::player] #trackPause()
[16:11:29 GMT0700 (PDT).764] [INFO] [plugin::player] #trackComplete()
[16:11:29 GMT0700 (PDT).766] [INFO] [plugin::player] #trackVideoUnload()
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb