You need to enable JavaScript to run this app.
导航
日志检测
最近更新时间:2023.05.08 19:17:18首次发布时间:2021.11.22 22:37:27

通过日志上报,获取设备播放信息,帮助您进行问题排障和定位,支持查看对应播放策略。本节为您介绍日志检测的操作说明。

背景信息

适用场景:日志检测适用于 SDK 播放调试过程。

  • 支持查看播放日志是否上报。
  • 支持查看详细的播放日志。

前提条件

注意事项

  • 用手机扫描二维码前,请确保手机已安装 App 的正确版本。
  • 若未同步播放记录,请检查当前 App 是否进行了日志上报

操作步骤

扫描二维码

  1. 单击应用卡片的日志检测按钮,进入扫描二维码页面。

  2. 请用手机扫描二维码,在手机页面显示开始检测日志的 H5 页面。

手机浏览器中打开

在手机页面,单击开始检测埋点按钮,进入 App 并调用埋点检测服务,开始上报检测。

实时检测

  1. 手机建立检测连接后控制台自动进入实时检测页面。

    说明

    左侧列表会随着播放行为不断刷新,右侧显示播放记录的详细日志信息。

    • 左侧列表默认为未选中状态;
    • 选中某条播放记录后,右侧对应显示该播放记录的详细日志信息。
  2. 等待控制台显示上报信息。包括播放次数、视频封面、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
  1. 单击结束检测按钮,关闭检测页面,返回至应用列表页面。

    注意

    结束检测后播放数据不会保留并返回 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_versionAppLog 的版本号。如果您的 APP 已对接过 RangersAppLog,请将 applog_version 修改为已对接版本的版本号。
RangersAppLog-Lite-cn日志上报 SDK,用于点播日志上传。
okhttp3okhttp 网络引擎,用于视频源获取。

iOS 设置方式

参考点播 SDK-iOS 集成准备中的添加 SDK 依赖小节,在您工程的 Podfile 中添加日志上报依赖的 APPLog SDK,并执行 pod install

pod 'RangersAppLog', '6.x.x', :subspecs =>['Core','Log','Host/CN']

注意

如果您的 APP 已对接过 RangersAppLog,请将版本号修改为已对接版本的版本号。