Version: 2022.3

Handheld.PlayFullScreenMovie

切换到手册
public static bool PlayFullScreenMovie (string path, Color bgColor= Color.black, FullScreenMovieControlMode controlMode= FullScreenMovieControlMode.Full, FullScreenMovieScalingMode scalingMode= FullScreenMovieScalingMode.AspectFit);

参数

path 电影文件的文件系统路径。
bgColor 背景颜色。
controlMode 播放控件的显示方式。
scalingMode 如何缩放电影以适合屏幕。

描述

播放全屏电影。

注意,播放器将直接从设备存储流式传输电影, 因此,您必须将电影作为单独的文件 而不是普通资源提供。您必须在 Unity 项目(在您的“Assets”文件夹中)中 创建一个名为 StreamingAssets 的 文件夹。将电影存储在该文件夹中。 Unity 会自动将该文件夹的内容复制到 应用程序捆绑包中。

在播放电影期间调用该函数将暂停 Unity。播放完成后, Unity 将恢复。

第一个参数 path 可以是基于网络的 URL。该函数 将通过查找协议名称后跟“://”子串来 检测基于网络的 URL。

在 iOS 上,Handheld.PlayFullScreenMovie 内部使用 MPMoviePlayerController 对象来播放电影。因此,Unity 在 iOS 上播放电影的行为和支持的格式 与 MPMoviePlayerController 相同。MPMoviePlayerController 支持任何 可在 iPod 或 iPhone 上正常播放的电影或音频文件。

对于电影文件,这通常意味着扩展名为 .mov、 .mp4、.mpv 和 .3gp 并使用以下压缩标准之一的 文件:

H.264 Baseline Profile Level 3.0 视频,最高为 640 x 480、30 fps。 注意,Baseline Profile 不支持 B 帧。

MPEG-4 Part 2 视频 (Simple Profile)。

调用该函数将启动一个过渡 - 屏幕将从当前内容淡出并淡入到指定的 播放器背景颜色。播放完成后,播放器会使用另一个淡入淡出效果 过渡回您的内容。

您可以在 MPMoviePlayerController 类参考中找到 Apple 的 MPMoviePlayerController 文档。

在 Windows Phone 8 上,Handheld.PlayFullScreenMovie 内部使用 Microsoft Media Foundation 进行电影播放。在该平台上,不支持使用完全或最小控制模式调用 Handheld.PlayFullScreenMovie

在 Windows 应用商店应用程序和 Windows Phone 8.1 上,Handheld.PlayFullScreenMovie 内部使用 XAML MediaElement 控件。

在 Windows Phone 和 Windows 应用商店应用程序中,通常没有电影分辨率 或比特率限制,但是,更高分辨率或比特率的电影 将使用更多的解码内存。在极高的分辨率下, 性能较弱的设备也更容易跳帧。例如, Nokia Lumia 620 只能顺畅播放分辨率最高为 1920x1080 的视频。 对于这些平台,您可以在 Windows 应用商店支持的音频和视频格式中找到支持的格式的列表。

using System.Collections;
using System.Collections.Generic;
using UnityEngine;

public class Example : MonoBehaviour { void Start() { Handheld.PlayFullScreenMovie("StarWars.mp4", Color.black, FullScreenMovieControlMode.CancelOnInput); } }