做三维展示和场景可视化时最常被提的需求就是把一段视频“放”到三维空间里展馆大屏、产品演示屏、背景电视墙、HUD界面什么地方都有。视频一多以前常用的做法是转序列帧一个30秒短片拆成几百张图导入慢、打包大、运行内存也浪费。直到后来我在引擎里接触了Electra Player这类播放插件直接在场景里播放MP4文件不仅不用折腾序列帧连声音也能一起走通整个流程比想象中简单不少。这篇保姆级教程围绕一个完整场景展开MP4怎么导入、媒体播放器/媒体源/媒体纹理怎么建立、蓝图怎么控制播放、声音怎么挂上去以及打包后不亮不响的问题怎么排查。最后再补充一些多屏拼接和动态加载的扩展思路。适合刚接触引擎的美术、技术美术以及需要把视频播放方案落到实际项目里的开发者不管你是想做个LED屏还是想放背景视频这套流程都能直接参考。1. 动手之前先把插件的开关和素材规格搞清楚1.1 找到Electra Player并正确开启Electra Player在引擎的项目里是以插件形式存在的。打开任意一个项目在顶部菜单找到“编辑 → 插件”在搜索框输入Electra就能看到对应的插件项。把它启用重启编辑器插件才真正生效。这一步很多人会忽略结果后边创建媒体资产时右键菜单里根本找不到对应的媒体分类。用C项目还得多留个心眼。插件启用后如果项目是源码版或者做了分模块处理需要编译一次纯蓝图项目重启就够了。另外如果这个项目最终要打包给其他机器用建议在开发机上也保持插件开启状态不要只在某一台机器上启用后干净利落打包否则另一台机器打开项目时可能提示缺少模块。注意每次操作插件开关后编辑器都会要求重启。不要嫌麻烦跳过很多“右键找不到媒体源”的问题就是没重启造成的。1.2 先理解四个容易混淆的资产在真正动手之前先把几个核心概念捋清楚。视频文件不是拖进引擎场景就能直接显示的必须经过中间层。最常用的四个东西分别是媒体源、媒体播放器、媒体纹理、媒体声音。可以用一个看电影的类比来理解媒体源相当于“片源”它指向MP4文件所在的位置告诉引擎从哪里读取视频数据。媒体播放器相当于“播放机”负责控制播放、暂停、跳转、循环这些逻辑。媒体纹理相当于“显示屏画面”播放器解码后的图像会写入到这里材质或UI控件再从这里把画面取走。媒体声音相当于“音箱”播放器解码出的音频通过它送到场景里发声。这四个角色是分层解耦的。同一个MP4可以被多个媒体纹理使用也可以用多个声音组件播放互不影响。刚开始用的时候不用想得太复杂记住一点就行导入MP4文件后需要先让媒体源指向这个文件再用媒体播放器去把源打开打开之后画面自动进媒体纹理声音自动进媒体声音。1.3 视频文件准备的规格建议很多项目一开始拿到的原始视频动辄4K、60帧、上百兆码率直接拖进引擎也能用但一跑起来就卡成幻灯片。我的建议是导入前就做一次统一转码能省掉后面一大半麻烦。格式上首选MP4编码选H.264音频选AAC。这两个最稳兼容性也好。帧率控制在30帧就够了除非你确实需要慢动作回放否则60帧视频在引擎里并没有额外意义只会白白增加解码压力。分辨率按实际显示尺寸来选场景里如果只是一个小屏幕用1080p甚至720p就够如果是整面墙的大屏再看输出需求决定2K还是4K。文件名也很有讲究。给视频命名尽量用英文和数字用下划线连接不要带空格不要用中文也不要有特殊符号。我踩过一次坑文件名里带了个中文括号编辑器里正常打包到另一边之后就抓不到路径。这类问题排查起来极其隐蔽能避免就避免。文件位置我习惯放在Content/Video目录下单独建一个文件夹管理。这样打包时默认会跟着内容一起进包后面做资源引用也比较清晰。2. 创建视频播放三件套媒体播放器、媒体源、媒体纹理2.1 右键创建媒体播放器在内容浏览器里进入刚才建好的Video文件夹右键选择“媒体 → 媒体播放器”。引擎会弹出一个创建对话框里面有一个“创建媒体纹理”的选项直接勾上。这样会一次性生成两个资产一个媒体播放器一个媒体纹理。命名建议一眼能看懂用途。比如展示视频叫MediaPlayer_MainScreen对应的纹理叫MediaTexture_MainScreen。项目里视频一多命名规范能救命否则后面在材质里挑纹理时满屏都是MediaTexture_1、MediaTexture_2根本分不清哪个对应哪个。生成的媒体纹理默认会自动绑定这个媒体播放器不需要手动指定。这一点很重要后面在UI和材质里只要把媒体纹理拿过去用就行不用再考虑怎么建立关联。2.2 配置媒体源并绑定MP4接下来还是右键选择“媒体 → 媒体源”。这个资产负责告诉播放器视频文件在哪。双击打开媒体源资产里面有一个文件路径的设置项把刚才准备的MP4文件指定进去。这里有一个关键选择相对路径还是绝对路径。绝对路径写的是本机完整目录编辑器里一切正常但项目拷到另一台电脑或者打包后路径就对不上了视频自然打不开。相对路径相对于项目的目录来定位文件打包后只要文件在包里基本都能正确加载。我的建议很简单只要视频放在Content目录下一律用相对路径。如果视频放在项目外的位置比如某个素材库文件夹那种情况另行处理后边第五部分会专门说。配置完成后如果路径有效资产上会正常显示文件名如果看到红色状态提示多半是路径写错了或者文件名大小写对不上检查一下再继续。2.3 用蓝图把三件套串起来到这里文件有了、媒体源有了、媒体播放器有了还差关键一步在运行时打开媒体源并开始播放。常见做法是直接在关卡蓝图里操作。先创建一个变量类型选之前建的媒体播放器资产然后在Event BeginPlay后执行Open Source节点输入参数就是刚才创建的媒体源。成功打开后再调用Play节点。如果希望视频循环播放可以在媒体播放器资产的属性里把“循环”打开也可以直接在蓝图里设置循环标志。这里有一个值得注意的小细节Open Source和Play是异步过程。直接紧挨着调用多数时候没问题但在部分设备上会偶发“画面黑屏但音频开始播放”或者反过来。稳妥的做法是绑定媒体播放器的OnMediaOpened事件在这个事件触发后再调用Play这样就能保证媒体文件真正准备好才播放。关键节点顺序参考 1. MediaPlayer - Open Source指定MediaSource 2. MediaPlayer - OnMediaOpened事件绑定 3. 事件触发后 - MediaPlayer - Play 4. 设置Loop循环为true3. 把画面放到屏幕上UI、材质和声音3.1 先决定用UI还是世界材质视频画面显示有两种常用方案UI和世界空间材质。两者各有应用场景做项目前最好先想清楚。对比项UMG界面显示世界空间材质适用位置屏幕角落、加载界面、HUD场景里的电视、LED屏、玻璃、墙面交互性容易叠按钮、进度条需要额外做交互逻辑多屏扩展每个控件独立对应一个纹理可以用UV切割做视频墙被遮挡关系永远在最上层跟场景一样有前后遮挡性能感受UI刷新频率高时消耗不小材质采样开销相对可控简而言之需要在HUD上显示画面就选UI需要在场景里做一个“真实的屏幕”就选材质。也有两者结合的方案视频画面贴到场景里的模型上同时用一个UI把同款视频叠加在窗口顶层保持画面内容一致。但这种做法会消耗两个视频流的资源除非特殊需求否则不建议。3.2 在UMG里显示视频画面打开控件蓝图在画布上添加一个Image控件然后在右侧详情面板找到Brush区域把之前创建的媒体纹理拖进去。这样这个Image在运行时就会持续显示视频画面。有几个细节容易出问题。Image的尺寸要设置一个确定值或者用拉伸模式填满父容器如果运行时画面不更新先检查媒体纹理有没有正确赋给Brush再检查媒体播放器有没有真正进入播放状态。还有一个常见坑UMG里的Image默认用的是白色着色如果视频本身是偏暗的影片可以在Brush的Color和Opacity里把颜色调成白色或者稍微偏亮否则视频看起来比原片暗一截。如果你想在视频画面上叠加文字、Logo、进度条直接在Image上面再放别的控件就行全部都在同一层UI里控制起来非常方便。3.3 在世界空间材质里显示视频场景里放一个平面模型、一个弧形屏幕模型或者一个长方体设备然后给模型指定一个材质在材质节点图里用TextureSample节点采样媒体纹理并将结果连到自发光颜色或者基础颜色。多数情况我喜欢连到自发光颜色这样视频自身亮度就出来了不受场景灯光影响做屏幕效果更干净。把媒体纹理拖进材质前注意纹理组的Mip生成设置。视频纹理和普通贴图不同普通贴图可以做MipMap来优化远景但视频纹理如果开了Mip生成运行时远处的画面偶尔会出现闪烁或马赛克。稳妥做法是把这个纹理的MipGenMode改为“无Mip”或者直接关闭纹理组设置。材质做好后赋给模型。如果需要双面显示比如一块悬浮的全息屏从背面也能看到内容材质里把“双面”打开。如果视频被拉伸变形就需要调整UV平铺或者模型坐标把画面比例压回正常。3.4 让声音出来的正确接法视频画面有了音频不会自动响。很多人第一次接视频时都会问为什么画面正常但没有声音因为在引擎里音频需要额外一个链路媒体声音资产组件。在内容浏览器右键创建“媒体声音”资产然后需要在场景里放置一个Actor给它添加“媒体声音”组件。如果场景里已经有合适的Actor比如那台“电视机的灯板模型”直接把组件挂上去也行。组件添加后在组件的属性面板里把“媒体播放器”指定为之前创建的媒体播放器资产。这样当蓝图调用Play时音频就会通过这个组件播放出来。默认情况下声音是3D空间音效离模型越远声音越轻。如果只是想在场景里均匀听到把组件属性里的Attenuation衰减设置为空或者把音量开大一点。注意声音组件必须和被播放的媒体播放器关联。如果你在UMG里看到一个视频并且想让它也有声音也要往场景里放一个带媒体声音组件的Actor这个组件挂哪都行跟UI画面本身不冲突。4. 常见问题排查和打包避坑4.1 黑屏排查步骤视频不亮是最常见的问题。碰到黑屏不要慌按照下面的顺序排查能节省很多时间。先确认媒体播放器有没有成功打开媒体源。在蓝图里加几个PrintString节点在Open Source之前打一条在OnMediaOpened事件里再打一条。如果事件没触发说明源没打开检查媒体源的路径和文件格式。如果事件触发了但没有画面问题大概率出在材质或者UI上。现象可能原因处理方式编辑器正常打包后黑屏媒体源用了绝对路径或文件未进包改成相对路径检查打包设置材质黑屏但UI正常材质里没有连接MediaTexture检查TextureSample节点连接画面一直不动播放器没有Open Source或没Play检查蓝图调用逻辑画面闪烁或花屏视频纹理Mip问题或码率过高关闭Mip生成降低分辨率还要注意一个交互上的细节如果你在编辑器里预览过然后在暂停状态直接关掉编辑器又重新打开媒体播放器可能会残留之前的“打开失败”状态。遇到这种情况把媒体播放器资产重新赋值一遍或者在运行时重新调用Open Source一般就恢复了。4.2 没有声音的检查清单画面正常但没有声音时按下面几个检查场景里有没有添加媒体声音组件没有就补。媒体声音组件有没有正确指定媒体播放器经常有人漏了这一步。媒体播放器生命周期里是否执行了Play有时候画面已经出来了但声音没开始是因为播放器状态没有完全启动。音量设置是否正常如果使用默认3D衰减人和声源距离远会听不到试一下关闭衰减。视频文件本身有没有音轨有些转码工具默认会把音轨去掉或者音轨编码不是AAC导致插件识别不出来。我见过一个比较隐蔽的情况视频本身有声音编辑器预览也正常但打包后声音没了。后来发现是媒体声音组件在打包时被引擎优化掉了原因是它在场景中没有实际用途或者实例没有预加载。解决办法是在关卡蓝图里做一个初始化主动引用一次媒体播放器和媒体声音资产强制让它在运行时被加载。4.3 打包后MP4文件消失或者打不开MP4文件放在Content目录下默认会打包进Pak文件。但如果你用的是外部视频路径或者视频文件动态更新频繁打包后很容易出问题。常见的原因是媒体源设置了绝对路径。在编辑器环境里绝对路径有效一到另一台机器就失效。解决方案就是前边强调的优先用相对路径。另外打包设置里确认一下内容目录是否被勾选包含。有些项目为了控制包体设置了排除目录结果整个Video文件夹被排除播放器自然找不到文件。打包体积也需要考虑。一个大型展项可能有好几个高清视频每个一两百MB加起来就是GB级别。如果视频内容要频繁更换不如把视频放在可写目录下运行时动态指定路径这样换内容只需要替换外部文件不需要重新打包。4.4 性能与卡顿的调优思路播放视频本身是解码密集型操作。H.264解码需要CPU或GPU参与场景中同时开两三个高清视频游戏线程压力会明显上升。项目里如果存在长时间卡顿优先看一下同时播放的视频路数。几个调优手段降低视频分辨率。1080p和4K的画面在多数中小屏场景里看不出差距但解码开销差好几倍。减少同时播放的数量。不做大屏拼接时尽量用“哪个播放器真正需要显示哪个才播放”不要在一开始把所有视频全部打开。视频不要长时间循环加载内存。超长视频可以考虑分段或者控制缓存但一般项目用不到那么极端。移动端或者集成显卡设备尽量用H.264编码解码器支持更稳。有一点经验之谈把视频画面放到材质里显示时屏幕模型的面数不要太高一个平面加适当的细分就够。有些美术为了“让屏幕更真实”加上大量细分和法线贴图结果视频播放时性能反而崩了跟播放器完全无关。5. 进一步玩法多屏同步、交互播放与后期维护5.1 一个视频源驱动多个屏幕展厅里常见一排屏幕播放同一段视频要求画面完全同步。最容易想到的方案是把同一个视频复制多份每个屏幕一个媒体播放器但这会带来解码开销而且不同播放器启动时间稍微错开画面就会出现几帧偏差。更好的做法是共享同一份媒体播放器输出。多个材质节点都去采样同一个媒体纹理理论上画面对齐是天然同步的。如果各屏幕摆放不同需要做视频内容切割时可以在材质里调整TextureCoordinate的偏移和缩放让每个屏幕只显示视频画面的一部分。这种视频墙方案对播放压力最小画面也最整齐。5.2 进入触发器自动播放离开自动暂停不少展示项目希望在玩家靠近时开始播放视频离开时暂停。这个效果实现起来不复杂在视频机位前放置一个TriggerBox在关卡蓝图里绑定重叠开始事件调用播放器的Play绑定重叠结束事件调用Pause。这里有两点提醒如果视频没有开启循环播放一遍结束后玩家再次进入触发器需要先重新Open Source再播放只调Play可能会没反应。多个触发器控制同一个播放器时要梳理好状态避免离开一个触发器把另一个触发器范围内的视频也暂停了。单独用一个标志位管理当前状态会稳妥一些。5.3 外部视频的动态加载与更新做展示项目时视频内容经常要改这周放A版本下周可能就换B版本。每次都打包整个项目不现实。这时可以放弃把视频打进Content目录而是放在项目外部的指定文件夹用媒体源去设定外部路径。这种方式的代价是分发部署更麻烦。原项目可以通过相对路径找外部文件夹但不同运行设备上盘符和目录可能不一样。一个折中方案是做一个小工具在启动时或者编辑器里把外部视频复制到项目可写目录再由媒体源指向这个可写目录这样既能在不重打包的情况下换内容又能保证运行时路径稳定。不同项目环境差异很大这个方案可以根据实际来调整。5.4 一点实战中的习惯我个人在实际操作中养成了几个习惯都是踩过坑之后才记住的。第一循环播放一定在媒体播放器资产属性里先把“循环”勾上而不是靠蓝图循环里反复调用播放否则视频播到最后一帧和第一帧之间偶尔会黑一下。第二设置OpenSource成功后我再执行Play不要硬等固定时间用事件驱动比用时间更可靠。第三如果一个视频既要显示在场景材质里又要在HUD上做一个缩略预览我会为两个显示区域分别创建媒体纹理而不是让它们共用同一个纹理。虽然都是同一个播放器输出但分开之后材质和UI之间的刷新互不影响视觉效果更稳定排查问题也更方便。Electra Player这套流程核心就是“文件 → 媒体源 → 播放器 → 纹理/声音”这一条链路。链路里的每一环都理解清楚了无论以后换项目、换视频格式、升级引擎版本只要你还能看到这几个资产就很快能重新接起来。