Starting a broadcast
To start a broadcast:
- Get a server address and broadcast key.
- Configure broadcasting software.
- Start your broadcast.
- Check if the broadcast is available.
Get a server address and broadcast key
-
Open the Cloud Video home page
. -
Select a channel.
-
In the
Broadcasts tab, select the broadcast you need. -
In the stream settings window that opens, copy the following field values:
- Server address
- Broadcast key.
Use the get REST API method for the StreamLine resource or the StreamLineService/Get gRPC API call.
Use the getStreamKey REST API method for the StreamLine resource or the StreamLineService/GetStreamKey gRPC API call.
Configure broadcasting software
You will need a video recording and streaming program, such as Open Broadcaster Software (OBS)
In the program, specify Broadcast key and Server address received earlier and start your broadcast.
OBS configuration example
-
In the right-hand panel, go to Controls → Settings → Stream.
-
In the Destination section:
- In the Service field, select Custom....
- In the Server field, specify the server address you got earlier.
- In the Stream Key field, specify the broadcast key you got earlier.
-
In the left-hand panel, select Output → Stream.
- Under Video Bitrate, set a value based on screen resolution and internet speed. You can measure your internet speed using Yandex.Internetometer
. Your stream bitrate must not exceed the Outgoing connection value. - In the Video Encoder field, select the video encoding format.
- Under Video Bitrate, set a value based on screen resolution and internet speed. You can measure your internet speed using Yandex.Internetometer
-
In the Recording section:
- In the Recording Path field, specify the path to save your stream to.
- In the Recording Format field, select the video file format.
-
Click OK.
-
In the Sources panel at the bottom left, click
to add a source.- In the window that opens, select a source, e.g., Video Capture Device.
- In the window that opens, specify the source name and click OK.
- Select the video streaming device, e.g., a webcam, and click OK.
-
In the center of the window, you can set the size and position of the video stream.
For more information, see OBS Studio setup recommendations.
Start your broadcast
- Go back to the
Broadcasts tab in Cloud Video. - Select the broadcast you created earlier.
- Enable Accept signal.
- In OBS Studio, click Start broadcast in the bottom-right Controls panel.
- In the Publish broadcast field, wait for the
Publish broadcast button to become active and click it. If the field is set toautomatically, no further actions are required.
Use the performAction REST API method for the Stream resource or the StreamService/PerformAction gRPC API call.
The service limits the duration and number of simultaneous broadcasts.
Check if the broadcast is available
- Under Episodes, select the broadcast episode with the
On airstatus. - On the episode page, open the
linktab. - Click
Copy. - Open a new browser page and paste the obtained URL to the address bar.
- Click the play button to make sure the broadcast is available.
Use the getPlayerURL REST API method for the Episode resource or the EpisodeService/GetPlayerURL gRPC API call.