Supporting Multiple Media Configurations

If you've followed the Quick Start guide for working with AJA Media or Blackmagic Design hardware, you've seen one possible way to set up Media Input and Media Capture Assets to get SDI video feeds in and out of your Project.

However, you often need a single Project to work with multiple different media configurations. For example:

• You may need to work with the Project on different computers, each of which has different hardware or a different wiring setup. For example, one computer might have an AJA card while another has a Blackmagic card; or the video feed that is connected to port 1 on one computer might be wired to port 2 on the other computer.
• You may need to be able to switch your Project on one computer between different kinds of sources and outputs. For example, you may want to work with live feeds coming in over the SDI connections, but switch to using pre-recorded files on disk as inputs when the feed is offline.
• You may also need to change the way the Unreal Engine reads timecode and genlocks its frame rate, especially  when you change to different sources or inputs. For example, you may want to lock the Unreal Engine's frame rate only when using input feeds coming in over SDI connections. 

In cases like these, you don't want to have to make deep changes in your media setup and Project content every time you switch setups. Instead, you can set up multiple Media Profiles, each of which gathers together all configuration settings related to media inputs, outputs, timecode providers, and genlock providers. By simply switching to a different Media Profile, you can immediately change your entire media I/O setup.

How Media Profiles and Proxies Work

Media Profiles rely on proxy Assets to make the connection between:

• the input and output configurations that you set up in the Media Profile, and
• the places that those inputs and outputs are consumed or generated in your Project content.

Click for full image.

The following list illustrates the numbered sections in the image above:

1. You set up multiple Media Profiles in your Project: one for each usage scenario that your Project needs to support. Each profile contains a list of media sources and a list of media outputs. You set up these lists to determine where your Project will get video input from, and where it will send captures to.
   For example, you could set up one Profile to get inputs from an AJA Media card, another to get inputs from a Blackmagic Design card, and a third to get inputs from files on disk.
   You can also mix and match within a single Media Profile. For example, a single Media Profile could get inputs from both files and SDI feeds.
2. When you have the Media Framework Utilities Plugin installed, the Project Settings panel for your Project contains similar lists of inputs and outputs. Each numbered entry in the input list of the Media Profile matches up with the same number in the input list of the Project Settings, and the same goes for the output lists.
   You set up each of these list entries in the Project Settings to point to a Proxy Media Source or Proxy Media Asset that you create in your Project.
3. You then refer to these same Proxy Media Assets anytime you need to set up a Media Source or a Media Output in your Project content. For example:
   1. When you set up a Media Bundle or Media Player, you point it to one of those Media Proxy Assets instead of pointing it to a Media Source that directly represents a file, stream, or SDI input.
   2. Similarly, when you set up a Media Capture, you send the output to a Proxy Media Output instead of directly to an AJA or Blackmagic Media Output. You can do this in the Media Capture panel in the Unreal Editor as shown above, or when you invoke the Create Media Capture Blueprint node at runtime. If you've set up the output list in your Project Settings to contain a reference to the same Proxy Media Output, the capture is then forwarded on to the output with the matching index that you have configured in the Media Profile.

The Proxy Media Source and Proxy Media Output Assets don't contain any important configuration properties themselves. They only act as a mapping — a way to connect the input and output configurations set in the Media Profile with the places that those inputs and outputs are actually used or generated by other Assets elsewhere in the Project.

Selecting and Saving the Active Media Profile

Whenever your Project is loaded in the Unreal Engine or the Unreal Editor, it can have only one Media Profile active (or none at all).

When you have your Project open in the Unreal Editor, you choose which Media Profile you want to be active using the Media Profile menu in the Toolbar of the main Level Editor:

Media Profiles are Assets that are always saved in the Unreal Engine Project. However, the choice of which Media Profile is active is saved on each computer, not within the Project. That means that once you've set a Media Profile for a given Project on a given computer, you never have to change it again (unless your media hardware or configuration changes).

On the other hand, when you run a packaged version of your Project, the choice of which Media Profile is active is always determined by the Startup Media Profile setting, which you'll find in the Project Settings window under Plugins > Media Profile.

Getting Started with Media Profiles and Proxies

In this procedure, we'll set up two Media Profiles: one that plays input from local movie files, and one that plays live video feeds from an SDI card. We'll set up two separate Media Bundles to play the videos in the Level. Finally, we'll use Proxy Media Sources to redirect the inputs from the sources configured in the Media Profiles on to the Media Bundles.

1. Start by creating a Proxy Media Source Asset. Right-click in the Content Browser and select Media > Proxy Media Source from the contextual menu.
   
   Name the new Asset VideoProxyInA.
2. Repeat the previous step to create another Proxy Media Source, but name it VideoProxyInB.
3. Create a new Media Bundle Asset. Right-click in the Content Browser and select Media > Media Bundle.
   Name the new Asset MediaBundleA.
