ApsaraVideo Live supports multiple stream ingest methods. You can use different devices to ingest streams for standard streaming and Real-Time Streaming (RTS) based on your business scenarios.
Prerequisites
For standard streaming: You have activated the service and generated ingest and streaming URLs. For more information, see Get started with ApsaraVideo Live.
For Real-Time Streaming (RTS): You have activated the live streaming service and generated ingest and streaming URLs. For more information, see Get started with RTS.
You have an ingest URL. For instructions, see Generate ingest and streaming URLs.
Standard stream ingest
Scenario 1: Ingest from a PC
To ingest streams from a PC, you can use Open Broadcaster Software (OBS). OBS is free and open-source software for video recording and live streaming that supports Windows, macOS, and Linux.
This topic uses OBS v27.2.3 for Windows as an example. The steps are similar for other versions and operating systems.
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 that is signed. Example:
rtmp://demo.aliyundoc.com/app/stream?auth_key=1543302081-0-0-9c6e7c8190c10bdfb3c0************.Stream Key
Leave this parameter empty.
Go to the homepage of OBS Studio. Find the Sources section, add a source, and then click Start Streaming.
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.
Scenario 2: Ingest from a mobile device
Use a mobile device to scan the QR code to download the Push SDK demo.
NoteIf you use an iOS device and receive a message indicating that the demo is from an untrusted enterprise developer, tap Settings > General > VPN & Device Management. On the page that appears, find the permissions required by Taobao and tap Trust.
Run the Push SDK demo.
Select Camera Pushing or Screen Sharing.
NoteOnly YUV files are allowed when you ingest local streams from a mobile device.
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.Click Start to start stream ingest.
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.
Scenario 3: Ingest using the Push SDK
Push SDK for iOS
Integrate Push SDK for iOS. For more information, see SDK integration.
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
Integrate Push SDK for Android. For more information, see SDK integration.
Configure the stream ingest parameters based on your business requirements and ingest a stream. 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.
RTS stream ingest
When you ingest streams for Real-Time Streaming (RTS), the required stream format depends on the scenario. Select the guide that matches your stream format and ingest client.
Scenario 1: PC ingest with OBS
For more information, see Ingest streams by using OBS.
Scenario 2: RTS ingest from a browser
Go to the RTS Web Player.
Click the Stream Ingest tab.
Expand the none drop-down list and select camera or screen (screen sharing).
If you select camera, click Get devices below the page. In the pop-up window, grant permission to access the microphone and camera. After granting permissions, expand the Select Microphone and Select Camera drop-down lists and select the corresponding devices.
Click Create Local Stream.
Enter the generated RTS-formatted ingest URL. Example:
artc://example.aliyundoc.com/liveApp****/liveStream****?auth_key=1543302081-0-0-9c6e7c8190c10bdfb3c0****.Click Start.
Scenario 3: RTS ingest using the Push SDK
To ingest an RTS-formatted stream by using the Push SDK, follow the same procedure as for an RTMP-formatted stream. The only difference is that you must provide an RTS-formatted ingest URL when you call the startPush method. No other code changes are required.
Push SDK for iOS
Integrate Push SDK for iOS. For more information, see SDK integration.
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
Integrate Push SDK for Android. For more information, see SDK integration.
Configure the stream ingest parameters based on your business requirements and ingest a stream. 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.