path | 电影文件的系统路径。 |
bgColor | 背景颜色。 |
controlMode | 如何显示播放控件。 |
scalingMode | 如何缩放电影以适应屏幕。 |
播放全屏电影。
播放器直接从设备存储中播放电影。建议将电影作为单独的文件提供,而不是作为常规资源。在 Unity 项目的 Assets 文件夹中创建一个名为 StreamingAssets
的文件夹以存储您的电影文件。Unity 会自动将该文件夹的内容复制到应用程序包中。
调用此函数将在电影播放期间暂停 Unity。播放完成后,Unity 将恢复。
第一个参数 path
可以是基于网络的 URL。该函数通过查找协议名称后跟 ://
子字符串来检测它。
iOS:Handheld.PlayFullScreenMovie
在内部使用 MPMoviePlayerController
对象来播放电影。因此,您应该期望相同的行为和相同的支持格式。MPMoviePlayerController
支持在 iPod 或 iPhone 上已正确播放的任何电影或音频文件。
支持扩展名为 .mov、.mp4、.mpv 和 .3gp 且使用以下压缩标准之一的电影文件
调用此函数将启动一个过渡,将屏幕从当前内容淡出到播放器的指定背景颜色。播放完成后,播放器将使用另一个淡出效果过渡回您的内容。
有关更多信息,请参阅 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); } }