Unity UPR (Unity Performance Reporting)使用记录 （4）

///

UPR WebGL 测试教程

Editor打包

• 请在WebGL模式下打包时，勾选Development Build和Autoconnect Profiler选项。

UPR测试

• 请在新建测试时，勾选WebGL模式。

• 如果是在Editor内自动拉起的WebGL游戏，请在开始UPR测试前，关闭Editor的Profiler。

• 如果是从已打包的文件内开启WebGL游戏，可以使用以下命令

python -m http.server <port_number>

• 使用UPR Desktop进行测试时，请确保UPR Desktop 与用于Build的Unity项目在同一台机器上，同时用于测试的机器可以连通当前这台机器。

例如：在电脑A中build出对应的WebGL应用，那么UPR Desktop必须在电脑A中启动；如果在电脑B中访问WebGL应用，请保证电脑B可以连通电脑A；如果在电脑B上启动Server，并且在手机C上访问WebGL应用，请保证手机C可以连通电脑A。

在测试WebGL时，UPRDesktop为Profiler数据服务端，WebGL应用为客户端，因此必须先启动UPR Desktop，start成功之后再启动WebGL应用。如果已经启动了WebGL应用再开启UPR Desktop的话，需要刷新一下WebGL应用。

• 请确保进行UPR测试时，WebGL游戏处于focus状态，以免影响数据的收集。

• 由于浏览器内存限制问题，在WebGL模式下测试时，如果截取了对象快照或者内存快照，可能会存在快照截图缺失的现象。

用UPR测试微信小游戏

UPR维护的一个sample project，旨在帮助用户发现并解决在使用UPR在测试微信小游戏时所遇到的各类问题。

示例程序

• 下载地址 示例程序
• 项目包名 com.UnityTechnologies.BoatAttack, Tuanjie Editor 1.0.4
• 测试工具 UPR Desktop Windows 2.17.3.0（更好地支持了小游戏的连接）
• 已导入UPR Package 0.13.4 (用于收集更多信息，Minigame不支持Lua检测)
• 微信开发者工具+UPR 测试报告
• Android真机微信 + UPR 测试报告

项目简介

• 项目为团结引擎小游戏工程《不服咱碰碰》，主要用于Wechat Minigame的示例。

• 需要注意的是，在Build成minigame的时候，必须要勾选"development build" 和 “auto connect profiler”， 这是WebGL系列应用连接UPR或者Profiler的重要前提。

  

微信小游戏测试说明

修改微信AppId

• 示例程序下载成功后，解压zip后得到的minigame文件夹内为微信小游戏，可以使用微信开发者工具直接打开，其中上面设置的AppId为测试号，可以自行修改，否则在真机扫描预览二维码时可能没有权限预览。
• 修改 project.config.json 文件的appid和game.js 的APPID字段
• 注意这边需要的是微信小游戏AppId，不是微信小程序AppId

添加域名白名单

• 登录微信公众平台， 扫码登录，选择设定好的AppId登录，请设置好合法域名，以免Demo程序无法正常运行。
• 由于Demo项目使用了UOS CDN托管资源，请将相关域名(https://a.unity.cn; https://a.unity3dcloud.cn;)配置到域名白名单。

在微信模拟器打开

• 使用微信小程序模拟器打开，并且换上自己设定好的小游戏AppId
• 右下角的Console可能会有个无法连接到127.0.0.1:56001的报错，这个是由于导入了UPR Package导致的，这是正常的，请不用担心。

修改IP地址

• WebGL项目在打包Development Build过程中，会将打包机IP作为默认的Unity Profiler IP打进游戏包体中。
• 如果使用官方提供的打包好的项目，请将IP替换为运行UPR的电脑的IP。

请修改minigame目录下 webgl.wasm.framework.unityweb.js

ws = new WebSocketConstructor(url, opts);

找到这一行，在这行前面加上下面代码段

if (port == 54998){
    url = "ws://[Unity Profiler所在的IP地址 / 运行UPR客户端的电脑IP地址]:54998";
}

开始UPR测试

• 在UPR官网创建一个SessionId，注意，创建SessionId的时候，需要勾选WebGL模式（WebGL模式和普通模式不一样, Unity版本选择Tuanjie 1.0

• 在UPR中填入对应的SessionId，回车，无须在UPR中填写IP地址，因为WebGL程序会根据包体中的IP地址，主动向UPR客户端发起连接。

• 此时在UPR中点击Start，然后在微信小游戏中重新进入应用。

• 测试完成后，点击Stop结束测试即可

常见问题

UPR接受不到帧数据

• 确认一下build成minigame的时候是不是勾选了"development build"和 "auto connect profiler"这两个选项，如果没有勾选，minigame应用就不会连接UPR Desktop，就无法获取到帧数据了。
• 确认一下是否已经修改了需要连接的ip地址
• 确认一下测试的应用和连接的地址是否可以互相连通，比如在真机上设定了ip地址，但是手机和UPR所在的电脑无法互相连通
• 请更新最新版本的UPR Desktop
• 如果依旧无法解决问题，那请点击联系我们

为什么这个Demo在真机测试时无法获取截图

• 该Demo项目的截图是通过 UPR Package 进行获取的. 项目工程在Unity项目导出到小游戏之前已经设定了接受截图的 UPR Desktop 的IP地址为 127.0.0.1，所以该Demo项目在在真机上进行测试，无法无法通过该IP地址连接到 UPR Desktop，所以无法获取截图。但如果使用微信开发者模拟器 且测试时 UPR Desktop 处于同一台电脑，使用模拟器测试时可以正常获取到截图。

如何在自己的工程测试过程中获取截图

• 如果在自己项目工程中，导入 UPR Package 后， 确定启动 UPR Desktop 所在设备的IP地址后，可以在自己项目的 Assets/UPRTools/Scripts/NetworkServer.cs 文件中修改成对应的IP地址。

// 将 ip 替换成 upr 所在机器的 ip 地址
string address = string.Format("ws://{0}:{1}", ip, port);

/