文档

Unity 引擎

Unity 引擎

视Video Player组件参考

详细了解 Video Player 组件的 Settings。
阅读时间10 分钟最后更新于 10 天前

ConfigureVideo Player组件的Settings可指定要播放的视频文件,并自定义其在Scene中的播放行为。
有关 Video Player 组件以及如何创建一个组件的信息,请参阅 Video Player 组件目标并创建 Video Player 组件。

属性

描述

来源选择要检索视频内容的音频源类型。音频源可以是存储在 Project 中的视频文件、以指定网址托管在外部的文件或保存在
StreamingAssets
Folder 中的视频文件。
视频剪辑选择要分配给 Video Player 组件的视频剪辑。ON Web 平台不支持此功能。
URL进入网址(例如,要分配给 Video Player 的视频的http://或file://))。
更新模式设置Video Player组件用于更新其时序的Clock音频源。有关更多信息,请参阅更新模式 Dropdown。
Play On Awake在Scene启动When播放视频。如果要在运行时时的另一个点频播放,请清除此复选框。使用
Play()
命令通过脚本进行触发器。
等待第一帧等音频源视视频的第一帧准备就绪,以便在播放开始前显示。清除除此选项可使视频时间与游戏的REST部分保持Sync,这可能会导致前几帧被丢弃。
循环在音频源视频达其结束WhenLoop播放。清除除此选项可在视频到达结束When停止播放视频。
跳下Enable此选项When,如果Video Player组件检测到播放位置与游戏Clock之间的漂移,则Video Player会跳过前面。当您禁用此选项时,Video Player 不会纠正漂移,而是系统播放 All 帧。
播放速度将Playback Speed的Multiplier设置为 0 到 10 之间的值。默认情况下,值设置为 1,即法线速度。如果将Field设置为 2,视频将以法线速度的两倍播放。
渲染模式选择视频的渲染方式。有关更多信息,请参阅渲染模式 Dropdown。
Camera定义接收视频的 Camera。仅当渲染模式为 Camera 远平面或 Camera 近平面时,此属性才可用。
Alpha设置要添加音频源视频的全局透明度度关卡。属性允许通过平面可见平面后面的元素。有关 Alpha 通道的更多信息,请参阅视频透明度 Support。仅当渲染模式为 Camera 远平面或 Camera 近平面时,此属性才可用。
3D Layout选择音频源视频 3D 内容的Layout。有关更多信息,请参阅 3D Layout Dropdown。
Target纹理定义 Video Player 组件渲染图像的渲染纹理。有关渲染纹理的建议 Settings,请参阅为视频准备渲染纹理。
宽高比设置使用相应渲染模式时填充 Camera 近平面、Camera 远平面或渲染纹理的图像的宽高比。有关更多信息,请参阅宽高比 Dropdown。
渲染器选择 Video Player 组件渲染图像的渲染器。When 设置为 None 时,Video Player 组件使用同一游戏对象的渲染器 ON。
自动选择属性当您启用此选项时,Video Player 组件会自动选择渲染器的主要纹理。当您禁用此选项时,您可以手动设置材质属性选项。
音频输出模式定义音频源的音频轨道的输出方式。有关更多信息,请参阅音频输出模式 Dropdown。
受控轨道视频中的音频轨道数量。

仅当音频源为网址时显示。当音频源为视频剪辑时,轨道的数量是通过检查视频文件来确定的。
轨道数量启用关联的Audio Track以使用于播放。您需要在播放之前设置属性性。

复选框左的文本提供有关Audio Track的信息,特别是轨道数量、语言和通道数量。

音频源源为 网址 时,此信息仅在播放期间可用。

仅音频源是具有一个或多个Audio Track的视频剪辑,音频源是 网址 时,才显示属性性(此属性可指示在播放期间从 网址 期望的音轨数)。
音频源Audio Track 播放的 Audio Source。目标 Audio Source 也可以播放音频 Clips。

Audio Source 的播放控件(脚本 API 中的
Play On Awake
和
Play()
)不适用于视频音频源的 Audio Track。

仅当 音频输出模式设置为 Audio Source 时,才显示此属性。
mute将关联的 Audio Track 静音。在 Audio Source 模式下,使用 Audio Source 的 Control。

仅当音频输出模式为直接时,此属性才可用。
音量关联Audio Track的音量。在 Audio Source 模式下,使用 Audio Source 的音量。

仅当音频输出模式为直接时,此属性才可用。

更新模式 Dropdown

更新模式 Dropdown 中提供以下选项。

值

描述

DSP 时间使用处理音频的相同时Clock音频源。
Game Time使用与游戏Clock相同的Clock音频源。此 Clock 音频源受时间缩放和捕获帧率 Settings 的影响。
未缩放的游戏时间使用与游戏 Clock 相同的 Clock 音频源,但该 Clock 音频源不受时间缩放或捕获帧率的影响。

渲染模式 Dropdown

渲染模式 Dropdown 中提供以下选项。有关这些目标的更多信息,请参阅 Video Player 组件目标。

值

描述

Camera 远平面ON Camera 的远平面渲染视频。如果选择此选项,视频将在Scene的背景中播放。
Camera 近平面ON Camera 的近平面渲染视频。如果选择此选项,视频将在Scene中的对象前面播放。
渲染纹理将视频渲染为渲染纹理。有关说明和建议的设置,请参阅设置渲染纹理以显示视频。
材质覆盖通过渲染器的材质将视频渲染到游戏对象的选定纹理属性中。
仅限 API将视频渲染到 VideoPlayer.纹理脚本 API 属性中。

3D Layout Dropdown列表

3D Layout Dropdown 中提供以下选项。

值

描述

None(无)视频没有Any 3D 内容。
并排视频具有 3D 内容,其中左占据视频帧的左部分,右眼占据视帧右半部分。
过度不足视频具有 3D 内容,其中左占据视频帧的上半部分,右眼占据视帧下半部分。

宽高比 Dropdown选单

以下 Settings 是
Aspect Ratio

?

Dropdown 中的可用选项。

值

描述

无缩放不使用缩放。视视频ON目标形为中心。
垂直适应Scale音频源以垂直适应目标矩形。如果需要,此选项裁剪左和右 Sides 或每侧留下黑色区域 ON。保音频源宽高比。
水平适应Scale音频源以水平适应目标矩形。此选项可裁剪顶部和底部区域,或根据需要在上方和下方留下黑色区域。保音频源宽高比。
适应内部Scale音频源以适应目标矩形,而无需裁剪。根据需要ON左和右侧或上方和下方留下黑色区域。保音频源宽高比。
适应外部Scale音频源以适应目标矩形,而不会ON左和右侧或上方和下方留下黑色区域,并根据需要进行裁剪。保音频源宽高比。
拉伸水平或垂直Scale以适应目标矩形。音频源宽高比未保留。

音频输出模式 Dropdown

音频输出模式 Dropdown 中提供以下选项。

值

描述

None(无)未播放音频。
音频源音频样本将发送到选定的音频源,从而可以应用 Unity 的音频处理。
直接音频样本将绕过 Unity 的音频处理直接发送到音频输出硬件。
仅限 API(实验性)音频样本将发送到关联的 AudioSampleProvider。

其他资源