StreamHub accounts can be connected directly to LIVE to handle your video routing. Because input feeds can vary wildly, this integration creates a smooth, two-step workflow:
- Ingest and Encode: StreamHub is used to ingest and distribute various video formats, which are then standardized or encoded into compatible outputs to be ingested by LIVE.
- Select in LIVE: LIVE does not manage raw routing; instead, it securely ingests the standardized outputs made available by StreamHub.
Note: You can launch StreamHub from inside LIVE at any time to adjust your input routing or Output configuration
1. Connecting to StreamHub
Prerequisites:
- An active Haivision StreamHub account.
- Your StreamHub URL and API Key.
Before selecting a source, you must establish a secure connection between LIVE and your StreamHub account.
- Navigate to Settings > Video Input.
- Click the StreamHub icon in the top navigation bar.
- Click the StreamHub Connection button.
- Enter your StreamHub URL. And Port Number: 8896
Important: You must use the secure HTTPS protocol (e.g., https://34.255.189.55:8896). - Enter your StreamHub API Key. This can be found in your StreamHub Account when you log in as admin. Select Admin > REST API Doc and copy the key from the top right of the screen
- Click Connect.
- Verify that the Connection Status displays a green Active indicator. Your credentials will now be remembered for future sessions.
2. Configuring StreamHub Settings
For the integration to work correctly, specifically regarding audio transmission, you must configure your output settings directly within StreamHub.
- Log into your Haivision StreamHub dashboard.
- Navigate to the OUTPUTS Section
- Configure an existing StreamHub Output or create new
- In the output configuration, set the following parameters to ensure compatibility with LIVE:
- Name: Assign a clear, identifiable name (example: Wide Shot). This is the name that will appear in LIVE.
- Server Mode: Toggle this to Listener (SRT Listener).
- Bitrate: Toggle the bitrate mode to VBR (Variable Bit Rate).
Important: Do not use CBR (Constant Bit Rate). There is currently a known issue where using CBR will result in a video stream with no audio. This will be fixed in a later update.
3. Selecting Your Video Source
Once connected, your StreamHub outputs will become available in LIVE as video inputs.
Return to LIVE, Settings > Video Input:
- Select a Camera Input
- Click the Select source dropdown.
Note: It can take up to 10 seconds for the to receive the available sources from StreamHub. - Select your desired StreamHub Output (e.g. Wide Shot or CAM1_Output) from the list.
The input will appear in LIVE within a few seconds
4. Starting and Stopping the Stream
You can control the stream Start/Stop directly from LIVE or via the StreamHub dashboard. If you start or stop the stream remotely from the StreamHub, the status in LIVE UI may not update immediately. To refresh and see the current live status, click a different menu tab (like Video Output) and then return to Video Input. You could also refresh the Browser tab.
To start or stop your stream, simply toggle the stream switch located in the Video Input Configuration panel
5. Adjusting Advanced Options (Latency and Bit Rate)
You can adjust the Minimum Latency and Expected Bit Rate for your stream from LIVE.
- Ensure the Stream is stopped
- Expand the Advanced Options menu under the Video Input Configuration panel.
- Enter your desired Minimum Latency (in milliseconds) and Expected Bit Rate (in Mbps).
- Hit Apply
Note: You must click the Apply button in the bottom right corner to save these changes. If you start the stream without clicking Apply, the values will revert to the previous values. Adjusting from LIVE will also update the values in StreamHub.