A. Create a MediaLive RTMP Push input.
Set the Input Security Group
Set the Application Name and the Application Instance. The Application Instance is also called the Stream Key or Streaming Key
Press the Create button
The console will now display the endpoint(s) created for the input.
As an example set the Application Name to 'live' and the Application Instance to 'AtemPro_1'
You would see the RTMP input endpoint then defined as 'rtmp://<IP_Addr>:1935/live/AtemPro_1'
The stream URL used in the streaming.xml file will be the portion 'rtmp://<IP_Addr>:1935/live/', i.e. rtmp://Addr:Port/ApplicationName/
B. Edit the Atem Streaming.xml file.
- Locate the Streaming.XML file
- Mac location: /Library/Application Support/Blackmagic Design/Switchers/Streaming.XML
- Windows location: C:\Program Files (x86)\Blackmagic Design\Blackmagic ATEM Switchers\ATEM Software Control\Streaming.XML
- Make a copy of the Streaming.XML file, to ensure you have a backup to fall back on if you make a mistake.
- Open the file in a text editor and edit the parameters - see below for an example
- Save the document, and back it up — every time you update your ATEM software, this file will be overwritten
- Quit and relaunch the ATEM Software - this reloads the Streaming.xml file in to the switcher.
- Select the service that you just created, select the server that was created, select the appropriate quality, enter the streaming key, then start the MediaLive channel and then the stream.
Example Streaming.XML file:
<streaming>
<service>
<name>AWS MediaLive</name>
<servers>
<server>
<name>Primary</name>
<url>rtmp://<IP_Addr>:1935/live</url>
</server>
</servers>
<profiles>
<profile>
<name>Streaming 1080p30 6M Audio 128k</name>
<config resolution="1080p" fps="30">
<bitrate>6000000</bitrate>
<audio-bitrate>128000</audio-bitrate>
<keyframe-interval>2</keyframe-interval>
</config>
</profile>
<profile>
<name>Streaming 720p60 6M Audio 128k</name>
<config resolution="720p" fps="60">
<bitrate>6000000</bitrate>
<audio-bitrate>128000</audio-bitrate>
<keyframe-interval>2</keyframe-interval>
</config>
</profile>
</profiles>
</service>
</streaming>
You can define any number of profiles from which you can then select one for the specific event.
C. Configure the event.
Once the file has been edited and saved, simply restart the ATEM Software Control application, and select the Output Tab, then select the Platform, which in the example above is called "AWS MediaLive". Select the Server (Called Primary in the example), set the Stream Key to the Application Instance you defined when creating the MediaLive Input, and finally select the profile to be used.
To start streaming to MediaLive, either:
- press the ON AIR button (top right) on the ATEM Mini Pro
- click the ON AIR button on the software
If everything is correct, then the ON AIR button on the ATEM Mini Pro will go RED, and the software will show ON AIR, with the time code incrementing.
If any of the parameters are incorrect, say the key is invalid, then the ON AIR will flash, and the timecode will not increment.
Note that the MediaLive channel must be in the Running state before the RTMP session handshake can complete between the Atem and the MediaLive channel. Therefore, start the MediaLive channel, and once shown to be in the running state only then start streaming on the Atem.