Documentation
Interactive Live Streaming Premium (Legacy)
Console 官网 Community Technical support
English
search-icon

Media Pull Overview

Last updated 2022/09/30 02:27:07

Media Pull is the action of adding an external audio or video stream to an ongoing live-broadcast channel. It enables the hosts and audience in the channel to see and hear the additional stream while interacting with each other in real time.

Agora provides RESTful APIs for Media Pull, including the following:

  • Media Pull RESTful API: Sends an HTTPS request to the Agora server through your business server.
  • Media Pull event callbacks: After the Agora message notification service is activated, when a subscribed event occurs, the Agora server will send a notification to your server in the form of an HTTPS request.

Functions

The following table describes the main features of using this function:

Function Description
Injecting an online media stream The Media Pull RESTful API enables you to add an online media stream into the Agora channel as a live video source. After the injection succeeds, the online media stream automatically plays in the Agora channel, and remote users can see the content of the media stream.
Support for multiple media formats and streaming protocols The following formats/protocols are supported:
  • Video codec formats: H.264, H.265, and VP8
  • Audio codec formats: AAC and OPUS
  • Container formats: FLV, MP4, MP3, MPEG-TS, Matroska (MKV), and HLS
  • Protocols: HTTP, HTTPS, and RTMP
    		•
    Timed media stream injection Users can control when to start playing the injected media stream to coordinate timed media stream playback.
    Geofencing Users can specify the region from which to play the injected media stream to ensure transmission quality.

    Scenarios

    Media Pull is well suitable for the following scenarios:

    Scenario Description
    Live sports The host and audience watch sporting events together, and the host provides live commentary and responds to audience input.
    Watch the video together The host and audience participate in real-time discussion while watching an artistic performance.
    Pseudo-interactive live streaming The host presents material or shares commentary with the audience that has been recorded ahead of the live broadcast.
    24-hour chat room Background music plays continuously in a 24-hour chat room. This music is not interrupted when hosts join or leave the chat.

    Features

    Feature Description
    High reliability Globally distributed cluster deployment to provides highly reliable services.Provide partition access function to ensure the quality of service and experience in each area. Controlling the injected media stream by region helps to ensure that users receive the best quality experience.
    Security compliance The real-time transmission of audio and video data is safe and secure. The system does not cache data or collect personal information from users. For details, please refer to Information Security Policy.
    Stable and easy to use The API is simple and easy to use, which enables developers to integrate it quickly.