Comment on page
live_entitycontains the information required for Uiza to successfully allocate resources to power the
live_entity's live broadcasting sessions. You can reuse a
live_entityand broadcast multiple live sessions sequentially.
The API allows you to create, delete, reset your
ingest.key, and update the
live_entity. Individual entities and a list of all your entities are retrievable via these APIs too.
idstringThe unique identifier for the live entity.
namestringThe name of your live entity. (limit 100 characters)
descriptionstringDescribes the content of the live entity. Often useful for displaying to viewers. You could update this accordingly to suit different sessions of a single live entity.
encoding_templatestringSpecify the template that our ingest server will process your stream source, from SD to Full-HD for the output singal. There are 4 values that Uiza currently support:
noneWe keep the output stream same as your source.
sdThe output contains 1 video profile with 480p resolution.
hdThe output contains 2 video profile with 480p and 720p resolutions.
fhdThe output contains 3 video profile with 480p, 720p, and 1080p resolutions.
ingestobjectContains the information required to access to Uiza's ingest servers. Use the
urlto configure your broadcasting software.
playbackobjectContains the playback URL for different streaming protocols including HLS fMP4 (
hls) and MPEG-dash (
mpd). Use this URL to configure your player to play the live stream.
regionstringThe geographical region where your live streams are broadcasted from. In case your region is not yet supported, try the nearest available one. Here are the regions that Uiza currently supports:
statusstringOnce the request to create a
live_entityis received, Uiza will allocate resources in the requested
region. While the process may take up to 1 minute, the
init. This will be updated to
readyonce resources are successfully allocated and to
broadcastingduring a broadcasting session.
dvrstringIndicates whether Digital Video Record (DVR) is enabled for the
live_entity. Set to
trueto enable and to
falseto disable this feature.
relayarrayA list of ingesting object contains the information required to access to 3rd ingest servers. Use the
urlto configure your broadcasting destination. Uiza will relay your signal to our server to list of ingest servers in