This article describes how to configure an RTMP upstream in Streamboxy and which encoder settings are required.
PrerequisitesProven upstream settings
Below we have compiled a list of proven settings for a good upstream result for you
|Stream URL/Server URL||Copy the Upstream URL from Streamboxy (see below)|
|Stream Key (Sometimes required by OBS or other encoders)||Default|
|Output resolution||1920 x 1080 alternatively 1280x720|
|Streaming Bitrate (Constant Bitrate - CBR)||6.000 Kbps (Your internet connection should provide at least the double upstream speed)|
|Keyframe Interval||2 sec|
|Framerate||max 30 Fps|
|Audio Bitrate||min 160 Kbps|
|Audio Sample Rate|
|Audio Codec||AAC-LC, HE-AACv1 or HE-AACv2|
Streaming Best Practices
- Use a wired connection if possible and make sure your connection has at least the double amount of upstream bandwidth of your planned streaming bitrate
- Check, especially in corporate networks if your Streaming Ports are not blocked by a firewall
- If you are using a software encoder, please close all other unnecessary programs
- Changing the encoder configuration once the stream was started can impact the Stream in a negative way. Reset the stream using the Streamboxy reset feature (described below) if you have changed encoder settings
- Test and validate new Encoder Hard- or Software versions before you use them in production. The Encoders described here, are not regularly checked for updates, etc.
- Monitor your Streaming Hardware resources (CPU, RAM, etc.), since encoding may exhaust your hardware resources
Stream execution and organization
Setting up, starting, and ending of Streams in Streamboxy
1. Gather the Upstream Key in Streamboxy
Open the Room for speaker
To Request a Livestream URL the Room must be opened for Speaker, this allows all Speaker or Admins to set Streaming settings and view the stream preview.
- Open the Streamboxy Stage as Speaker or Administrator and Navigate to the desired Breakout room with the Livestream
- Open the Session Administration Panel using the Tools Icon in the left navigation bar.
- Click on the Button "Open Room"
Requesting the Upstream URL
- Once the Room is open you can request the Upstream-URL using the "Request Upstream URL" Button.
Depending on the current system load this may take a few minutes to be provisioned.
- Once the Streaming environment is provisioned an Upstream URL appears, which you can add to your clipboard using the copy symbol right next to the URL textbox. You need this URL to configure your streaming encoder
2. Configure and Start your encoder using the upstream URL
You must now configure your encoder and start the stream in order to proceed in Streamboxy.
You can try everything in this tutorial using the Free Software Encoder OBS Studio.
How to use OBS with Streamboxy is described in this article.
Articles describing other encoders can be found here.
3. Check the Preview in Streamboxy
Once your encoder is configured and started, you should see the Stream preview.
The Preview is only visible to you and other speakers or admins, participants still see the waiting poster.
All Features of the Preview Player are identical to the features of the participant player, which is described here.
4. Start Livestream for participants and Recording
5. Ending the Livestream
We recommend ending the Streamboxy session prior to ending the stream in the Encoder. This ensures a better attendee experience and a controlled end of the recorded stream.
To end the Livestream in Streamboxy, click on the button "End Livestream for Attendees".
This ends the Stream for attendees and stops the recording.
8. After the Livestream
You can also permanently deactivate the session or reset the session to the stat planned, in case you accidentally closed the session.
Further Information regarding the user interface can be found here.
Detailed information about the session states and their implications can be found here.