All Products
Search

This Product

    ApsaraVideo Live:Troubleshoot issues with Push SDK

    Document Center

    ApsaraVideo Live:Troubleshoot issues with Push SDK

    Last Updated:Dec 15, 2025

    This topic provides troubleshooting steps and best practices for resolving common issues with the Push SDK, helping you diagnose and solve problems.

    References

    Console navigation

    The ApsaraVideo Live console supports various features, including live stream management, application management, data center, and toolbox. 

    • For information about features supported by the console, see Feature overview.

    • To manage your SDK licenses, go to the My Licenses page in the console.

    • For information about how to use the troubleshooting tool in the toolbox, see Troubleshooting.

    FAQ

    • If you encounter issues with license configurations, see FAQ.

    • If exceptions occur during stream ingest, use the troubleshooting tool to verify whether the ingest URL is valid. 

    Technical support

    If the issues cannot be resolved by referring to the documents provided in this topic, contact us for technical support.

    Provide the following information to get effective technical support faster:

    Item

    Description

    Note

    Overview

    Describe the issue you encountered in one sentence.

    -

    Issue description

    1. Business scenario

      Specify the scenario in which the SDK is used, such as standard live streaming or interactive streaming.

    2. SDK information

      Specify the SDK type and version.

    3. Stage

      Specify the stage at which the issue occurred, such as integration or operation.

    4. Issue description

      Decribe the issue in detail, such as the stream was interrupted, no view is displayed, or no sound.

    5. Reproduction

      Describe whether the issue is consistent or intermittent and how to reproduce it.

    6. Distribution

      Provide distributioninformation about the platform, system version, device model, and region.

    1. For license-related issues, provide your application package name and License Key.

    2. We recommend that you use the latest version of the SDK for better support.

    Context

    1. Details

      Provide detailed environment information where the issue occurred.

    2. Ingest and streaming URLs

      Redact or sanitize any sensitive information.

    3. Time of occurrence

    4. Error logs

      Compress logs, such as logcat logs or file logs.

    5. Configurations

      These may include the application name, package name, and multi-host streaming configurations.

    6. Other information

      This may include screenshots or screen recordings.

    1. Before you capture logs, make sure that you have configured the logging feature by calling the relevant API operations in the AlivcLiveBase class. For more information, see the source code of the demo application.

    2. We recommend that you do not capture the file logs during the live stream.

    3. Path of file logs: 

      1. Android: /sdcard/Android/data/${app_id}/files/

      2. iOS: in the sandbox directory

    4. For multi-host streaming, provide the following information:

      1. Host's ingest URL (including AppID, channel number, and user ID)

      2. Viewer's streaming URL (including the playback domain configured in stream relay)

    Additional information

    1. Any error messages (if available, include error codes/messages).

    2. Whether the exception can be automatically recovered (such as auto-reconnection).

    3. Other information that may help identify the issue.

    Issue description template

    Template

    Title: One-sentence summary of the issue.
Business scenario: Such as standard live streaming, interactive streaming, Real-Time Streaming.
SDK version: Such as AlivcLivePusher: x.y.z or AlivcLivePusher_Interactive: x.y.z.
App/Package name: Such as LiveExample / com.example.liveapp

Issue description: For example, occasional stream interruption / Unable to pull stream / No video. Briefly describe the specific symptoms.
Reproduction: For example, intermittent or consistent.
Detailed reproduction steps:
1. 
2. 
3. 
Affected users/device distribution: Such as Android 9 and earlier / iOS / Specific regions.

Ingest URL: Paste the complete ingest URL.
Streaming URL: If applicable.
Occurrence time: Specify the exact time, or provide examples if multiple occurrences.
Network environment: Wi-Fi/4G/5G/Wired network.
Issue logs: Logcat logs, ingest/streaming logs, preferably compressed.
Screen recording/screenshots: Upload any recordings or key screenshots of abnormal behavior.
Ingest parameter configuration: Such as resolution, frame rate, and bitrate.

Error messages: If errors occurred, provide error codes or messages.
Automatic recovery from exception: For example, auto-reconnection. Describe reconnection results.
Other: Any information you think might be helpful.

    Standard live streaming issue

    Title: Occasional stream interruption during standard live streaming.
Business scenario: Standard live streaming.
SDK version: AlivcLivePusher: x.y.z.
App/Package name: LiveExample / com.example.liveapp

Issue description: During streaming, the stream is occasionally interrupted approximately every 30 minutes, requiring manual restart.
Reproduction: Intermittent.
Detailed reproduction steps:
1. Start stream ingest.
2. Stream interruption occurs after about 30 minutes.
3. Need to ingest again to recover.
Affected users/device distribution: Android 9 and earlier, multiple device models, more frequent in Southeast Asia.

Ingest URL: rtmp://test.alivecdn.com/live/streamId?auth_key=XXX
Occurrence time: 2024-05-18 12:34
Network environment: 4G
Issue logs: See attachment logcat_20240518.zip.
Screen recording/screenshots: See attachment.
Ingest parameter configuration: Resolution 720p, bitrate 1500kbps, frame rate 30fps.

Error messages: No error messages.
Automatic recovery from exception: No, manual restart required.
Other: None.

    Interactive streaming issue

    Title: CDN viewers cannot receive host's video.
Business scenario: Multi-host streaming, AUI Kits interactive streaming.
SDK version: AlivcLivePusher_Interactive: x.y.z
App/Package name: LiveExample / com.example.liveapp

Issue description: Host-side stream ingest is normal, guests can pull the stream normally, but viewers cannot see the host's video, with no error messages.
Reproduction: Consistent.
Detailed reproduction steps:
1. Host starts interactive streaming and begins stream ingest.
2. Guests receive the host's stream normally.
3. Viewers (Android/iOS) enter the channel but cannot see the host's video.
Affected users/device distribution: Consistent on both Android and iOS.

Ingest URL: artc://live.aliyun.com/push/633?timestamp=1685094092&token=fe4e674ade****6686&userId=718&sdkAppId=xxx
Streaming URL: rtmp://test.alivecdn.com/live/xxx_633_718_camera?auth_key=XXX
Configuration: Channel number 633, AppID xxx, User ID 718, Playback domain test.alivecdn.com.
Occurrence time: 2024-05-18 12:34
Network environment: Wi-Fi
Issue logs: See attachment logcat_20240518.zip.
Screen recording/screenshots: See attachment.
Ingest parameter configuration: Resolution 720p, bitrate 1200kbps, frame rate 20fps.

Error messages: None.
Automatic recovery from exception: No, need to restart streaming.
Other: No messages on viewer side. Switching networks/devices does not help.