质量平台帮助文档

# 使用说明

# 移动端

# 连接手机

Perfeye在使用之前需要确保Android设备需开启USB调试,iOS设备需使用iTunes连接手机。

设备后的标识，分别代表USB/WIFI连接模式，选择WIFI连接后记得拔出USB数据线。

  • USB模式测试：
    • USB连线后，在设备列表选择USB图标设备进行USB模式测试。
  • WIFI模式测试：
    • USB连线后，在设备列表选择WIFI图标设备进行WIFI模式测试。WIFI检测连接成功后，拔掉USB连接线。
  • 注：
    • 在WIFI模式下，IOS版本小于等于11的苹果设备，不能使用IP直连模式（即直接输入IP地址），必须让手机和电脑处于同一个子网内（在我们公司必须使用USB网卡来实现）。
    • 因部分Android设备USB断开时会断开数据采集，建议Android设备拔出usb连接后再选择测试应用。

# 选择测试应用

设备连接后，点击App List会显示手机全部应用，选择目标应用，开始测试。

# 录制保存

点击左上角Start/Stop 按钮，可以开始结束录制，然后进行保存

# 框选保存

除录制保存外，可转为框选模式，框选需要数据，反键保存。

# 添加标签

双击曲线图需要添加标签的时间,添加标签

# 增加 label

可通过新增 label 段,来划分场景

# 数据浏览

可通过右上角的放大缩小重置和自动滚动以及鼠标拖动曲线图进行浏览.

# 设置测试标准

可通过设置测试标准,控制导出 Excel 的统计结果

# 停止监控

可通过正上方按钮停止软件监控

# 界面按钮

界面各个按钮的具体功能详见界面说明

# PC端

# 运行Perfeye

Perfeye要确保以管理员权限运行才可以采集GPU相关数据以及监控以管理员权限启动的应用程序。

# 连接本地PC

设备列表中 localhost 即为连接本地PC。

连接上本地PC后，本程序会自动启动另外一个程序 TechPowerUp GPU-Z，未安装的会启动安装程序。

# 选择测试应用

连接上本地PC后，点击App List会显示全部应用进程，可以通过进程名称或PID来搜索目标应用进程，选择目标应用进程，开始测试。

# 录制保存

点击左上角Start/Stop 按钮，可以开始结束录制，然后进行保存。

# 框选保存

除录制保存外，还可以切换到框选模式，框选需要数据，右键保存。

# 添加标签

双击曲线图需要添加标签的时间,添加标签

# 增加label

可通过新增label段,来划分场景

# 数据浏览

可通过右上角的放大缩小重置和自动滚动以及鼠标拖动曲线图进行浏览.

# 设置测试标准

可通过设置测试标准,控制导出Excel的统计结果

# 停止监控

可通过正上方按钮停止软件监控

# 界面按钮

界面各个按钮的具体功能详见界面说明

# Xbox端

# XBOX GDK安装

  • 需要GDK版本>= 2024

# GDK环境变量配置

  • 一般GDK的安装目录为C:\Program Files (x86)\Microsoft GDK\bin


# .NET8.0安装

  • 安装完成后需要重启设备

# 安装成功后检查

# .NET安装检查

# GDK安装检查

# GDK环境变量设置检查

# PS5端

# PS5 SDK安装

# 1.PS5 SDK下载

Tips1：3.3.3+只支持11版本PS5 SDk
Tips2：已安装sdk7.0版本的设备建议先卸载7.0后再安装sdk11

# 2.PS5 SDK安装

解压zip包，双击 SDK_Manager.exe，按下方选项安装SDK,如无特殊情况,可点击Suggested Packages按钮默认安装

# 3.PS5 SDK安装检查

检查环境变量是否正确配置好PS5 SDK

# 4.RazorCPU Live for PS5设置

  • 打开Razor CPU Live for PS5，点击“Configure session”，关闭图下采样数据
  • 点击“Frames”窗口，关闭Freams数据采样
  • 打开Razor CPU for PS5，点击“Capture Options”，关闭图下采样数据

# PS5 设备数据采集

# 1.连接设备

  • 设备列表选择PS5设备
  • 输入PS5设备IP以进行连接

# 2.开始采集数据

应用列表选择运行中的游戏开始采集数据

Tips1: 当采集目标应用未运行时返回错误码-2
Tips2: 开始采集后需等待约10来秒才开始有数据返回和展示

# 3.保存采集数据

  • 点击左上角录制按钮开始数据采集录制，录制中点击左上角结束录制按钮停止录制,点击save按钮保存数据

# Switch端

# Nintendo开发者套件安装

因数据采集模块基于Switch开发者套件，故需要硬件要求如下：

  • Windows操作系统

  • 安装Nintendo开发者套件及配套的内部软件

  • 环境依赖检查通过

# 项目dev包接入GPM SDK

# Switch 设备数据采集

  1. 打开Switch官方自带的Target Manager工具，连接用于测试的Switch红盒子，保证连接状态为Connected。
  1. Perfeye连接Switch设备，输入白盒子IP,连接设备,准备开始测试

  1. switch启动游戏后, Perfeye选择目标应用开始监控。

# 关于Perfeye客户端自身占用CPU高的问题说明

  1. 一般情况下，Perfeye客户端在采集数据的时候会占用大概总CPU的4%左右，对被测进程的CPU占用影响较小。
  2. 当用户将鼠标放到客户端内曲线图表区域移动鼠标时(onMouseOver)，客户端会提供一个实时数据预览的功能，该功能会绘制一条白色的竖线，以及这条线上所有模块的具体数值（包括截图），测试结果显示该功能比较耗性能，大概需要占用总CPU的10%~30%左右。 如果不希望影响测试数据，建议在采集数据期间不要将鼠标在曲线图上【频繁】移动并触发该功能。

(备注：Perfeye该功能大概会占用总CPU的10%30%左右，性能狗该功能大概会占用总CPU的10%20%左右, 测试环境：Windows 10，i5-4590 CPU)

上次更新: 2026/1/30 11:51:27

← 参数说明 →