Skip to main content

You are viewing Agora Docs forBetaproducts and features. Switch to Docs

You are looking at Interactive Live Streaming v3.x Docs. The newest version is  Interactive Live Streaming 4.x

Android
iOS
macOS
Windows C++
Windows C#
Unity
Flutter
React Native
Electron
Cocos Creator
Cocos2d-x

Interactive Live Streaming Overview

Sunset plan

This section provides sunset plans for the Agora Video SDK v3.x. You should prepare to replace or upgrade affected solutions in a timely fashion to avoid service disruptions.

VersionDateMilestone
All 3.x versions14th March 2023We will no longer offer version 3.x of our Video and Voice SDK to new customers.
All 3.x versions14th March 2023 - 14th September 2024We will support existing implementations of 3.x with bug fixes and critical security updates.
Versions earlier than 3.2.014th June 2024Service shutdown. Customers won't be able to use these versions and will need to migrate to later versions to continue using Agora.
Version 3.2.0 and above14th September 2024We will stop supporting version 3.x.

Overview

Agora Interactive Live Streaming Premium and Standard enables one-to-many and many-to-many audio or video live streaming with the Agora Video SDK.

Agora Interactive Live Streaming is different from Agora Video Call. In a video call, all users are the same role and can talk to each other freely. In an interactive live streaming, users can be the host or audience, where only the host can talk. For details, see this FAQ.

Different from the traditional CDN live broadcast, which only allows one-way communication from the hosts to the audience, the Agora Video SDK empowers the audience to interact with the hosts by becoming a host, like a viewer jumping onto the stage in the middle of a play to perform.

Live streaming solution comparison

The following table shows the differences between Agora live streaming products and traditional CDN live streaming:

