Video Player component
Use the Video Player component to attach video files to GameObjects, and play them on the GameObject’s Texture at run time.
The screenshot below shows a Video Player component attached to a spherical GameObject.
By default, the Material Property of a Video Player component is set to _MainTex, which means that when the Video Player component is attached to a GameObject that has a Renderer, it automatically assigns itself to the Texture on that Renderer (because this is the main Texture for the GameObject). Here, the GameObject has a Mesh Renderer component, so the Video Player automatically assigns it to the Renderer field, which means the Video Clip plays on the Mesh Renderer’s Texture.
You can also set a specific target for the video to play on, including:
VideoPlayer component Reference
| Property | Function | ||
|---|---|---|---|
| Source | Choose the type of source for your video. | ||
| Video Clip | Assign a Video Clip to the Video Player. | ||
| Video Clip | Use this field to define the Video Clip assigned to the Video Player component. Drag-and-drop the video file into this field, or click the circle to the right of the field and choose it from a list of Assets if it is in your Project folder. | ||
| URL | Assign a video from a URL (for example, http:// or file://). Unity reads the video from this URL at run time. | ||
| URL | Enter the URL of the video you want to assign to the Video Player. | ||
| Browse… | Click this to quickly navigate your the local file system and open URLs that begin file://. | ||
| Play On Awake | Tick the Play On Awake checkbox to play the video the moment the Scene launches. Untick it if you want to trigger the video playback at another point during run time. Trigger it via scripting with the Play() command. |
||
| Wait For First Frame | If you tick the Wait For First Frame checkbox, Unity waits for the first frame of the source video to be ready for display before the game starts. If you untick it, the first few frames might be discarded to keep the video time in sync with the rest of the game. | ||
| Loop | Ticking the Loop checkbox to make the Video Player component loop the source video when it reaches its end. If this is unticked, the video stops playing when it reaches the end. | ||
| Playback Speed | This slider and numerical field represent a multiplier for the playback speed, as a value between 0 and 10. This is set to 1 (normal speed) by default. If the field is set to 2, the video plays at two times its normal speed. | ||
| Render Mode | Use the drop-down to define how the video is rendered. | ||
| Camera Far Plane | Render the video on the Camera’s far plane. | ||
| Camera Near Plane | Render the video on the Camera’s near plane. | ||
| Camera | Define the Camera receiving the video. | ||
| Alpha | The global transparency level added to the source video. This allows elements behind the plane to be visible through it. See documentation on video transparency support for more information about alpha channels. | ||
| Render Texture | Render the video into a Render Texture. | ||
| Target Texture | Define the Render Texture where the Video Player component renders its images. | ||
| Material Override | Render the video into a selected Texture property of a GameObject through its Renderer’s Material. | ||
| Renderer | The Renderer where the Video Player component renders its images. When set to None, the Renderer on the same GameObject as the Video Player component is used. | ||
| Material Property | The name of the Material Texture property that receives the Video Player component images. | ||
| API Only | Render the video into the VideoPlayer.texture Scripting API property. You must use scripting to assign the Texture to its intended destination. | ||
| Aspect Ratio | The aspect ratio of the images that fill the Camera Near Plane, Camera Far Plane or Render Texture when the corresponding Render Mode is used. | ||
| No Scaling | No scaling is used. The video is centered on the destination rectangle. | ||
| Fit Vertically | Scale the source to fit the destination rectangle vertically, cropping the left and right sides or leaving black areas on each side if necessary. The source aspect ratio is preserved. | ||
| Fit Horizontally | Scale the source to fit the destination rectangle horizontally, cropping the top and bottom regions or leaving black areas above and below if needed. The source aspect ratio is preserved. | ||
| Fit Inside | Scale the source to fit the destination rectangle without having to crop. Leaves black areas on the left and right or above and below as needed. The source aspect ratio is preserved. | ||
| Fit Outside | Scale the source to fit the destination rectangle without leaving black areas on the left and right or above and below, cropping as required. The source aspect ratio is preserved. | ||
| Stretch | Scale both horizontally or vertically to fit the destination rectangle. The source aspect ratio is not preserved. | ||
| Audio Output Mode | Define how the source’s audio tracks are output. | ||
| None | Audio is not be played. | ||
| Audio Source | Audio samples are sent to selected audio sources, enabling Unity’s audio processing to be applied. | ||
| Direct | Audio samples are sent directly to the audio output hardware, bypassing Unity’s audio processing. | ||
| Controlled Tracks | The number of audio tracks in the video. Only shown when Source is URL. When Source is Video Clip, the number of tracks is determined by examining the video file. |
||
| Track Enabled | When enabled by ticking the relevant checkbox, the associated audio track is used for playback. This must be set prior to playback. The text to the left of the checkbox provides information about the audio track, specifically the track number, language, and number of channels. For example, in the screenshot above, this text is Track 0 [und. 1 ch]. This means it is the first track (Track 0), the language is undefined (und.), and the track has one channel (1 ch), meaning it is a mono track. When the source is a URL, this information is only available during playback. This property only appears if your source is a Video Clip that has an audio track (or tracks), or your source is a URL (allowing you to indicate how many tracks are expected from the URL during playback). |
||
| Audio Source | The audio source through which the audio track is played. The targeted audio source can also play Audio Clips. The audio source’s playback controls ( Play On Awake and Play() in scripting API) do not apply to the video source’s audio track.This property only appears when the Audio Output Mode is set to Audio Source. |
||
| Mute | Mute the associated audio track. In Audio Source mode, the audio source’s control is used. This property only appears when the Audio Output Mode is set to Direct. |
||
| Volume | Volume of the associated audio track. In Audio Source mode, the audio source’s volume is used. This property only appears when the Audio Output Mode is set to Direct. |
||
2017–06–15 Page published with limited editorial review
New feature in Unity 5.6
Did you find this page useful? Please give it a rating: