To help developers easily optimizing applications performance data, Qiyu Performance Tool provides reference and guideline performance indicators which include FPS, Eye buffer Width and Height, Memory Utilization, GPU Utilization, CPU Utilization, Temperature, Invalid frames and other important information.
Developers can download the "QIYU Performance Tool" through the QIYU developer Portal, and copy to ./sdcard/ on QIYU device or using adb install to install the Tool. The tool provides the functions below：
1.1 Enable Persistent Overlay
To enable/disable Data and Graph.
1.2 Record All Captured Metrics to CSV Files
To record all captured Metrics to CSV file. After enable the function, the Performance Tool will write the performance data into CSV file at a rate of one time per second. The CSV file will be stored in ./sdcard/Performance/. The file name is "performance-packagename-date-time.csv".
1.3 Display Data on Overlay
To display the real-time data on Overlay, the “Enable Persistent Overlay” should be enabled firstly.
1.4 Display Graph on Overlay
To display the graph on Overlay, the “Enable Persistent Overlay” should be enabled firstly.
Qiyu Performance Tool provides data of application and record below:
| STATS | Explanation | Abbreviation | Recommended |
|---|---|---|---|
| Time Stamp (ms) | Time Stamp（ms） | TS | / |
| FPS (Hz) | FPS | FPS | 72 |
| CPULevel | CPU Level | CPU L | The CPU Level from project: Minimum：1 Medium：2（Recommend） Maximum：3 |
| GPULevel | GPU Level | GPU L | The GPU Level from Project Settings: Minimum：1 Medium：2（Recommend） Maximum：3 |
| EyeBufferWidth | Eye Buffer Width | EB W | QIYU3 dev kits: Please refer to EyeBuffer Scale (Unity (opens new window), Unreal (opens new window)), EB W= 1512 QIYU Dream: W= 1288 |
| EyeBufferHeight | Eye Buffer Height | EB H | QIYU3 dev kits: Please refer to EyeBuffer Scale(Unity (opens new window), Unreal (opens new window)), EB H= 1512 QIYU Dream: H=1449 |
| DisplayRefreshRate（Hz） | Display Refresh Rate（Hz） | DRR | 72 |
| InvalidFrame | Invalid Frame within 1 second | INVALID | 0 |
| FrameTime（ms） | Frame Time | T | 1000(ms)/FPS |
| SystemRenderTime（ms） | System Rendering Time | SR T | ≤12 |
| CPUFrameTime（ms） | CPU Frame Time | CPU T | <4 |
| Singlepass（Multiview） | Singlepass Disable: 0 Enable: 1 | SP | The Rendering Mode (Unity (opens new window), Unreal) (opens new window) from Project Settings: Multi Pass: 0 Multiview: 1 (Recommand) |
| Foveation level | FR Level Disable: -1 Low:0 Medium: 1 High:2 | FRL | The Foveation Level (Unity (opens new window), Unreal (opens new window)) from Project Setting: None：-1 Low：0（Recommand） Med：1 High：2 |
| CPU Utilization(%) | CPU Utilization | CPU U | ＜80% |
| GPU Utilization(%) | GPU Utilization | GPU U | <80% |
| Used Memory（MB） | Used Memory | U MEM | <1300MB |
| Free Memory（MB） | Available Memory | A MEM | ＞300MB |
| CPU Temperature（℃） | CPU Temperature | CPU Temp | <95 |
| GPU Temperature（℃） | GPU Temperature | GPU Temp | <95 |
Developers can check the corresponding selections as needed. For example, if the application frame rate is insufficient, You can determine whether to optimize CPU or GPU by analyzing CPUFrameTime value.
For performance optimization guidelines, please refer to the following below:
For unity developers, please refer to: 9. Performance and Optimization | QIYU developer document (iqiyi. Com) (opens new window)
For unreal developers, please refer to: Optimization and Development Best Practices for Mobile | Unreal Engine Document (opens new window)
The Performance Tool can be not only controlled by the windows buttons, but also by using adb commands.
Note: Please install and start the Qiyu Performance Tool before using the ADB Commands below:
3.1 Enable Persistent Overlay
adb shell setprop persist.sys.metricstool.overlay (true|false)
3.2 Record all captured metrics to csv files
adb shell setprop persist.sys.metricstool.recordCSV (true|false)
3.3 Display Data on Overlay
adb shell setprop persist.sys.metricstool.enableStats (true|false)
3.4 Display Graph on Overlay
adb shell setprop persist.sys.metricstool.enableGraph (true|false)
