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 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.
If you encounter issues such as stream ingest exceptions during stream ingest, you can use the troubleshooting tool to troubleshoot the issues. The tool lets you 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 Callback management.
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 of other versions or on other platforms are similar.
Download and install OBS Studio. Download link: OBS Studio.
Run OBS Studio.
In the menu bar, choose File > Settings.
On the Settings page, click Stream and configure the following parameters:
Parameter
Description
Service
Select Custom.
Server
Enter the generated ingest URL with authentication. Example:
rtmp://demo.aliyundoc.com/app/stream?auth_key=1543302081-0-0-9c6e7c8190c10bdfb3c0************.Stream Key
The stream key is empty.
In the Sources area of the OBS main window, add a source and then click Start Streaming.
Go to Stream Management. On the Active Streams tab, you can view and manage the ingested streams.
Use the Push SDK demo to ingest a stream
You can use a mobile device to scan and install the Alibaba Cloud Live Streaming Demo.
NoteIf you are using an iOS device and a message about an untrusted enterprise developer appears, go to Settings > General > Device Management. Find the profile for Taobao and tap Trust.
You can run the Alibaba Cloud Live Streaming demo.
Select Camera Ingest or Screen Recording Ingest.
NoteOnly YUV files are allowed when you ingest local streams from a mobile device.
Enter the authenticated ingest URL. For example:
rtmp://demo.aliyundoc.com/app/stream?auth_key=1543302081-0-0-9c6e7c8190c10bdfb3c0************. Configure other parameters as needed.Click Start Ingest to begin streaming from your mobile device.
Go to Stream Management. On the Active Streams tab, you can view and manage the ingested streams.
Use Push SDK to ingest a stream
Push SDK for iOS
Integrate Push SDK for iOS. For more information, see SDK integration.
You can configure stream ingest parameters and start stream ingest as needed. For more information, see Feature usage.
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
Integrate Push SDK for Android. For more information, see SDK integration.
Configure the stream ingest parameters as needed 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
Integrate Push SDK for Flutter. For more information, see SDK integration.
Configure the stream ingest parameters and start the stream ingest as needed. For more information, see Feature Usage.
Push SDK for Web
Integrate Push SDK for Web. For more information, see Integrate the co-streaming 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
For information about stream management, see Manage streams.