视频播放器组件参考

配置视频播放器组件的设置以指定要播放的视频文件，并在场景场景包含游戏的环境和菜单。将每个唯一的场景文件视为一个独特的关卡。在每个场景中，您可以放置环境、障碍物和装饰，实质上是分批设计和构建游戏。更多信息
请参阅术语表.

有关视频播放器组件以及如何创建组件的信息，请参阅视频播放器组件目标和创建视频播放器组件。

财产	描述
源	选择要从中检索视频内容的源类型。源可以是存储在项目中的视频文件，托管在外部的特定 URL 上，或者保存在`StreamingAssets`文件夹。
视频剪辑	选择要分配给视频播放器组件的视频剪辑。Web 平台不支持此功能。
网址	输入要分配给视频播放器的视频的 URL（例如，http:// 或 file://）。
更新模式	设置视频播放器组件用于更新其计时的时钟源。有关更多信息，请参阅更新模式下拉列表。
唤醒时播放将此设置为 true 以使音频源在唤醒时开始播放更多信息请参阅术语表	场景启动时播放视频。如果要在运行时的另一个时间点触发视频播放，请清除它。通过脚本触发它，使用`Play()`命令。
等待第一帧	等待源视频的第一帧准备好显示，然后再开始播放。清除它以使视频时间与游戏的其余部分保持同步，这可能会导致前几帧被丢弃。
圈	当源视频到达结尾时循环播放。清除它以在视频结束时停止播放视频。
跳过掉落	启用此选项时，视频播放器组件检测到播放位置和游戏时钟之间的漂移，视频播放器会向前跳过。禁用此选项后，视频播放器不会校正漂移，而是系统地播放所有帧。
播放速度	将播放速度的乘数设置为 0 到 10 之间的值。默认情况下，此值设置为 1，这是正常速度。如果将栏设定为 2，则视频将以正常速度的两倍播放。
渲染模式（Render Mode）	选择视频的呈现方式。有关更多信息，请参阅渲染模式下拉菜单。
照相机	定义相机在场景中创建特定视点图像的组件。输出被绘制到屏幕上或作为纹理捕获。更多信息请参阅术语表接收视频。仅当渲染模式（Render Mode）为摄像机远平面（Camera Far Plane）或摄像机近平面（Camera Near Plane）时，此属性才可用。
阿尔法	设置要添加到源视频的全局透明度级别。此属性允许通过它看到平面后面的元素。有关 Alpha 通道的更多信息，请参阅视频透明度支持。仅当渲染模式（Render Mode）为摄像机远平面（Camera Far Plane）或摄像机近平面（Camera Near Plane）时，此属性才可用。
3D 布局	选择源视频中 3D 内容的布局。有关更多信息，请参阅 3D 布局下拉列表。
目标纹理（Target Texture）	定义 Render Texture，视频播放器组件在其中渲染其图像。有关渲染纹理的推荐设置，请参阅为视频准备渲染纹理。
纵横比图像比例尺寸的关系，例如其宽度和高度。请参阅术语表	设置使用相应渲染模式时，填充摄像机近平面（Camera Near Plane）、摄像机远平面（Camera Far Plane）或渲染纹理（Render Texture）的图像的纵横比。有关更多信息，请参阅纵横比（Aspect Ratio）下拉菜单。
渲染	选择视频播放器组件渲染其图像的渲染器。设置为“无”时，视频播放器组件将在同一图像上使用渲染器游戏对象Unity 场景中的基本对象，可以表示角色、道具、风景、相机、航路点等。游戏对象的功能由附加到它的组件定义。更多信息请参阅术语表.
自动选择属性	启用此选项后，Video Player 组件会自动选择渲染器的主纹理。禁用此选项后，可以手动设置 Material Property 选项。
音频输出模式	定义源的音轨输出方式。有关更多信息，请参阅音频输出模式（Audio Output Mode）下拉菜单。
受控轨道	视频中的音轨数。仅当“源”为 URL 时才显示。当“源”为“视频剪辑”时，通过检查视频文件来确定轨道数。
轨道编号	启用关联的音轨以用于播放。您需要在播放之前设置此属性。复选框左侧的文本提供有关音轨的信息，特别是轨道编号、语言和通道数。当源是 URL 时，此信息仅在播放期间可用。仅当您的源是具有音轨（或多个音轨）的视频剪辑，或者您的源是 URL（可让您指示在播放期间预期从 URL 获得多少音轨）时，才会显示此属性。
音频源	这音频源将场景中的音频剪辑播放到音频监听器或通过混音器播放的组件。更多信息请参阅术语表音轨通过它播放。目标音频源还可以播放音频剪辑。音频源的播放控件（`Play On Awake`和`Play()`）不适用于视频源的音轨。仅当“音频输出模式”设置为“音频源”时，才会显示此属性。
静音	将关联的音轨静音。在音频源模式下，使用音频源的控件。仅当音频输出模式（Audio Output Mode）为直接（Direct）时，此属性才可用。
卷	关联音轨的音量。在音频源模式下，使用音频源的音量。仅当音频输出模式（Audio Output Mode）为直接（Direct）时，此属性才可用。

