Android Performance Tuner (APT) 与Memory Advice API

Android 性能调整器 (APT)Android 游戏开发工具包的一部分。

Android Performance Tuner (APT) 可帮助您在许多 Android 设备上大规模测量和优化帧速率、图形保真度、加载时间和加载放弃，从而为每位用户提供最佳体验。

它可以帮助您识别游戏或应用程序中的性能问题，并突出显示提高保真度的机会。影响指标可帮助您确定优先级，并对问题进行分类以帮助您采取行动。设备型号和设备规格级别的信息使您能够找到最有效的行动方式。

原生游戏入门Unity 游戏入门

有什么好处？

Android Performance Tuner (APT) 可帮助您为更多用户提供高质量的体验。

新的！了解您的加载时间及其对放弃的影响

APT 在多种装载（首次装载、冷装载、暖装载和层间装载）中跟踪您的装载时间和装载放弃。它向您展示了较长的加载时间对您的游戏放弃的影响，以便您确定最佳加载时间。

衡量用户体验的质量

APT 向您展示您的游戏在现实世界中的实际用户设备上的帧速率和加载时间性能，以便您直接了解他们的体验。所有指标都是根据您的目标定制的，因此您可以了解游戏相对于您的特定目标的表现。

诊断并优先处理您的游戏性能问题

帧速率和加载时间问题由您的质量级别和游戏内注释以及设备型号细分，以帮助您缩小根本原因。对于每个帧速率问题，您可以查看 GPU 时间和 CPU 时间，因此您可以评估可能需要哪种类型的优化。还会显示受影响的会话数，以便您了解对用户影响最大的因素，并决定首先关注哪些设备或游戏场景。

充分利用每台设备

除了解决性能率问题外，APT 还强调了通过提高已经表现良好但仍有进一步发展空间的设备的保真度来改善用户体验的机会。这使您能够确保每个用户都能获得最佳的游戏体验。

它是如何工作的？

Android Performance Tuner 适用于 Android Vitals。

Android Performance Tuner 记录并汇总您的游戏或应用的实时帧时间和加载信息，以及您提供的游戏注释和保真度参数。当您使用 Android Performance Tuner 发布游戏或应用版本时，此性能数据会上传到 Google Play，并在 Android Vitals 中解锁新的性能洞察。

要获得这些性能洞察，您必须将 Android Performance Tuner 集成到您的游戏或应用中，然后将其发布到 Google Play：

要求

对于设备：

Android Performance Tuner (APT) 可在运行 Android 4.1（API 级别 16）或更高版本的任何 Android 设备（有或没有 Google Play 服务）上运行。这占所有活跃 Android 设备的 99% 以上。

对于所有开发人员：

访问 Android Vitals产品仅适用于新版 Google Play 管理中心

Unity 开发人员的其他要求：

Unity 版本 .4 或更高版本和.NET 版本 4.6要使用 APK 扩展文件，需要 Unity .2为了改进帧节奏和 GPU 测量，需要 Unity 版本 .3.14 或更高版本

了解 Android 性能调整器

我们有代码实验室来指导您将 Android Performance Tuner 集成到您的游戏中，以实现 C/C++ 和 Unity 引擎的集成：

Codelab：将 Android Performance Tuner 集成到您的 C/C++ Android 游戏中Codelab：将 Android Performance Tuner 集成到您的 Unity 游戏中

C/C++ 和 Unity 引擎 SDK 的参考：

Android Performance Tuner C/C++ 参考Android Performance Tuner Unity 参考

Memory Advice API 概览

Memory Advice API 是一个实验性的索引 API，可帮助 Android 应用程序满足内存用量的安全限制。该 API 能够及时保持使用的内存资源量，可以在一定程度上向应用程序发出通知。该 API 还可以使用报告的内存使用量。

注意：您可以使用 Memory Advice API 替代onTrimMemory事件来管理内存。

