Media Editor Reference

Choose your OS:

When opening a Media Player asset, the Media Editor window will open presenting you with options for playing back and controlling different aspects of your Media Source assets. In the Media Editor, you can define the player Plug-in used for a Media Source, select between different audio/video tracks (if applicable) as well as define settings for the Media Player itself. The Info tab inside this editor will also display information about the type of media you are accessing which can be used to debug any potential playback problems. Please refer to each of the sections below for more information and a breakdown of the available options.

Toolbar

Toolbar.png

The Toolbar section of the Media Editor enables you to control the playback of media.

You must first select a valid Media Source from the Media Library window that you want to play for the playback options to become available.

Option

Description

toolbar_1.png

Saves this Media Player asset (Ctrl+S).

toolbar_2.png

Browse to the Media Player asset in the Content Browser (Ctrl+B).

toolbar_3.png

Jump to previous item in the Playlist.

toolbar_4.png

Rewind the media source to the beginning.

toolbar_5.png

Reverse playback of the selected media (clicking multiple times increases the seek speed).

toolbar_6.png

Start/Resume media playback.

toolbar_7.png

Pause media playback.

toolbar_8.png

Fast forward media playback (clicking multiple times increases the seek speed).

toolbar_9.png

Jump to the next item in the Playlist.

toolbar_10.png

Close the currently opened media.

Player Window

Player.png

The Player Window enables you to view the playback of your media as well as define Playback Options. When you open a Media Source and mouse over this window, you will see text overlays that display the name of the file (upper-left), the current player Plug-in being used (upper-right), the state of the media (lower-left), and the current horizontal, vertical fields of view and view rotation (lower-right), which is used for 360 videos.

As of engine 4.18, there are no player plugins that support 360 videos however future iterations of the Media Framework tools will provide more support for them.

At the top of the Player Window, there is a text field that displays the URL path (which you can use to Open directly in Blueprint with the Open URL Blueprint node). To the right of the URL field, a reload button can be used to reload the current media (similar to pressing the reload button on most web browsers and can be used to reload external URLs that link to the Internet). To the left of the URL field, via the drop-down menu, are the Capture Devices options.

Capture Devices

CaptureDevices.png

The Capture Devices menu and options are available when you have a connected and supported device attached to your computer. These options enable you to test different audio and capture devices where the URL will update with the selected device. Capture Devices are slightly different the other Media Sources in that you can have multiple devices connected. You can use Blueprint (or C++) code to enumerate and filter for specific devices.

Enumerate.png

Above, in a Blueprint, you can search for enumerate or capture devices to see the list of optional enumerators.

In the example below, a sample setup using the Enumerate Video Capture Devices node is shown to filter for specified devices that we can use to obtain the URL to open.

EnumerateExample.png

Please see the Playing Live Video CapturesNEW! page for more information.

Playback Options

PlaybackOptions.png

Also part of the Player Window is the Playback Options menu that contains several different options used to define how your media is played.

Player

Option

Description

Decoder

This section enables you to define the player Plug-in used for media. Automatic is the default setting which will auto-select the appropriate player Plug-in based on the type of media.

Tracks

Option

Description

Audio

Enables you to set the default audio track associated with a media source (if multiple audio tracks are embedded with the media) or disable the audio track.

Captions

Enables you to define the default caption track for a selected media source (if tracks are embedded with the media).

Subtitles

Enables you to define the default subtitles track for a selected media source (if tracks are embedded with the media).

Text

Enables you to define the default text track for a selected media source (if tracks are embedded with the media).

Video

Enables you to set the default video track associated with a media source (if multiple video tracks are embedded with the media) or disable the video track.

Formats

Option

Description

Audio

Displays the available audio format tracks which you can select from (if applicable).

Captions

Displays the available caption format tracks which you can select from (if applicable).

Subtitles

Displays the available subtitle format tracks which you can select from (if applicable).

Text

Displays the available text format tracks which you can select from (if applicable).

Video

Displays the available video format tracks which you can select from (if applicable).

View

Option

Description

Scale

Change the video size to Fit (fit video in the Player Window), Fill (fill video in the Player Window) or Original Size (to use the original dimensions of the video).

Show Text Overlays

Toggles the display of any associated overlay assets with the selected media.

Media Library

MediaLibrary.png

The Media Library displays all of the Media Source assets within your project that you can open in the Media Editor. You can right-click on a source in this window to open up a context menu that you can use to edit the asset, open in the Media Editor, browse to the asset in the Content Browser or show the location of the Media File on your computer. This window also displays the type of each Media Source as well as their associated URL string.

Playlist

Playlist.png

The Playlist section of the Media Editor not only displays all of the files contained within a Media Playlist but also enables you to create/save new Media Playlists assets inside your project. The arrows in the upper-right corner of the Playlist window function similar to the Toolbar's Prev and Next buttons and enable you to cycle through Media Sources in your playlist.

ActiveMediaPlaylist.png

Above, an active Media Playlist displays each of the Media Sources contained within it with the arrow marker pointing to the currently playing source.

Each Media Source (when active) has a local Media Playlist created inside the Media Editor. You can save the local Media Playlist as a new Media Playlist by clicking the Save icon.

UnsavedPlaylist.png

As of engine 4.18, there currently is no way to add Media Sources to a local Media Playlist, however, support slated for updates in future engine releases.

Details / Info

Details.png

The Details panel provides options for controlling playback of the Media Player itself.

Playback

Option

Description

Play on Open

When enabled will automatically start to play a Media Source when opening the source through Blueprint or C++.

Shuffle

When a Playlist is opened, if this option is enabled, the player will randomly select a source within the playlist rather than playback sequentially.

Loop

When enabled will loop a single Media Source or entire Media Playlist (looping Video Capture devices is not supported).

View Settings

Option

Description

Horizontal Field of View

Enables you to manually set the Horizontal FOV value for 360 videos.

Vertical Field of View

Enables you to manually set the Vertical FOV value for 360 videos.

View Rotation

Enables you to manually set the View Rotation for 360 videos.

As cited in the Player Window section, version 4.18 does not support 360 videos. Future iterations of the Media Framework tools however will provide support for them.

Info Panel

InfoPanel.png

The Info panel provides information about the selected Media Source that you can use for debugging purposes. This window displays the player Plug-in associated with the file, the number of video and audio streams and information about video and audio tracks such as the codec being used, sample rate and dimensions.

Any errors when trying to playback video will be displayed here, for example, if you attempt to load an unsupported format, it will list it in this window as Not supported. Additionally, you can use the Copy to Clipboard button to copy this information out which you can use to post to our official forums or Answer Hub pages to get help with and troubleshoot any playback issues.