Vue3 + UE4+ 像素流 + 交互 的开发构建流程

一    
    
    
    
    
、像素流

1    


     


     


     


     


、将对应 UE 4.27 版本的 webRtcPlayer.js 复制到项目的 public/ue 文件夹下（作为静态资源） 2




 




 




 




 




 、根目录下的 index.html 中引入 ue/webRtcPlayer.js

index.html 中引入 webRtcPlayer.js

3   

   

   

   

   
、将对应 UE 4.27 版本的 app.js 复制到项目的 main.ts 同级目录下   
    
    
    
    
，可以改名为 ueapp.js 4     

     

     

     

     

、修改 ueapp.js 中的内容


     


     


     


     


     ，用于解决开发中的报错问题 1




  




  




  




  




 、新增导出（webrtc 对象可以将 ueapp.js 中定义的 function 都导出 




 




 




 




 



，这里只初步导出了五个函数/对象）

这里目前只初步导出了 ueapp.js 中的 load
  


  


  


  


  
、resizePlayerStyle     
     
     
     
     
、emitUIInteraction 等方法    
    
    
    
    
。有需要的话   

   

   

   

   

，还可以继续导出所需要的方法    


     


     


     


     


。

var temp = new window.webRtcPlayer({}) var webrtc = { load: load, webRtcPlayer: temp, resizePlayerStyle: resizePlayerStyle, emitUIInteraction: emitUIInteraction, onConfig: onConfig } export default { webrtc } 2 




   




   




   




   




 、添加初始变量定义

ueapp.js 中

     

     

     

     

    ，有些变量没有定义就直接在函数中使用了
  




  




  




  




  


，这将导致在运行使用时的报错  


  


  


  


  


，需要增加定义：

// 新增 let unquantizeAndDenormalizeUnsigned = null let receivedBytesMeasurement = null let receivedBytes = null let Data = null let gamepad = null 3

 



 



 



 



 
、修改 websocket 地址（要和启动的 打包后的 ue 的 exe 的云渲染的网络地址一致）

本地启动打包后的云渲染的 run.bat 后 
     
     
     
     
   ，在本机浏览器上输入的地址是：localhost

   




   




   




   




   

，也就是 http://127.0.0.1

那么 需要修改 ueapp.js 中 websocket 中对应的地址:

// ws = new WebSocket( // window.location.href // .replace("http://", "ws://") // .replace("https://", "wss://") // ) ws = new WebSocket("ws://127.0.0.1") 4                         、修复引用 play.png 问题

将 showPlayOverlay 中的 createElement(“img    
    
    
    
    
”) 屏蔽掉




 




 




 




 




 。

5  




    




    




    




    




 、main.ts 中引入 ueapp.js

引入 ueapp.js 



 



 



 



 



，并使用 vue3 的语法：app.provide                        ，注册 WebRtc 的全局属性


    




    




    




    




    
，用于方便在 vue 文件中直接调用使用   

   

   

   

   
。

6























、webRtcPlayer.js 中修改视频为静音
























，实现数据流直接播放效果

云渲染/像素流推送的本质是视频播放     

     

     

     

     

。

在最新版的 Chrome浏览器（以及所有以 Chromium 为内核的浏览器）中                        ，已不再允许自动播放音频和视频




  




  




  




  




 。就算为 video 或audi o标签设置了 autoplay 属性也一样不能自动播放
  


  


  


  


  
。

因此想要视频流在网页加载时自动播放


     



     



     



     



     ，就需要设置 video 的 muted 属性为 true     
     
     
     
     
。即声音为静音模式 




   




   




   




   




 。

如果本身游戏引擎是有音效的
























，可以在网页加载后的一定时间内   
    
    
    
    
，再将 video 的 muted 设置为 false


     


     


     


     


     ，之后用户可以调整系统音量 




 




 




 




 



，实现音效的展示

 



 



 



 



 
。

7                         、修改 ueapp.js   

   

   

   

   

，实现支持自动播放（不用再手动点击） 8   



     



     



     



     



 、复制 player.html 中的 完整 div 到 vue 文件中

     

     

     

     

    ，并修改 id=“overlay    


     


     


     


     


” 的 div 的 display 为 collapse 9























、vue 文件中调用像素流方法 10    
    
    
    
    
、至此
  




  




  




  




  


，就可以看到启动 vue 项目时  


  


  


  


  


，页面展示游戏引擎的界面了

注意：需要首先启动打包后的 UE 游戏引擎 exe 和 run.bat 开启像素流送                         。

效果如下：

二    


     


     


     


     


、游戏引擎 实时交互

以上的验证过程 
     
     
     
     
   ，是基于打包后的游戏引擎的  




    




    




    




    




 。对于正在开发中的 UE4 项目

   




   




   




   




   

，以及实现 vue 和 游戏引擎的相互发消息的交互机制 



 



 



 



 



，还尚未实现























。下面                        ，就介绍如何实现与项目的实时交互                         。

