日志检测
最近更新时间：2023.05.08 19:17:18
首次发布时间：2021.11.22 22:37:27
通过日志上报，获取设备播放信息，帮助您进行问题排障和定位，支持查看对应播放策略。本节为您介绍日志检测的操作说明。
背景信息
适用场景：日志检测适用于 SDK 播放调试过程。
- 支持查看播放日志是否上报。
- 支持查看详细的播放日志。
前提条件
- 已完成 SDK 集成。
注意事项
- 用手机扫描二维码前，请确保手机已安装 App 的正确版本。
- 若未同步播放记录，请检查当前 App 是否进行了日志上报。
操作步骤
扫描二维码
单击应用卡片的日志检测按钮，进入扫描二维码页面。
请用手机扫描二维码，在手机页面显示开始检测日志的 H5 页面。
手机浏览器中打开
在手机页面，单击开始检测埋点按钮，进入 App 并调用埋点检测服务，开始上报检测。
实时检测
手机建立检测连接后控制台自动进入实时检测页面。
说明
左侧列表会随着播放行为不断刷新，右侧显示播放记录的详细日志信息。
- 左侧列表默认为未选中状态；
- 选中某条播放记录后，右侧对应显示该播放记录的详细日志信息。
等待控制台显示上报信息。包括播放次数、视频封面、Vid 和播放时间；页面右侧可查看日志信息列表和 JSON 文件。JSON 支持一键复制。
列表中各类信息对应的参数如下表所示。
| 类型 | 参数 |
|---|---|
| 基本信息 | 设备 ID、设备类型、设备系统、系统版本、数据模块版本、网络类型、sessionID、是否冷启动 |
| 时间信息 | 首帧时间戳、播放结束时间戳、首帧耗时、请求播放时间戳、Prepare 调用时间戳、avformat_open 时间戳、未起播离开时间戳 |
| 播放信息 | 用户观看时长、系统音量、播放器音量、API 地址、视频状态码、视频状态码含义、渲染类型、卡顿堆积时长、网络卡顿次数、切换分辨率次数、丢帧数、关闭前播放进度、循环播放的次数、初始播放 URL、播放退出原因、seek次数、seek 总耗时、音频 track 是否异常、视频 track 是否异常、点播自研播放器创建异常、音画不同步次数、有声无画发生的记录列表、有画无声发生的记录列表 |
| 版本信息 | 应用商店、APP 版本、SDK 版本、播放器内核版本 |
| 文件信息 | 视频 ID、tag（业务类型）、subtag、视频类型、moov 位置、mdat 位置、客户端码率 bps、起播清晰度、视频宽、视频高、编码标准、原始帧率、显示帧率、解码帧率、视频总片长、视频总大小、视频播放大小、视频加载大小、视频预加载大小、是否超分、video pkts 缓存时长、audio pkts 缓存时长 |
| 配置信息 | 视频类型、播放方式、是否硬解、是否发生视频渲染错误、解码器类型、硬件解码器名称、芯片名称、芯片硬件名称、是否开启 DNS 缓存、是否开启视频缓存、是否使用 p2p、是否使用本地代理、内容被劫持 |
| 错误及附加信息 | 错误类型、错误码、播放是否中断、附加信息、custom_str |
单击结束检测按钮，关闭检测页面，返回至应用列表页面。
注意
结束检测后播放数据不会保留并返回 SDK 应用管理。
参考操作
在点播 SDK 如何进行设置 ？
Android 设置方式
参考点播 SDK-Android 集成准备中的添加 SDK 依赖小节，进入 module 目录的 build.gradle 文件，在 dependencies 中添加日志上报依赖的 APPLog SDK。添加内容如下所示。
android { defaultConfig { // APPLOG_SCHEME 为 AppLog SDK 必须参数，不填会编译不过 // 对于点播场景，填写 online 即可. manifestPlaceholders.put("APPLOG_SCHEME", "online") } } dependencies { def applog_version = "6.x.x" implementation "com.bytedance.applog:RangersAppLog-Lite-cn:$applog_version" implementation 'com.squareup.okhttp3:okhttp:3.0.0' }
参数说明如下表所示。
| 参数 | 说明 |
|---|---|
| applog_version | AppLog 的版本号。如果您的 APP 已对接过 RangersAppLog，请将 applog_version 修改为已对接版本的版本号。 |
| RangersAppLog-Lite-cn | 日志上报 SDK，用于点播日志上传。 |
| okhttp3 | okhttp 网络引擎，用于视频源获取。 |
iOS 设置方式
参考点播 SDK-iOS 集成准备中的添加 SDK 依赖小节，在您工程的 Podfile 中添加日志上报依赖的 APPLog SDK，并执行 pod install。
pod 'RangersAppLog', '6.x.x', :subspecs =>['Core','Log','Host/CN']
注意
如果您的 APP 已对接过 RangersAppLog，请将版本号修改为已对接版本的版本号。