Video Streaming
Streaming videos with Uiza is pretty straightforward where the whole process could be summarized in 4 simple steps:
You give us the video,
You allow us to publish the video,
We let you know when your video is published, and
Step 1: Create a video entity
You can create a video_entity
using HTTP/HTTPS URL links to your original video files. In case the video file is located in your PC, you can upload the video via the Uiza Developer Console by following these steps:
Login to Uiza Developer Console
Start your application, then go to Upload Video page
Browse to your local video file or enter multiple HTTP/HTTPS URLs
Click Proceed to start uploading your selected video files
Successfully uploaded video_entities
will be ingested and listed out in the Developer Console. To transcode the video, click on "Publish" or move to step 2.
Go to Entities page and select created video entity for checking id
and other details.
Step 2: Publish the video entity
The renditions of your video, as the output of transcoding, will be distributed to Uiza's Content Delivery Network (CDN) through which it is delivered to viewers.
To let Uiza know that you are ready to publish your video to your viewers, you can use Uiza Developer Console or send a request to Publish a video entity API.
/v1/video_entities/:id/publish
POST
https://api.uiza.sh/v1/video_entities/:id/publish
Path Parameters
Step 3: Retrieve the video entity's information
The process of transferring the renditions of your video to Uiza's CDN takes time. You player can only start playing the video after it has been successfully published. To keep track of this process, retrieve the video entity's information. The publish_to_cdn
argument indicates the publishing status of your video entity. If the value is success
, you are good to go.
/v1/video_entities/:id
GET
https://api.uiza.sh/v1/video_entities/:id
Path Parameters
Step 4: Configure the playback link to your player and start streaming!
Three playback links are returned in the response of Step 3. These playback links represent the 3 streaming protocols that Uiza currently supports:
hls
for HLS fMP4 streaming,hls_ts
for HLS ts streaming, andmpd
for MPEG-dash streaming.
Last updated