添加帧速率调节功能

使用以下函数在基于 OpenGL ES API 的渲染引擎中使用 Android 帧速率控制。

初始化和销毁

使用以下函数分别初始化和销毁 Android 帧速率控制的实例

• void SwappyGL_init(JNIEnv *env, jobject jactivity);
• void SwappyGL_destroy();

通常，您应该在引擎启动序列中尽早调用 SwappyGL_init()，并在游戏退出时调用 SwappyGL_destroy()。您不应该在其他任何时间调用这些方法。

配置交换间隔和刷新周期

使用以下函数配置 Android 帧速率控制的实例

• void SwappyGL_setSwapIntervalNS(uint64_t swap_ns);
• void SwappyGL_setFenceTimeoutNS(uint64_t fence_timeout_ns);
• void SwappyGL_setUseAffinity(bool tf);

调用 SwappyGL_setSwapIntervalNS() 时，请传入帧应呈现的持续时间。在大多数情况下，您可以使用以下常量之一：SWAPPY_SWAP_60FPS、SWAPPY_SWAP_30FPS 或 SWAPPY_SWAP_20FPS。

通常，您应该在调用 SwappyGL_init() 后直接调用这些方法。但是，您可能还需要在游戏执行过程中的其他时间调用这些方法。

设置 ANativeWindow

Swappy 需要 ANativeWindow 的句柄才能执行 ANativeWindow 特定的操作，例如调用 ANativeWindow_setFrameRate()。当您的 Android 显示表面发生更改并且您拥有新的 ANativeWindow 句柄时，请调用 SwappyGL_setWindow()（有关示例，请参见 Bouncyball 示例）。

自动模式

Android 帧速率控制根据之前帧的平均持续时间调整交换持续时间和管道模式。您可以使用以下函数控制此行为

• void SwappyGL_setAutoSwapInterval(bool enabled);
• void SwappyGL_setMaxAutoSwapIntervalNS(uint64_t max_swap_ns);
• void SwappyGL_setAutoPipelineMode(bool enabled);

执行每帧交换

在每个渲染帧期间，请调用 bool SwappyGL_swap(EGLDisplay display, EGLSurface surface)。此方法封装了 Open GL ES 中的 eglSwapBuffers() 方法，因此您应该用 SwappyGL_swap() 替换游戏中所有 eglSwapBuffers() 的实例。

实用程序函数

以下方法检查 Android 帧速率控制是否已启用

• bool SwappyGL_isEnabled();

Android 帧速率控制的实例可能由于以下任何原因无法自行初始化

• 设备上缺少必要的 EGL 函数。
• 系统已设置 swappy.disable 属性。

在这两种情况下，SwappyGL_isEnabled() 返回 false，建议您实现备用帧速率控制策略。