更新模式（Update Mode）下拉菜单

以下选项在 更新模式（Update Mode） 下拉列表中可用。

价值	描述
DSP 时间	使用处理音频的相同时钟源。
游戏时间	使用与游戏时钟相同的时钟源。此时钟源受时间缩放和捕获帧速率设置的影响。
未缩放游戏时间	使用与游戏时钟相同的时钟源，但此时钟源不受时间缩放或捕获帧速率的影响。

渲染模式（Render Mode）下拉菜单

渲染模式（Render Mode）下拉列表中提供了以下选项。有关这些目标的更多信息，请参阅视频播放器组件目标。

价值	描述
相机远平面（Camera Far Plane）	在摄像机的远平面上渲染视频。如果选择此选项，视频将在场景的背景中播放。
平面附近的相机	在摄像机的近平面上渲染视频。如果选择此选项，视频将在场景中的对象前面播放。
渲染纹理（Render Texture）	将视频渲染成渲染纹理（Render Texture）一种特殊类型的纹理，在运行时创建和更新。要使用它们，请先创建一个新的渲染纹理，并指定要渲染到其中的摄像机之一。然后，你可以在材质中使用渲染纹理，就像使用常规纹理一样。更多信息请参阅术语表.有关说明和推荐设置，请参阅设置渲染纹理以显示视频。
材质覆盖（Material Override）	通过游戏对象的渲染器将视频渲染到游戏对象的选定纹理属性中材质（Material）定义表面应如何渲染的资产。更多信息请参阅术语表.
仅限 API	将视频渲染到 VideoPlayer.texture 脚本 API 属性中。

3D 布局下拉列表

3D 布局下拉列表中提供了以下选项。

价值	描述
没有	视频没有任何 3D 内容。
并排	视频具有 3D 内容，其中左眼占据视频帧的左半部分，右眼占据右半部分。
大盘小盘	视频具有 3D 内容，其中左眼占据视频帧的上半部分，右眼占据下半部分。

纵横比（Aspect Ratio）下拉菜单

以下设置是 纵横比（Aspect Ratio）下拉列表中可用的选项。

价值	描述
无缩放	不使用缩放。视频以目标矩形为中心。
垂直拟合	缩放源以垂直适合目标矩形。如有必要，此选项会裁剪左右两侧或在每一侧留下黑色区域。源纵横比将保留。
水平拟合	缩放源以水平适合目标矩形。如果需要，此选项会裁剪顶部和底部区域或在上方和下方留下黑色区域。源纵横比将保留。
适合内部	缩放源以适合目标矩形，而无需裁剪。根据需要在左右或上下留下黑色区域。源纵横比将保留。
适合外部	缩放源以适合目标矩形，而不在左右或上下留下黑色区域，并根据需要进行裁剪。源纵横比将保留。
伸展	水平或垂直缩放以适合目标矩形。源宽高比不会保留。

音频输出模式（Audio Output Mode）下拉菜单

音频输出模式（Audio Output Mode） 下拉菜单中提供了以下选项。

价值	描述
没有	音频不会播放。
音频源	音频样本将发送到选定的音频源，从而可以应用 Unity 的音频处理。
直接	音频样本直接发送到音频输出硬件，绕过 Unity 的音频处理。
仅 API（实验性）	音频样本将发送到关联的 AudioSampleProvider。

其他资源

视频播放器组件目标

创建视频播放器组件

手册

视频播放器组件参考

更新模式（Update Mode） 下拉菜单

渲染模式（Render Mode） 下拉菜单