Component: Media

Introduction

All video content used throughout the MediaStorm Platform start as a piece of Media. Media is a container made up of one or more encodes of a video and, optionally, the Master video file. This approach allows you present Media (via its various encodes) for optimal playback experiences on a variety of devices and connections. You can also create new encodes via its Master file at any point in the future.

There are three different methods for creating a piece of Media:

  1. Encode from a Master: Use the Platform to encode a file you've uploaded and assigned as a Master file.
    This is the recommended method, and is ideal for most situations. This method also allows you to store a Master file in the cloud as a backup and can be used to encode your file again in the future as encoding requirements evolve.

  2. Encode manually: Encode the file yourself by following the MediaStorm guidelines, and upload that encoded file to the Platform.
    This is only suggested if you have very specific encoding needs and are comfortable encoding video yourself.

  3. Link to Vimeo files: Link to the files in your Vimeo account.
    Note: This feature is in beta and is not available to all users.

For the first two methods, you will usually begin by uploading video files, detailed in the next step. If you're linking to content from your Vimeo account, you'll want to skip ahead to the Building your Media section.

Uploading files

To get started, you'll first want to upload your video file(s) by clicking Upload files on the Media page. This will open a file uploader window, where you can add and upload one or more files. There is no distinction at this point between your encoded web-ready files and your hi res Master files & that distinction is made later as you're building out your Media from these files.

Screen_Shot_2015-06-01_at_11.31.27_AM.png

 

Building your Media

Once you have files to work with, you can begin creating your Media.

Clicking the 'New Media' button on the Media page will spawn a dialog, where you can give your new Media a name during its creation. Note that this name is for internal organization purposes only.

Screen_Shot_2015-06-01_at_11.32.05_AM.png

 

Once created, you will be taken to a page to edit this new Media, where you can add the files you uploaded previously as a Master file or one or more encodes. You can also link your Vimeo encoded files for this Media (note this feature is in beta and not available to all platform users).

Screen_Shot_2015-06-01_at_11.32.41_AM.png

 

Master file

Adding a Master

The Master file for a piece of Media is the file that all encodes will be created from. It can be nearly any common type of video file (.mov, .mp4, .avi, etc.), and should be the highest-quality version of a video you have available. Adding a Master file to a piece of Media is optional but highly recommended.

To add a Master, click the Add master button. A dialog will appear allowing you to select which of your previously-uploaded video files should be used as the Master for this piece of Media. Click the Choose a file dropdown, select from the list of unassociated files, and click the Add master button.

Screen_Shot_2015-06-01_at_11.42.46_AM.png

 

Screen_Shot_2015-06-01_at_11.43.02_AM.png

 

Note that a file can only be associated in one Media container. If you do not see a file in the list that you expect to see, this could be because that video file is already associated with another piece of Media.

Renaming a Master

To rename a Master file that has been added, click on the Actions dropdown in the Master's row and choose Rename file. A dialog will appear allowing you to give this file a new name. Note that you cannot change a file's extension.

Removing a Master

Clicking on the X in the Master's row will spawn a dialog asking for confirmation before removing this Master file from this piece of Media. By default, the Master file will only be unassociated with this piece of Media (freeing it up to be associated within another piece of Media), but checking the Delete file from S3 checkbox will also delete the file permanently from Amazon S3. Use this with extreme caution, as there is no way to undo this action.

Encodes

Adding an Encode

A piece of Media is only usable on the web with an encode to play back. Our encoding guidelines can be found here. To add an encode, click the Add encode button and choose from one of the following two or three choices that follow.

Screen_Shot_2015-06-01_at_11.47.24_AM.png

 

1. Choose existing file

Selecting this option will spawn a dialog allowing you to select from the uploaded video files that are compatible for playback in the MediaStorm player; specifically, H.264/mp4 files.

Like the Add Master file chooser, if you do not see a file in the list that you expect to see it means that file is associated with another piece of Media.

Note that if the file is currently processing you will need to refresh the web browser once processing is complete before you can select the file.

Upon adding a file as an encode for this piece of Media, you will see it added to the encodes list, along with some basic file details, including dimensions, duration, and file size. At this point your Media will now be usable within a Title for playback within the MediaStorm player.

2. Create new encode from Master

If you've added a Master file to this piece of Media, you will be able to select this option, taking you to a page that allows you to create a new encode.

In many cases, you may want to create just a single 1280x720 encode, in which case the 'Automatic' option is best.

If you'd like to create an encode with different dimensions -- or multiple encodes of various dimensions -- choose the Custom option under Choose an aspect ratio and enter your dimensions.

Your encoded file will appear in the encodes list of that Media when encoding is complete.

3. Link Vimeo files

For those who have access to this beta feature and have connected their Vimeo account (see details below), selecting this option will allow you to link your existing Vimeo files to this piece of Media.

Clicking this option will spawn a dialog allowing you to browse your Vimeo videos and select which files to associate.

Clicking the confirmation button will populate the encodes list with all of the files indicated for that particular Vimeo video, and they will be usable within the MediaStorm player just as any other encoded file you may have uploaded or created from a Master.

Renaming an Encode

To rename an encode that has been added, click on the Actions dropdown in the encode's row and choose Rename file. A dialog will appear allowing you to give this file a new name. Note that you cannot change a file's original extension, nor can you change the name of a linked Vimeo file.

Removing an Encode

Clicking on the X in the encode's row will spawn a dialog asking for confirmation before removing this encode file from this piece of Media. By default, the encode will only be unlinked with this piece of Media (freeing it up to be used within another piece of Media), but checking the Delete file from S3 option will also delete the file permanently from Amazon S3. Use this with caution, as there is no way to undo this action.

Note that encodes added from your Vimeo account will only be unlinked, and will not be deleted or altered at all within your Vimeo account.

Connecting your Vimeo account

For those who have access to the Vimeo integration functionality, your Vimeo account must be connected to the Platform prior to being able to link to your Vimeo content for playback within the Platform.

To connect your Vimeo account to the Platform, following these steps:

  1. Go to the Settings page.

  2. In the Third-party Integrations section, click on the Connect to your Vimeo account link. You will be taken to a page on Vimeo's website asking for confirmation.

  3. Upon confirmation, you will be taken back to the MediaStorm Platform, where you can now follow the documentation above to link your Vimeo content to the Platform.
Have more questions? Submit a request

0 Comments

Article is closed for comments.
Powered by Zendesk