Unity WebGL 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:
| 类 | 用法 |
|---|---|
| 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:
| 格式 | 扩展名 |
|---|---|
| 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 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 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.