Unity WebGLA JavaScript API that renders 2D and 3D graphics in a web browser. The Unity WebGL build option allows Unity to publish content as JavaScript programs which use HTML5 technologies and the WebGL rendering API to run Unity content in a web browser. More info
See in Glossary supports video playback using the VideoPlayer API. This page provides information only about the video playback capabilities that WebGL supports. To learn how to use video with your Unity application, refer to the Video Player.
You can use the Video Player component to control how to time video playback relative to other interactive behaviors in WebGL. For more information, refer to the Clock management with the Video Player component.
The only exceptions are:
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.Unity WebGL supports the following video playback audio output modes:
Class | Use |
---|---|
VideoAudioOutputMode.None | Disables the embedded audio. |
VideoAudioOutputMode.Direct | Sends the embedded audio directly to the platform’s audio hardware. |
VideoAudioOutputMode.AudioSource | Sends 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. |
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.
VideoClips
aren’t supported on WebGL. Typically, when creating a sceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
See in Glossary, 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 WebGL 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 WebGL 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.