Uploading Videos Using the Upload Module

This topic provides an overview of the Upload module which is used to upload videos to a Video Cloud account.
 

The Upload module uses a dynamic ingest process to retrieve and transcode video content. When you select a file to upload, Video Cloud uses a pull-based process to pull the content from a storage location where it then uses the Zencoder transcoding service to transcode the content.

To access the Upload module, open the Upload module.

Supported video formats

For information about video formats and codecs, and what source video formats are supported by Video Cloud, see Supported Video Codecs and Containers.

Selecting an ingest profile

Before uploading videos, select an ingest profile. The ingest profile contains the transcode settings that will be used when the videos are transcoded. The list of available ingest profiles will vary based upon how your Video Cloud account is configured. In the following screen shot, both CONTEXT AWARE ENCODING and DYNAMIC DELIVERY profiles are available.

The video renditions that are created are based upon the ingest profile that is selected. For specific details on the Brightcove supplied ingest profiles, see Standard Ingest Profiles for Dynamic Delivery and Context Aware Encoding

The image dimensions for the poster and thumbnail images are based upon the image dimensions specified in the ingest profile.

Do I need MP4 renditions?

There are several reasons why you might want to choose an ingest profile that creates MP4 renditions:

  • Sharing using the Social module - The Social module requires that an MP4 rendition be available to share to social media. An MP4 rendition is also required to download a video using the Social module.
  • Downloading videos - If viewers will have the ability to download videos using a download link on a webpage, download from a Gallery Portal or In-Page experience or download by using an RSS feed, you should create MP4 renditions.
  • Closed captions - (CEA 608) closed captions for accessibility can only be added to MP4 renditions. You can add text track captions to HLS/DASH renditions but these do not meet legal accessibility standards.
  • Cloud Playout module - In order to be added to Cloud Playout channels, videos must have at least one MP4 rendition.
  • Streaming to Legacy Devices - Older devices such as Android 4.x and prior require MP4 renditions for streaming via progressive download.

If any of these use cases are important to you, Brightcove recommends selecting an ingest profile that generates one or more MP4 renditions.

Automatically generating captions

If the account is enabled for auto captioning and a Dynamic Delivery ingest profile is selected, an Auto captioning option will be displayed.

For information on auto captioning, see Automatically Generating Captions for Videos.

Adding a forensic watermark

If the account is enabled for forensic watermarking and a Dynamic Delivery ingest profile is selected, an option to enable forensic watermarking will be displayed.

For information on forensic watermarking, see Overview: Forensic Watermarking.

Uploading videos

Videos can be uploaded using one of these methods:

  • Drag and Drop - Drag files from the file system to the Upload module page. The entire page below the navigation header becomes the drop zone. When the file is dropped, the upload process will begin.
  • File selection dialog - Click Browse for Videos to open a file selection dialog and then browse and select files to upload.
  • Remote URL - Click Enter URL to specify the location of the source file. Source files may reside on a public Amazon S3 storage location. Click Process Video when finished.

Once the files have been selected, the file upload will begin. To cancel the upload, click Cancel Upload. Click Dismiss to remove the file entry from the page. While uploads are in a processing state, do not close or move away from the browser window. Doing so may cause an incomplete upload.

When the upload is complete, a Processing Complete status will display. This indicates the processing has completed and it is safe to navigate from the Upload module.

Click Edit to view the ingest profile and a subset of the video properties. The ingest profile can be changed if the video transcoding has not started. The following video properties can be edited:

  • Status - Video status
    • Active - Video can be played
    • Inactive - Video can't be played

    By default, when a video is uploaded, the status is set to Active unless required fields are missing. If required fields are missing, a message will be displayed with the required fields highlighted in red. Videos with missing required fields can still be uploaded but they will remain Inactive until all of the required fields have values. For more information on working with required fields, see Setting Required Fields for Videos.

  • Name - Title for the video
  • Short Description - Short description for the video
  • Tags - Tags associated with the video
  • Reference ID - Video reference ID
  • Video Projection - Select 360 Degree to indicate a video is a 360 degree video. For more information on working with 360 degree videos, see Working with 360° Videos.
  • Enable offline playback - When checked, enables the video to be saved locally and viewed offline when using applications created using the device SDKs. This option will only appear if the account is enabled for offline playback. It is recommended to only set this option when using Advanced upload (when user must manually start upload processing). Setting this when a video is in the process of uploading may cause issues.
  • Move to Folder - Select a folder to assign the video to. For more information on working with folders, see Organizing Videos Using Folders.
  • Custom Fields - Any custom fields that have been marked as required will appear.

To learn more about video properties, see Editing Video Properties using the Media Module.

Click Save to save any changes and begin the transcoding process.

Upload additional assets

When the Upload Additional Assets account setting is enabled, the video properties panel will also display Select buttons allowing poster and thumbnail images to be uploaded along with the video. Click Select to choose poster and thumbnail images and then click Process to begin the transcode.

Note that the image dimensions for the poster and thumbnail images will be based upon the image dimensions specified in the ingest profile. For information on configuring the Advanced Upload account setting, see Managing Account Settings.

Setting a default folder and tags

When uploading videos, a folder and tags for the videos being uploaded can be specified. The folder dropdown list will display a list of all the folders that have been created in the Media module. Click + Create folder to create a new folder and assign the video(s) to the new folder. When creating a new folder:

  • Name is limited to 100 characters
  • Folder names must be unique within an account
  • Illegal character: /

When a folder is selected, all uploaded videos will be added to that folder. For information on creating and assigning videos to folders using the Media module, see Organizing Videos Using Folders.

Tags can also be assigned to videos as they are uploaded. Enter a comma-separated list of tags to assign to videos.

After selecting a folder or adding tags, click Apply to All to save the changes. Note that the folder and tags will be applied to all videos that are uploaded, in the process of being uploaded or where the upload has finished and the video is still displayed in the Upload module ( Dismiss button hasn't been clicked).

Uploading videos from mobile devices

The Media module is written entirely in HTML5 and can also be used on tablet and mobile devices. This allows you to shoot video with a mobile device and upload it to your Video Cloud account. To upload content from a mobile device, open the Upload module and select an ingest profile. When you click Browse for Videos, the photos application on the device will open. Select the videos to upload and click done. The videos from the mobile device will begin uploading and the progress will be displayed on your device.

Special characters

If you are providing a URL for Video Cloud to fetch your videos, and you are sending credentials as part of the URL, you need to percent-encode certain reserved special characters:

Character Percent-Encoded
] %5B
[ %5D
? %3F
/ %2F
< %3C
~ %7E
# %23
` %6D
! %21
@ %40
$ %24
% %25
^ %5E
& %26
* %2A
( %28
) %29
+ %2B
= %3D
} %7D
| %7C
: %3A
" %22
; %3B
' %27
, %2C
> %3E
{ %7B
space %20

For example:


    /* unencoded */
    ftp://user@example.com:pass!word@example.com/path/to/input.mp3

    /* encoded */
    ftp://user%40example.com:pass%21word@example.com/path/to/input.mp3
  

Common upload errors

The upload process seems to hang or makes no progress

Try clearing the browser cache and then upload the video again. We have seen that clearing the browser cache will help resolve video upload issues.

The difference between the request time and the current time is too large.

This error will occur when the system time on the machine uploading videos is not set correctly. This usually happens after a time change. Make sure your machine is set to the correct time.