Live SDKs Android v1
Live SDKs Android
Live SDKs
Android
Version 1

Overview

Copy link

Sendbird Live SDK for Android offers a variety of functionalities for hosting and watching live events. A live event can have up to six co-hosts and, as a live event's host, users can create and share their media stream, and use an open channel to communicate with other users watching the live event. Users can enter a live event as participants as well to watch the live event and use the chat to communicate with thea event's host as well as other users.


Live event

Copy link

Sendbird Live supports the following types of live events: LIVE_EVENT_FOR_VIDEO and LIVE_EVENT_FOR_AUDIO_ONLY. The type of event defines what features are supported in the live event. This type can't be changed once the live event has been created.

List of live event types

Copy link
TypeAudioVideoSize

LIVE_EVENT_FOR_VIDEO

O

O

Supports 30K+ participants

LIVE_EVENT_FOR_AUDIO_ONLY

O

X

Supports 100K+ participants

Live event states

Copy link

A live event on Sendbird Live can be in the following four states: CREATED, READY, ONGOING, and ENDED. At every state, a live event's hosts and participants can each perform a select number of actions pertaining to the live event.

StateHostParticipant

CREATED

A host has created the live event. They can enter and exit without ending the live event. In this state, the host can also start and stop streaming and configure media settings.

Participants can't enter the live event.

READY

Hosts are ready for participants to join. They can enter and exit without ending the live event. In this status, the host can also start and stop streaming and view their own media stream.

Participants can enter the live event and use the chat, but can't receive the host's media stream yet.

ONGOING

Hosts can turn on or off media stream, update live event information, and exit without ending live event.

Participants can receive the host's media stream and use the chat.

ENDED

Hosts can end the live event.

Participants are notified that the live event has ended.


All hosts in a live event have the authority to create, enter, start, and end the live event as well as share their media stream during the live event.

Functionalities for host

Copy link

The following is a list of functionalities available to hosts.

FunctionalityDescription

Create a live event

Creates a new live event.

Enter a live event

Enters a live event.

Check the settings of a live event

Configures media settings and can view media stream.

Change the state of a live event

Changes the live event status to ready to allow participants to enter the live event and use the chat without receiving the host's media stream.

Start a live event

Starts the live event to allow participants to receive the host's media stream.

Display the host view

Allows the host to view their own media stream.

Manage media during a live event

Manages media settings during the live event.

End a live event

Ends the live event.

Leave the live event temporarily

Leaves without ending the live event.

Manage custom items

Manages additional information about the live event stored as custom items.


Participant

Copy link

Users can watch a live event by entering the live event as participants. Participants can send messages to the chat, and leave at anytime during the live event.

Functionalities for participant

Copy link

The following is a list of functionalities available to participants.

FunctionalityDescription

List live events

Retrieves a list of all ongoing live events.

Enter a live event

Enters a live event.

Receive events on a live event

Participants can stay informed of any changes in the live event.

Leave a live event

Leaves the live event.