该 API 提供的和生成的任何更改应用程序何时更改其内存内容，或为应用程序寻找改进空间。可能包括调整内存占用的资源，例如降低视觉音频的细节和质量。

ES 的 Advice 的 Advice 商城由内存分配的最多内存占用以及由 OpenGL API 分配的内存类型 API，内存类型和内存 API 应用

变化如下：

API采集的设备指标来自设备的机器学习数据设备测试

在 API 等级中，Memory Advice API 会定义常用的建议状态，并通过常用函数将这些状态传递给应用。

使用入门

情况

Memory Advice API 是 Android Game Development Kit (AGDK) 的一部分，然后通过以下传播：

库中的Android Games Jetpack文件版本。下载页面上的 AGDK 版本。AOSP上的源代码。

Android Games 版本适用于使用环境推荐的 Memory Advice API 版本。 Android Studio，我们建议使用 Jetpack 版本。Android Game Development Extension(AGDE)，我们使用 AGDK 下载建议页面的版本。

功能

本部分介绍了 Memory Advice API 的功能。

内存状态

该API会向应用报告以下内存状态：

MEMOYADVICE_STATE_OKMEMOYADVICE_STATE_APPROACHING_LIMITMEMOYADVICE_STATE_CRITICAL

了解详情，请查看memoryadvice_memorystate页面。

报告内存状态

该 API 支持通过轮询或智能报告内存状态：

询轮：

应用可以随时调用该 API 来检索内存状态。

建议：

应用内存建议 API 可以通过调用函数。应用频率为建议调用系统。该 API 会使用频率来确定应用内存限制安全限制或极低时执行此条件的时机。如果内存条件安全，则不能正常执行。不是从应用的线程中执行，而不是从应用的线程中执行。

常见和常见注意事项

内存建议使用计算时间来生成内存状态。但每次调用设备通常会调用 1 次 API 到 3 小时的紧急情况。此想。

要求

设备要求

Android 4.4（API 版本等级 19）或更高

应用要求

该API支持蒯应用（仅使用C/C++主要编写的应用）。

该 API 仅支持 64 位应用。

NDK 版本要求

Memory Advice API 版本支持大多数常见的 NDK 版本。请查看版本说明，查看受支持的 NDK 列表。

注意：完整的 AGDK 库下载内容支持添加其他版本的 NDK。

其他资源

Memory Advice API 版本说明Memory Advice API 参考文档GitHub 上的内存建议示例Memory Advice API 源代码

问题和反馈

Memory Advice API 目前欢迎发现有任何测试版阶段的问题，您可以反馈。如果有任何建议或正在使用 API 创建该问题，请在 Issueer 中的问题中找到。

Memory Advice API 使用入门

本指南介绍了如何使用 Android Studio 将Memory Advice API的Jetpack 版本集成到您的应用中。

Android Games 应使用为其构建环境推荐的 Memory Advice API 版本。对于 Android Studio，我们建议使用 Jetpack 版本。如需了解适用于其他构建环境（例如Android Game Development Extension(AGDE)）的版本，请参阅分发情况。

添加库

本部分介绍了如何将库添加到您的 Android Studio（Android Gradle 插件）项目中。

添加依赖项

若要将库添加到 Android Studio 项目，请完成以下步骤：

在项目级gradle.properties中启用 Android Jetpack 库，该文件通常位于项目的根目录中：

android.useAndroidX=true

打开模块级build.gradle文件，并将以下implementation添加到依赖项代码块中。这会在应用中声明Memory Advice API 依赖项。

dependencies {implementation 'androidx.games:games-memory-advice:1.0.0-beta01'}

在android代码块内指定 NDK 版本：

ndkVersion "23.1.7779620"

请务必选择与 Memory Advice API 兼容的 NDK 版本。Android Games Jetpack 版本页面上列出了受支持的 NDK 版本。

为 CMake 声明其他构建标志。为此，请将以下代码添加到android代码块内的defaultConfig代码块中：