1




 




 




 




 




 、游戏引擎以 Standalone Game 的方式启动 2   

   

   

   

   
、找到对应的 UE 4.27 的版本的 SignallingWebServer


    




    




    




    




    
，将其复制到无特殊字符     

     

     

     

     

、中文名称等的路径下

以保证 SignallingWebServer 的像素流服务可以正常启动   



     



     



     



     



 。

3




  




  




  




  




 、找到复制后的路径下：SignallingWebServer/platform_scripts/cmd/run_local.bat
























，以管理员身份运行 run_local.bat

注意：run_local.bat 默认以 80 端口                        ，若有其他程序占用了 80 端口


     



     



     



     



     ，则 run_local.bat 将会运行错误或失败
























，需要移除占用的端口的软件   
    
    
    
    
，再重新以管理员身份运行 run_local.bat























。

运行成功


     


     


     


     


     ，将会如下所示：

此时当 以 Standalone Game 方式运行了游戏引擎 




 




 




 




 



，且运行了 run_local.bat   

   

   

   

   

，那么将可以在网页中输入 localhost:80

     

     

     

     

    ，在线访问游戏引擎界面：

4
  


  


  


  


  
、运行 vue 项目

此时可以看到
  




  




  




  




  


，运行后  


  


  


  


  


，vue 项目也可以正常访问到游戏引擎界面    
    
    
    
    
。只不过界面并不是全屏的 
     
     
     
     
   ，需要在代码中做一些样式调整

   




   




   




   




   

，使游戏引擎界面铺满全屏    


     


     


     


     


。

这里 vue 项目可以访问游戏引擎界面的原因在于 



 



 



 



 



，我们在 ueapp.js 中修改了对应的 WebSocket 地址




 




 




 




 




 。

1     
     
     
     
     
、调整游戏引擎界面占满全屏

修改 webRtcPlayer.js 中的 video 的 style   

   

   

   

   
。

var video = document.createElement("video") video.id = "streamingVideo" video.playsInline = true video.disablepictureinpicture = true video.muted = true // self.startVideoMuted video.style.width = "100vw" video.style.height = "100vh" video.style.objectFit = "fill"

这样就有占满全屏的效果了     

     

     

     

     

。

5 




   




   




   




   




 、游戏引擎 和 Vue 的通信机制 1

 



 



 



 



 
、消息通信的原理

Vue 和 UE 相互通信的原理是借助于 WebSocket                        ，利用像素流启动服务（run_local.bat）


    




    




    




    




    
，Vue 和 UE 同时监听像素流服务的地址                         、端口
























，通过 WebSocket 相互发送  




    




    




    




    




 、监听消息                        ，再利用各自的对于消息的处理方法


     



     



     



     



     ，进行消息的处理与响应




  




  




  




  




 。

而具体的方法就是 调用 emitUIInteraction 方法 和 addResponseEventListener 方法
























，前者用于从 JS/Vue 向 UE 发消息   
    
    
    
    
，后者用于接收























、处理 从 UE 向 JS/Vue 发的消息
  


  


  


  


  
。

完整蓝图事件：

至此就完成了


     


     


     


     


     ，Vue 和 UE 相互通信以及通信消息的响应处理     
     
     
     
     
。

效果如下：

三                         、参考资料

【UE4】一个实现Web穿透 




 




 




 




 



，用HTML开发UI的方式——WebUI的用法

[Vue3] TS7016: Could not find a declaration file for module ‘…/assets/js/util.js‘

jQuery报错 Uncaught (in promise) DOMException: play() failed because the user didn‘t interact

Vue框架中页面和UE4交互的方法

Vue.js集成UE4像素流自定义网页的实现方式

VUE与UE5 像素流送

vue项目与ue交互

ue4之WebUI与引擎之间的通信

UE4.27 UE5 像素流送新人向教程   

   

   

   

   

，手把手带你避坑

UE4与前端通信方式

【数字孪生】UE4虚幻引擎与前端Web页面的结合

ue4之mesh点击事件触发切换材质

开源篇-WebSocket搭建UE5通信桥梁

徒手搭建VUE3项目(四)：开启全局websocket

UE4使用websocket建立通信

     

     

     

     

    ，获取实时数据

UE像素流送   



     



     



     



     



 、 交互

UE4.27 UE5 像素流送新人向教程
  




  




  




  




  


，手把手带你避坑

UE4 PixelStreaming与UE4之间的通讯笔记

PixelStreaming数据通信

Unreal——像素流送播放器页面与 UE 通信

自定义播放器网页 5.0

在 UE4 蓝图中如何使用委托作为参数

自定义播放器网页 4.27

UE4像素流送PixelStreaming_ue4像素流到移动端可以吗_WindRushToNight的博客-CSDN博客

VUE与UE5 像素流送

UE4-PixelStreaming（虚幻引擎4-像素流）笔记

【自制】UE4蓝图中使用Json的插件

UE5的像素流程序打包