Language:
Page Info
Engine Version:
Share
此中文页面内容对应的英文页面有后续更新,如需浏览最新文档可切换至英文页面浏览。

媒体框架技术参考

此页面概述当前支持的文件格式和 URL,以及如何在不同平台上启用媒体框架的故障排除技巧。 当前版本存在一些已知平台特有的问题和限制,我们正在努力进行研究和修复。它们已在 Troubleshooting Platform 部分中指出。

如果需要从 4.13 版本前的项目中更新媒体框架内容,请查看 将媒体框架内容更新至 4.13 中的技巧。

支持文件和 URL

下表包含每个媒体播放器平台支持的文件格式。

点击下图下载 .xlsx 格式的支持文件和 URL 电子表格。

MediaFrameworkExtentions.png

上方的支持文件格式列表仍在更新中。随着引擎版本更新将支持更多文件延展名。为获得最佳兼容性和性能,推荐使用 H.264 .mp4 文件格式。 此外,上表中指出的文件格式为引擎 4.15 版本所支持的格式。

如 UE4 在 Windows 7 或更新的操作系统上进行构建,当前版本可支持 XboxOne 的 MfMedia 播放器插件的部分功能。MacOS 和 iOS 的 AvfMedia 播放器插件仍处于实验阶段,无法保证所有功能正常使用。我们正在努力解决这两个问题,希望使其能在未来版本中正常使用。

此表包含每个媒体播放器平台支持的 URL。

URLSheet.png

WMF 媒体配置设置

Windows Media Foundation(WMF)处理 Windows 平台上的标准声频/视频播放。然而也可对 WMF 进行扩展。 WMF 默认支持许多不同格式、编码和文件容器,也可使用网络上下载和安装的代码包进行延展。 然而这意味着部分用户可能没有解码和播放某种媒体文件的特定编码解码器。

在过去的版本中,虚幻引擎只支持 WMF 提供的默认编码解码器,确保所有用户均可以相同方式对媒体进行处理和加工。 也许您希望在自己的游戏中使用不同的媒体编码方法或属于您自己的媒体编码器(例如您发布的游戏中包含所需编码器的安装程序)。

在当前版本中可从 Project SettingsPlugins 部分启用并允许 WMF Media 的非标准编码解码器。

ProjectSettings.png

播放器插件将默认尝试检测操作系统不支持的音频和视频编码解码器,并要求用户安装额外的编码解码器包。 如访问媒体时播放器插件检测到不支持的格式,Output Log 中将出现警告消息。

UnsupportedLog.png

此外,还可在 Info 面板的 Media Player 资源中查看媒体资源信息。

MediaInfo.png

启用 Allow non-supported codecs 后,插件播放器将跳过检查,允许使用非标准编码解码器。

故障排除

多数播放器插件将提供潜在问题的详细日志。如需启用此功能,在项目的 Engine.ini 文件中添加以下代码:

[Core.Log]
LogMedia=Verbose
LogMediaAssets=Verbose
LogAndroidMedia=Verbose
LogAvfMedia=Verbose
LogMfMedia=Verbose
LogPS4Media=Verbose
LogWmfMedia=Verbose

如媒体源无法打开或播放,可在 开发者工具 中的 输出日志 下查阅详细说明。

LogMessage.png

也可在媒体播放器资源和 Info 标签中查看媒体源相关的信息。 这将显示媒体源可用的选项(Forward/Reverse Rates nad Scrubbing/Seeking)、不同音频和视频流,以及每个流的信息。

InfoWindow.png

如媒体资源日志类别已启用 Verbose Logging,此信息也将被添加至输出日志。

Windows

基于 Windows Media Foundation(WMF)播放器插件 WmfMedia 存在大量 MP4 容器限制。

可在微软官网的 MPEG-4 File Source 页面查阅更多内容。

已知问题与限制

媒体框架 仍为实验性功能,存在以下已知问题和限制。

  • Android

    • 声频当前通过操作系统进行播放,无法通过 UE4 的声音系统进行传送。

  • Audio

    • 当前没有声频范例的同步,因此播放可能出现不同步。

      • 解决方法:尽量使用较短的片段。

    • 声频当前固定被混合到 16 位立体声 44.1 kHz,无视输入格式。

      • 技术人员正在研究多通道声频支持,可能将其加入之后的版本中。

  • 编辑器

    • 媒体播放器中的播放列表 UI 只显示当前打开的媒体播放列表资源。

      • 解决方法:双击 MediaPlaylist 资源将其在自身的编辑器中打开。

  • Sequencer

    • 从 Sequencer 录制动画时,媒体播放无法正常渲染。

      • 我们知道它的重要性,因此已纳入日程,计划在之后的版本中发布。

  • Windows

    • 媒体播放器状态机仍在开发过程中。如同时发出多个控制命令,则可能出现问题。

      • 解决方法:建议在命令之间插入短暂延迟,为播放器留出处理时间。

    • 部分带有多个音频轨迹的视频无法打开。

    • Windows 7 和更新操作系统上的 QuickTime 影片(.mov)支持在当前版本中可靠性较低。

      • 解决方法:不推荐在当前版本中使用此格式。