4. Double-click the new Media Bundle Asset to edit it.
5. In the Details panel, find the Media Source setting and select Proxy Media Source from the drop-down list.
   
6. Expand the Source category, and set the Proxy to refer to the VideoProxyInA Asset that you created earlier.
   
7. Repeat the previous steps to create another Media Bundle. This time, name it MediaBundleB, and set its source proxy to refer to VideoProxyInB.
   The Asset names recommended here, like VideoProxyInA and MediaProfileA, are intended to help make the relationships between the various Assets clear. However, in your own Project, we recommend using names that are more descriptive of the kind of content that the Media Proxy and Media Bundle need to handle. These Asset names are visible in your configurations, and in places like the Media Capture window, so ideally they should be meaningful to the whole team working on your Project.
8. From the main menu, select Edit > Project Settings. Find the Plugins > Media Profile section, and expand the advanced options. 
   
9. Add two entries to the Media Source Proxy list. Set one to refer to VideoProxyInA, and one to refer to VideoProxyInB.
   
10. Now, we'll create a new Media Profile named FileProfile that plays videos from files on disk. You can do this in either of two ways:
    • Right-click in the Content Browser and select Media > Media Profile from the contextual menu, then rename the Asset.
      
    • From the profile selection button in the Toolbar, select Create New Media Profile and set the path and name for the new Asset.
      
11. Double-click the new Media Profile to edit it, if it doesn't open for editing automatically.
    Find the Media Sources setting, and add two new elements to the list. Set each entry in the list to be a File Media Source, and set a different File Path for each. 
    
    
    If you need some sample videos to test with, you can use these: Video1 | Video2
12. Repeat the previous steps to create a second Media Profile, named LiveFeedProfile, that brings video in from the AJA or Blackmagic device connected your computer. For example:
    Each Media Profile also offers you the ability to set a Timecode Provider and a Genlock Provider:
    
    These have exactly the same effect as the TimecodeProvider and Custom TimeStep settings offered in the Project Settings panel. However, when you set these values in a Media Profile, they override the Project Settings only when that Media Profile is active. For more information, see Timecode and Genlock.
13. Use the profile selection button in the Toolbar to select the FileMediaProfile that you created above.
    
14. Drag and drop your two Media Bundles into your Level Viewport. You should see them begin showing the videos loaded from the files or incoming over the SDI connections.
    
15. Now you can use the Media Profile selection tool in the Toolbar to switch between your two Media Profiles easily, changing your Media Sources (and, optionally, your timecode and genlock settings) in one click.
    

Using Proxy Media Outputs

In this procedure, we'll extend the Media Profile setup we created in the previous section to add support for routing video captured from the Unreal Editor or Unreal Engine at runtime through a Proxy Media Output to an output configuration defined in the Media Profile. The overall process is very similar to setting up media sources: you create a Proxy Asset, update the Project Settings to refer to the Proxy, and configure the actual output device in the Media Profile.

1. Start by creating a Proxy Media Output Asset. Right-click in the Content Browser and select Media > Proxy Media Output from the contextual menu.
   
   Name the new Asset VideoProxyOut.
2. From the main menu, select Edit > Project Settings. Find the Plugins > Media Profile section, and expand the advanced options.
   
3. Add an entry to the Media Output Proxy list, and set its output proxy to point to VideoProxyOut.
   
   
4. Double-click the LiveFeedProfile you created in the previous section, and add a new entry to the Media Outputs list. Set it up to send the video feed to a port on the AJA or Blackmagic device connected to your computer.
   
5. From the main menu, choose Window > Media Capture.
6. Add a new entry to the Viewport Captures list if needed, and set its Media Output setting to point to your VideoProxyOut Asset.
   
7. Click Capture to start capturing the feed and sending it through the proxy to your AJA or Blackmagic device. 
    
   If you switch the current Media Profile at this point to the FileVideoProfile, the capture stops, because the FileVideoProfile does not have an output configured for entry 0 in its Media Outputs list.
8. To capture the video feed at runtime and send it through the Proxy, you do it exactly as instructed in the Quick Start Guide for AJA Media or Blackmagic Design hardware.
   The only difference is that instead of using a variable that is an Object Reference to an AjaMediaOutput or BlackmagicMediaOutput, you use an Object Reference to the ProxyMediaOutput that you want to send the captures to. You then use this ProxyMediaOutput variable as the input to the Create Media Capture node. For example:
   

End Result

You now have two different Media Profiles set up, each with its own configuration of input and output feeds. Each uses Media Proxy Assets to map those input and output configurations to the other Media Framework Assets that consume or produce those video feeds. This example configuration might not match your exact usage scenario. However, having walked through the steps to set it up, you should have a good idea of how to extend the same basic functionality to meet your own needs.