externalNativeBuild {cmake {cppFlags '-std=c++14'// c++_shared flavor is the only supported STL type.arguments "-DANDROID_STL=c++_shared"}}

启用Prefab功能。对于 Android Gradle 插件 (AGP) 4.1 或更高版本，请将以下代码添加到android代码块中：

buildFeatures {prefab true}

如果您使用的是 AGP 4.0 或更低版本，请参阅Prefab 页面了解配置说明。

保存文件。如果您看到以下消息，请点击Sync Now按钮以更新您的项目：

Gradle files have changed since last project sync. A project sync may benecessary for the IDE to work properly.

为 C/C++ build 配置 CMake

如需将 Memory Advice API 的头文件和运行时库添加到项目中，请打开项目的主CMakeLists.txt文件。在Project窗格中，该文件位于app > src > main > cpp中。打开文件后，请执行以下步骤：

在文件顶部附近的任何cmake_minimum_required和project行之后，添加以下行：

find_package(games-memory-advice REQUIRED CONFIG)

在target_link_libraries命令中添加games-memory-advice::memory_advice。这会使 Memory Advice API 成为您项目的原生库的依赖项，并将其包含在最终应用软件包中。更新代码应与以下代码类似：

target_link_libraries(your-native-lib#link memory advice to the projectgames-memory-advice::memory_advice#rest of the dependencies#...)

配置 Java 文件

Memory Advice API 中包含的原生库是libmemory_advice.so。它是应用自己的 C/C++ 共享库的编译依赖项，将在应用使用System.loadlibrary()函数加载自己的共享库时自动加载。

这是可选步骤。

在项目中找到加载原生库的 Java 代码。如果该代码不存在，请予以添加。该代码应类似于System.loadLibrary("your-native-lib")，并位于static代码块中。

在System.loadLibrary("your-native-lib")下添加System.loadLibrary("memory_advice")。更新代码应与以下代码类似：

static {System.loadLibrary("your-native-lib");// Note: loading libmemory_advice.so is optional.System.loadLibrary("memory_advice");}

使用库

本部分介绍如何使用该库。

添加头文件

在项目中添加以下库头文件：

#include <memory_advice/memory_advice.h>

初始化库

您需要在应用启动时初始化一次库。为此，请将以下代码添加到项目中：

MemoryAdvice_init(env, activity);

env和activity参数是应为您的原生库提供的JNIEnv*和jobject变量。对您原生库的每个 JNI 调用都应包含这两个变量。如果您使用的是GameActivity 库，请务必将调用线程附加到 JavaVM后再调用MemoryAdvice_init函数。

内存状态轮询

您可以通过按选择的时间间隔轮询库，来检索应用的内存状态。如果您需要轮询库，请使用MemoryAdvice_getMemoryState函数：

MemoryAdvice_MemoryState state = MemoryAdvice_getMemoryState();switch (state) {case MEMORYADVICE_STATE_OK:// The application can safely allocate significant memory.break;case MEMORYADVICE_STATE_APPROACHING_LIMIT:// The application should free memory as soon as possible, until the memory// state changes.break;case MEMORYADVICE_STATE_CRITICAL:// The application should not allocate significant memory.break;}

设置观察器

您也可以设置观察器并注册 Memory Advice API，并在状态接近上限或紧急内存状态（但不适用于 ok 状态）时调用 watcher 函数。例如，以下代码会创建一个观察器并每 2 秒请求 Memory Advice API 通知：

static int USER_DATA;constexpr int callback_waittime_ms = 2000;void callback(MemoryAdvice_MemoryState state, void* context) {switch (state) {case MEMORYADVICE_STATE_APPROACHING_LIMIT:// The application should free memory as soon as possible, until the memory state// changes.break;case MEMORYADVICE_STATE_CRITICAL:// The application should not allocate significant memory.break;}}MemoryAdvice_registerWatcher(callback_waittime_ms, callback, &USER_DATA);

后续操作

如需查看其他资源和报告问题，请参阅概览。