Stream pulling is the process of pulling live streams from third-party streaming URLs. You can use ApsaraVideo Live to process the pulled streams and distribute the streams over Alibaba Cloud CDN for acceleration. You can use stream pulling as an alternative to ingesting streams to ApsaraVideo Live.
Background information
- Regular stream pulling: specifies the start time and end time for stream pulling. ApsaraVideo Live pulls the streams during the specified period regardless of whether playback requests are sent.
- Triggered stream pulling: automatically triggers ApsaraVideo Live to pull live streams when the streaming URL of the specified domain name is used for streaming. When live streams are not played, ApsaraVideo Live does not pull live streams from the origin.
- If you want to pull the third-party live streams that are encoded in the H.265 format, submit a ticket.
- You cannot pull streams from IPv6 addresses.
Configure regular stream pulling
Configure triggered stream pulling
Modify the configurations of stream pulling
You can modify the configurations of stream pulling to handle unexpected situations where the origin is unavailable.
- Regular stream pulling
After you modify the configurations, streams are pulled again based on the modified configurations. Make sure that the modification does not affect any running business.
- Triggered stream pulling
- After you modify the configurations, existing playback requests follow the origin configurations before the modification, and new playback requests follow the modified origin configurations.
- If the AppName in Source URL parameter is specified when you configure stream pulling, you cannot leave this parameter empty when you modify the configurations.
Callback logic
- During stream ingest over Real-Time Messaging Protocol (RTMP), ApsaraVideo Live checks whether the stream ingest client closes the connection within 2 seconds after ApsaraVideo Live receives an OnPublish message. If the stream ingest client does not close the connection, ApsaraVideo Live sends a callback notification about the successful stream ingest. You may require ApsaraVideo Live to send this callback notification only when ApsaraVideo Live receives live streaming data after the connection is established. In this case, submit a ticket.
- For example, you have Ingest Domain A and Streaming Domain B, and you use the stream pulling feature for live streaming under Streaming Domain B. You can configure ApsaraVideo Live to pull a stream at the specified point in time, or enable ApsaraVideo Live to automatically pull a stream when the origin server starts live streaming. If you want to receive a callback notification about the stream pulling status, configure stream ingest callbacks for Ingest Domain A. After the configuration, ApsaraVideo Live uses the same callback logic as that for stream ingest status to send callback notifications about the stream pulling status under Streaming Domain B. By default, ApsaraVideo Live sends a callback notification about successful stream pulling if the stream pulling client does not close the connection within 2 seconds after the connection is established. If you require ApsaraVideo Live to send this callback notification only when live streaming data is received, submit a ticket.