All Products
Search

This Product

    ApsaraVideo Live:Live stream ingest

    Document Center

    ApsaraVideo Live:Live stream ingest

    Last Updated:Jul 17, 2024

    You can use Open Broadcaster Software (OBS), the Push SDK demo, or Push SDK to ingest a stream. This topic describes how to use these different methods to ingest a stream.

    Prerequisites

    An ingest URL is generated. For more information, see Generate ingest and streaming URLs.

    Usage notes

    ApsaraVideo Live does not allow you to ingest multiple streams to a URL at the same time. If you attempt to ingest multiple streams at the same time, only the first stream is ingested.

    Note

    • If you encounter issues such as stream ingest exceptions during stream ingest, you can use the troubleshooting tool to troubleshoot the issues. The tool allows you to diagnose common stream ingest issues and provides suggestions for you to resolve specific exceptions. For more information, see Troubleshooting.

    • If you use a third-party stream ingest tool, we recommend that you configure high availability policies to respond to stream ingest failures and alarms. This prevents your live streaming business from being interrupted by stream ingest failures caused by system issues. You can also configure a callback to monitor the stream ingest status. This way, a streaming URL is issued after the stream is ingested. For more information, see Manage callbacks.

    Use OBS to ingest a stream

    OBS supports Windows, macOS, and Linux. In the following example, OBS Studio V27.2.3 for Windows is used. The operations that you perform to ingest a stream are similar for OBS Studio of other versions or on other platforms. For more information about how to use OBS, see Use OBS to ingest streams.

    1. Download and install OBS Studio. Download link: OBS Studio.

    2. Run OBS Studio.

    3. In the menu bar, choose File > Settings.

    4. On the Settings page, click Stream and configure the following parameters.

      001

      Parameter

      Description

      Service

      Select Custom....

      Server

      Enter the generated ingest URL that is signed. Example: rtmp://demo.aliyundoc.com/app/stream?auth_key=1543302081-0-0-9c6e7c8190c10bdfb3c0************.

      Stream Key

      Leave this parameter empty.

    5. Go to the homepage of OBS Studio. Find the Sources section, add a source, and then click Start Streaming.

      002

    6. (Optional) Install the Queen SDK plug-in for OBS to debug retouching effects. For more information, see User guide to the Queen SDK plug-in for OBS.

    7. In the ApsaraVideo Live console, go to the Stream Management page. On the Active Streams tab, you can view and manage the ingested audio or video stream.

    Use the Push SDK demo to ingest a stream

    1. Use a mobile device to scan the QR code to download the Push SDK demo.

      国际站

      Note

      If you use an iOS device and receive a message indicating that the demo is from an untrusted enterprise developer, tap Settings > General > Device Management. On the page that appears, find the permissions required by Taobao and tap Trust.

    2. Run the Push SDK demo.

    3. Select Camera Pushing or Screen Sharing.

      Note

      Only YUV files are allowed when you ingest local streams from a mobile device.

    4. Enter the generated ingest URL that is signed. Example: rtmp://demo.aliyundoc.com/app/stream?auth_key=1543302081-0-0-9c6e7c8190c10bdfb3c0************. Configure other parameters based on your business requirements.

    5. Click Start to start stream ingest.

    6. In the ApsaraVideo Live console, go to the Stream Management page. On the Active Streams tab, you can view and manage the ingested audio or video stream.

    Use Push SDK to ingest a stream

    Push SDK for iOS

    1. Integrate Push SDK for iOS. For more information, see SDK integration.

    2. Configure the stream ingest parameters based on your business requirements and ingest a stream. For more information, see Use Push SDK for iOS.

      Exceptions may occur when you configure the stream ingest parameters or ingest a stream. For more information, see Handle errors, exceptions, and special cases.

    Push SDK for Android

    1. Integrate Push SDK for Android. For more information, see SDK integration.

    2. Configure the stream ingest parameters based on your business requirements and ingest a stream. For more information, see Use Push SDK for Android.

      Exceptions may occur when you configure the stream ingest parameters or ingest a stream. For more information, see Handle errors, exceptions, and special cases.

    Push SDK for Flutter

    1. Integrate Push SDK for Flutter. For more information, see SDK integration.

    2. Configure the stream ingest parameters based on your business requirements and ingest a stream. For more information, see Use Push SDK for Flutter.

    Push SDK for Web

    What to do next

    • After a stream is ingested, you can play the stream. For more information, see Live stream playback.

    References