版本: Unity 6 (6000.0)
语言English
  • C#

Handheld.PlayFullScreenMovie

建议更改

成功!

感谢您帮助我们提高 Unity 文档的质量。虽然我们无法接受所有提交,但我们确实会阅读用户提出的每个建议更改,并在适用时进行更新。

关闭

提交失败

由于某些原因,您的建议更改无法提交。请<a>稍后再试</a>。感谢您抽出时间帮助我们提高 Unity 文档的质量。

关闭

取消

声明

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。该函数通过查找协议名称后跟 :// 子字符串来检测它。

iOS:Handheld.PlayFullScreenMovie 在内部使用 MPMoviePlayerController 对象来播放电影。因此,您应该期望相同的行为和相同的支持格式。MPMoviePlayerController 支持在 iPod 或 iPhone 上已正确播放的任何电影或音频文件。

支持扩展名为 .mov、.mp4、.mpv 和 .3gp 且使用以下压缩标准之一的电影文件

  • H.264 基线配置文件级别 3.0 视频,最高 640 x 480,30 fps。请注意,基线配置文件不支持 B 帧。
  • MPEG-4 第 2 部分视频(简单配置文件)。

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

有关更多信息,请参阅 Apple 有关 MPMoviePlayerController 类参考 的文档。

UWP:在通用 Windows 平台上,Handheld.PlayFullScreenMovie 在内部使用 XAML MediaElement 控件。

在通用 Windows 平台上,通常没有电影分辨率或比特率限制,但是,更高分辨率或比特率的电影需要消耗更多内存进行解码。较弱的设备在极高分辨率下也很快开始跳帧。要查找此平台支持的格式列表,请参阅 Microsoft 有关 支持的音频和视频格式(Windows 运行时应用) 的文档。

Android:当 Android 手机处于待机模式时,Handheld.PlayFullScreenMovie 函数会暂停电影播放。当手机重新打开时,如果使用开发版本,则电影播放将在锁定屏幕上恢复。您可以选择切换回标准锁定屏幕显示。

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

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