日志检测--视频点播-火山引擎

文档中心

立即注册

导航

日志检测

最近更新时间：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，请将版本号修改为已对接版本的版本号。

视频点播