Documentation

Unity Engine

User Manual

Script Reference

Unity Engine

Video playback in Web

Information about the video playback capabilities that Web supports.
Read time 2 minutesLast updated 12 days ago
Unity Web supports video playback using the VideoPlayer API. This page provides information only about the video playback capabilities that Web supports. To learn how to use video with your Unity application, refer to the Video Player.

Video player

You can use the Video Player component to control how to time video playback relative to other interactive behaviors in Web. For more information, refer to the Clock management with the Video Player component.
The only exceptions are:
  • Web doesn't support frame accuracy.
  • The 
    VideoPlayer
    component doesn’t support synchronous playback with 
    captureFramerate
    . By default, it uses the normal asynchronous playback that’s described with the Game time update mode.
  • The 
    VideoPlayer
    component corrects drift between video playback and Unity time by temporarily speeding the playback controls to up or down. However, because the video support in Safari browser has limitations that prevent this mechanism from operating with precision, the drift correction is disabled.

Supported video playback features and formats

Unity Web supports the following video playback audio output modes:

Class

Use

VideoAudioOutputMode.NoneDisables the embedded audio.
VideoAudioOutputMode.DirectSends the embedded audio directly to the platform's audio hardware.
VideoAudioOutputMode.AudioSourceSends the embedded audio into a specified AudioSource. If you set the output mode to 
VideoAudioOutputMode.AudioSource
, Unity ignores all AudioSource fields except mute. This is because 3D spatialization of video playback isn't available on the web.

Video formats

Unity supports the following common video file formats:

Format

Extensions

MPEG-4 Part 14.mp4
MPEG-4 file used for video downloaded from the Apple iTunes store.m4v
Apple's QuickTime movie format.mov
Moving Picture Experts Group (MPEG).mpg
MPEG video.mpeg
WebM video.webm
Ogg video file.ogv
The only exception to this restriction is if the video URL has no file name extension, in which case, the browser plays the video without any restrictions.

Video clips

VideoClips
 aren't supported on Web. Typically, when creating a scene, you import a VideoClip to your Unity project using 
VideoClipImporter
, which is convenient if you want to reuse the same 
VideoClip
across several platforms. When building a Web game that has 
VideoClip
attached however, the Unity console logs the following warning for each 
VideoClip
found in the game:
Embedded video clips are not supported by the Web player: %s. \nUse the Video Player component's URL option instead
. Where 
%s
is replaced by the video clip name. At runtime, if your game has 
VideoClips
assigned, then Unity logs a warning message in the developer console of your web browser.

Additional resources: