VideoPlayer

Description

将视频内容播放到目标上。

内容可以是 VideoClip 导入资源，也可以是 URL（例如 file:// 或 http://.）。视频内容将投射到一个受支持的目标上，例如摄像机背景或 RenderTexture。 如果视频内容包括透明度，此透明度将出现在目标中，允许视频目标后面的对象可见。

电影文件格式支持说明

VideoPlayer 在其实现中使用原生音频和视频解码库，您有责任使用符合目标平台要求的视频。VideoClipImporter 提供了一个将 VideoClip 资源转码为 H.264 或 VP8 视频编解码器的选项，以及一些实验性选项（例如 Resolution）。这会将匹配的编解码器用于音频轨道：分别是 AAC 和 Vorbis。

另请参阅：VideoClipImporter.SetTargetSettings 和 VideoImporterTargetSettings.enableTranscoding。

您可以选择忽略此转码，而是改用已知受目标系统支持的视频，同时使用外部程序更精确地控制编码过程。在使用过程中，VideoClipImporter 编辑器会提供指导和警告，以更好地帮助您做出正确的格式和编码选择。

目前，必须遵循供应商建议，而且在旧版移动平台上尤其受到约束。例如，您在 Web 中找到的视频通常需要经过检查和相关操作，才能在运行在多个设备上的游戏环境中可靠地使用。以下是一些建议和已知限制的示例：

* Android: Supported Media Formats. See additional notes below.
* Windows: H.264 Video Decoder (see Format Constraints)
* iPhone 6-7: Compare iPhone Models (see TV and Video)

可用于硬件加速的本机支持的最优视频编解码器是 H.264，同时 VP8 作为可以在需要时使用的软件解码解决方案。在 Android 上，VP8 还支持使用本机库，因此也可以根据型号对硬件进行辅助。要在编码参数中查找的键值：

* Video Codec: H.264 or VP8.
* Resolution: For example: 1280 x 720.
* Profile: Applicable for H.264. The profile is a set of capabilities and constraints; vendors often specify this, such as "Baseline" or "Main". See here.
* Profile Level: Applicable for H.264. Within a given profile, the level specifies certain performance requirements such as "Baseline 3.1". See here.
* Audio Codec: Typically AAC (with mp4 videos using H.264) or Vorbis (with webm videos using VP8).
* Audio Channels: depends on platform. For example, the Android recommendation is for stereo files, but many devices will accept 5.1.

关于 Android 的注意事项

* Support for resolutions above 640 x 360 is not available on all devices. Runtime checks are done to verify this and failures will cause the movie to not be played. * For OS 4.1/4.2, movies above 1280 x 720 or with more than 2 audio tracks will not be played due to bugs in the OS libraries. * For OS 5.0+, any resolution or number of audio channels may be attempted, but will be constrained by device capabilities.
* The Vulkan graphics API is not yet supported.
* Format compatibility issues are reported in the adb logcat output and are always prefixed with AndroidVideoMedia. * Also pay attention to device-specific error messages located near Unity's ones: they are not available to the engine, but often explains what the compatibility issue is.

以下部分演示了 VideoPlayer 的一些功能：

// Examples of VideoPlayer function

using UnityEngine;

public class Example : MonoBehaviour
{
    void Start()
    {
        // Will attach a VideoPlayer to the main camera.
        GameObject camera = GameObject.Find("Main Camera");

        // VideoPlayer automatically targets the camera backplane when it is added
        // to a camera object, no need to change videoPlayer.targetCamera.
        var videoPlayer = camera.AddComponent<UnityEngine.Video.VideoPlayer>();

        // Play on awake defaults to true. Set it to false to avoid the url set
        // below to auto-start playback since we're in Start().
        videoPlayer.playOnAwake = false;

        // By default, VideoPlayers added to a camera will use the far plane.
        // Let's target the near plane instead.
        videoPlayer.renderMode = UnityEngine.Video.VideoRenderMode.CameraNearPlane;

        // This will cause our scene to be visible through the video being played.
        videoPlayer.targetCameraAlpha = 0.5F;

        // Set the video to play. URL supports local absolute or relative paths.
        // Here, using absolute.
        videoPlayer.url = "/Users/graham/movie.mov";

        // Skip the first 100 frames.
        videoPlayer.frame = 100;

        // Restart from beginning when done.
        videoPlayer.isLooping = true;

        // Each time we reach the end, we slow down the playback by a factor of 10.
        videoPlayer.loopPointReached += EndReached;

        // Start playback. This means the VideoPlayer may have to prepare (reserve
        // resources, pre-load a few frames, etc.). To better control the delays
        // associated with this preparation one can use videoPlayer.Prepare() along with
        // its prepareCompleted event.
        videoPlayer.Play();
    }

    void EndReached(UnityEngine.Video.VideoPlayer vp)
    {
        vp.playbackSpeed = vp.playbackSpeed / 10.0F;
    }
}

Static Variables

Variables

Public Functions

Events

Delegates

Inherited members