推流SDK异常自助排查

本文主要介绍推流SDK异常时,自助排查异常根因的定位思路及排查步骤。

相关文档参考

控制台操作指引

视频直播控制台提供了直播管理、应用管理、数据中心和工具箱功能模块的配置与使用。有关详细信息,请参考以下:

您可以通过控制台自助问题排查功能发现并解决直播流相关的问题。

常见问题

您可以参考以下文档来解决常见错误:

技术支持

如果按照上述流程依然无法解决您的问题,您可以提交工单以获取技术支持。有关详细信息,请参考联系我们文档。

问题描述

在获取技术支持时,请务必提供以下信息,以便提升技术支持效率:

项目

详细说明

备注

问题简述

请用一句话简要描述你遇到的问题

-

问题描述

  1. 业务场景

    如基础直播、直播连麦等。

  2. SDK 信息

    如SDK类型及版本。

  3. 问题阶段

    如接入问题、线上问题等。

  4. 问题类型及特征

  5. 重现步骤

    如必现/偶现,操作说明等。

  6. 分布情况

    如平台分布、系统版本分布、机型分布、地区分布等。

  1. 如果您使用AUI Kits解决方案,请注明。

  2. License问题请备注应用包名和License Key。

  3. 建议您使用最新的SDK版本,以获得更好的支持。

问题上下文

  1. 详细说明

    提供问题发生的更加详细的上下文信息。

  2. 推拉流地址

  3. 发生时间点

  4. 问题日志

    如logcat日志、文件日志等。

  5. 配置信息

    如应用名称、包名、直播连麦配置等。

  6. 其它信息

    如录屏等。

  1. 在进行文件日志抓取之前,请确保已通过AlivcLiveBase中的日志接口设置好了文件日志记录功能。您可以参考Demo中关于日志接口的调用方法来进行接入和配置。

  2. 在获取文件日志时,建议在关闭直播后再行抓取。

  3. 获取文件日志的方法如下:

    1. Android:您可以在files目录下找到日志文件。一般位于:/sdcard/Android/data/${app_id}/files/中。

    2. iOS:您可以在沙盒文件中找到日志文件。

  4. 直播连麦场景,请提供直播连麦配置应用ID、旁路转推中配置的播放域名。

模板范式及样例

模板范式

模板示例

(请用一句话简要描述你遇到的问题)

问题描述

业务场景:

SDK 信息:

问题阶段:

问题类型及特征:

重现步骤:

分布情况:

问题上下文

推拉流地址:

发生时间点:

问题日志:

配置信息:

其它:

基础直播推流过程中偶尔断流

问题描述

业务场景:基础直播

SDK 信息:AlivcLivePusher:6.11.0

问题阶段:线上问题

问题类型及特征:推流过程中偶尔断流

重现步骤:偶现,大约每次推流 30 分钟后发生一次

分布情况:Android 9 以下,多个机型,主要发生在某一区域

问题上下文

推流地址:rtmp://example.com/live/stream

发生时间点:2024-05-18 12:34

问题日志:见附件(logcat 日志)

配置信息:应用名称:LiveExample;包名:com.example.liveapp;域名:example.com

其它:见附件(录屏视频)

直播连麦CDN观众拉流失败

问题描述

业务场景:直播连麦

SDK 信息:AlivcLivePusher_Interactive:6.11.0

问题阶段:线上问题

问题类型及特征:主播已启动直播连麦,连麦观众拉流正常,但 CDN 观众无法接收到主播的推流画面,且无任何错误提示

重现步骤:必现,步骤如下:

  1. 主播端启动直播连麦并开始推流

  2. 观众端加入直播间

  3. 观众端始终未能接收到主播的直播画面

分布情况:Android 和 iOS 均必现

问题上下文

推流地址:artc://live.aliyun.com/push/example

拉流地址:rtmp://example.com/live/stream

发生时间点:2024-05-18 12:34

问题日志:见附件(logcat 日志)

配置信息:应用名称:LiveExample;包名:com.example.liveapp;直播连麦 App ID:123456

其它:见附件(录屏视频)