Agora Interactive Live Streaming PremiumAgora Interactive Live Streaming StandardTraditional CDN live streaming
Typical scenariosLive streaming events where the host(s) and audience have frequent audio and video interactions that require ultra-low latency on the audiences' clients.Live streaming events where the host(s) must be able to respond quickly to the audience's text messages, comments, and virtual rewards or that require less frequent audio and video interactions.Live streaming events that do not require audio or video interactions.
Latency
  • Latency from one host to another host: < 400 ms
  • Latency on the audience's client: 400 ms - 800 ms
  • Latency on the audience's client: 1500 ms - 2000 msLatency on the audience's client: > 3000 ms
    Synchronization
  • Excellent synchronization between the host(s) and the audience
  • Excellent synchronization among the audience
  • Good synchronization between the host(s) and the audience
  • Good synchronization among the audience
  • Poor synchronization between the host(s) and the audience
  • Poor synchronization among the audience
  • Interactive experienceExcellentGoodPoor
    PricingHighModerateLow
    • A host‘s client refers to the client that calls an API to set the user role as host. An audience's client refers to the client that calls an API to set the user role as audience. A host can both send and receive streams, while an audience member can only receive streams.
    • The latency between host's clients in Interactive Live Streaming Standard is the same as that in Interactive Live Streaming Premium, while the latency level on the audience's client in these two products is different:
      • Interactive Live Streaming Standard: Low latency (1500 ms - 2000 ms) from the host's client to the audience's client.
      • Interactive Live Streaming Premium: Ultra-low latency (400 ms - 800 ms) from the host's client to the audience's client.
    • You can switch seamlessly between Interactive Live Streaming Standard and Interactive Live Streaming Premium by calling setClientRole and setting the latency level as low on the audience's client.

    Functions and scenarios (Premium)

    Agora Interactive Live Streaming Premium boasts a flexible combination of functions for different scenarios.

    FunctionDescriptionScenario
    Co-hosting in a channelAn audience switches to a co-host and interacts with the existing host.
  • Large-scale live streams where hosts can invite the audience to interact with them.
  • Online games such as Murder Mystery and Werewolf Killing.
  • Co-hosting across channelsHosts interact with each other across channels.PK Hosting.
    Audio mixingSends the local and online audio with the user's voice to other audience members in the channel.
  • Online KTV.
  • Interactive music classes for children.
  • Screen sharingHosts share their screens with the audience in the channel. Supports specifying which screen or which window to share, and supports specifying the sharing region.
  • Interactive online classes.
  • Live streaming of gaming hosts.
  • Basic image enhancementSets basic beauty effects, including skin smoothening, whitening, and cheek blushing.Image enhancement in a video call.
    Modify the raw dataDevelopers obtain and modify the raw voice or video data of the SDK engine to create special effects, such as a voice change.
  • To change the voice in an online voice chatroom.
  • Image enhancement in a live stream.
  • Customize the video source and rendererUsers process videos (from self-built cameras, screen sharing, or files) for image enhancement and filtering.
  • To use a customized image enhancement library or pre-processing library.
  • To customize the application's built-in image and video modules.
  • To use other video sources, such as a recorded video.
  • To provide flexible device management for exclusive video capture devices to avoid conflicts with other services.
  • Push streams to the CDNSends the audio and video of your channel to other RTMP servers through the CDN:
  • Starts or stops publishing at any time.
  • Adds or removes an address while continuously publishing the stream.
  • Adjusts the picture-in-picture layout.
  • To send a live stream to WeChat or Weibo.
  • To allow more people to watch the live stream when the number of audience members in the channel reached the limit.
  • Temporarily, the Agora Video Calling Web SDK does not support modifying the raw data.

    See the following sample code for application scenarios:

    Functions and scenarios (Standard)

    Together with the Agora Signaling SDK, Interactive Live Streaming Standard enables you to implement the following live streaming scenarios:

    ScenarioDescription
    Lecture HallIn a large online class, the low latency of Interactive Live Streaming Standard allows the teacher's audio and video to be quickly synchronized to the clients of thousands of students. The low latency between the audio and video of the teacher and the courseware makes real-time teaching more effective. Students can interact with the teacher through text messages, online quizzes, and similar means to enhance the learning experience.
    ShowroomIn a showroom live streaming, the audience can send virtual gifts to the host. Thanks to the low latency of Interactive Live Streaming Standard, the host can promptly thank the audience for their gifts, and the audience can receive the host's thanks in a timely fashion, which helps to strengthen the emotional connection on both sides.
    Live-stream ShoppingIn a live-stream shopping scenario, customers can ask sellers for product and activity information via real-time messages. The low latency of Interactive Live Streaming Standard allows sellers to quickly respond to customers' questions, and customers can promptly see sellers' answers, thus encouraging transactions. In addition, the high synchronization of Interactive Live Streaming Standard ensures a consistent experience on the audiences' clients for activities such as responding to flash sales, and grabbing time-sensitive offers (seckilling) and coupons.
    Live match streamingLive streaming sporting events or games in real time, synchronized so that there are no problematic delays.
    Trivia GameApart from providing a smooth live streaming experience, the high synchronization of Interactive Live Streaming Standard also ensures that players receive the questions at the same time. This gives the audience members the same amount of time to answer—and an equal chance to win.

    Interactive Live Streaming Standard boasts a flexible combination of functions for different scenarios.

    FunctionDescription
    Single HostLow-latency live streaming by one host. The audience can join the channel and watch the live streaming.
    Becoming a hostAn audience member can switch their user role and become a host. Then they can interact with other hosts via audio and video.
    Co-hosting across channelsHosts interact with each other across channels.
    Audio mixingHosts combine the audio of a local or online file with their own voice, and then send it out in the channel.
    Basic image enhancementSets basic beauty effects in a video call, including skin smoothening, whitening, and cheek blushing.
    Screen sharingHosts share their screens with the audience in the channel. Supports sharing the whole or part of a window or screen.
    Modify the raw dataDevelopers obtain and modify the raw voice or video data of the SDK engine to create special effects, such as voice-changing effects.
    Customize the video source and rendererUsers process videos (from self-built cameras, screen sharing, or files) for image enhancement and filtering.
    Push streams to the CDNThe host publishes the audio and video in the channel to the CDN (Content Delivery Network):
    • Starts or stops publishing at any time.
    • Adds or removes an address while continuously publishing the stream.
    • Adjusts the picture-in-picture layout.
    Temporarily, the Agora Video Calling Web SDK does not support modifying the raw data.

    Key properties

    PropertyAgora specifications (Premium)Agora specifications (Standard)
    SDK package size4.61 MB to 13.94 MB4.61 MB to 13.94 MB
    Host capacity17 usersUp to 17 users
    Latency on the audience's client400 ms to 800 ms1500 ms - 2000 ms
    Audience capacityOne million usersUp to one million users
    Video profile
  • SDK video source: Up to 1080p @ 60fps.
  • Custom video source: Up to 4K
  • SDK video source: Up to 1080p @ 60 fps.
  • Custom video source: Up to 4K resolution.
  • Audio profile
  • Sample rate: 16 kHz to 48 kHz.
  • Support for mono and stereo sound
  • Sample rate: 16 kHz to 48 kHz.
  • Support for mono and stereo sound.
  • Audio anti-packet-loss rate80% (uplink and downlink)70% (uplink and downlink)

    Compatibility

    Agora Interactive Live Streaming Premium is supported on platforms such as iOS, Android, Windows, macOS, Electron, Unity, and Web, and allows for cross-platform connections. The following is a list of supported platforms and their versions.

    PlatformSupported Version
    Android≥ 4.1
    The Android SDK supports the following ABIs:
  • armeabi-v7a
  • arm64-v8a
  • x86
  • x86-64
  • iOS≥ 9.0
    Windows≥ Windows 7
    The Windows SDK supports the following architecture:
  • x86
  • x86-64
  • macOS≥ 10.10
    The macOS SDK supports the following architecture:
  • x86-64
  • arm64
  • Unity≥ 2017
    The Unity SDK supports the following platforms:
    • Android (armeabi-v7a, arm64-v8a, x86)
    • iOS
    • Windows (x86, x86-64)
    • macOS
    WebSee Web SDK Compatibility)
    Electron≥ Electron 1.8.3
    Flutter≥ Flutter 1.0.0
    React Native≥ React Native 0.59.10

    Interactive Live Streaming