Open topic with navigation

Some Simple Mappings

While the following items do, to some degree, oversimplify the situation, for app developers just starting out, this section provides some basic guidelines for what to do. These guidelines can assist in "bringing up" an app; once brought up, significant lifecycle testing should be done on a range of devices.

• onCreate
  Game data can be loaded here, but be careful about loading too much heavyweight data this early in the process, as device configuration lifecycle issues can cause the app to be shutdown after onCreate but before the window and surface are ready.
• surfaceCreated
  The initial surfaceCreated callback is the earliest that the application can create its EGLSurface and thus is the earliest that it can bind a context, load OpenGL ES resources, and render.
  However, applications should consider delaying any rendering until the app is "fully" ready and on-screen (next bullet).
• When all of the following are true:
  • We are between calls to onResume and onPause.
  • We are between calls to surfaceCreated and surfaceDestroyed.
  • We are between calls to onWindowFocusChanged(TRUE) and onWindowFocusChanged(FALSE).
    
    This is a safe time to be rendering and expecting input.
• onWindowFocusChanged(FALSE)
  Always auto-pause gameplay.
  Stop sounds/music.
  Strongly consider stopping rendering; at least throttle back.
• onPause
  Stop all rendering, even if you do not do so on focus loss.
• onResume after onPause
  Prepare to begin rendering again.
  Do not restart rendering or audio until you also get a "focus regained," as the lock screen may quickly "time out" because the user had just resumed the device to look at the clock, not to start playing again.
• onWindowFocusChanged(TRUE) after onResume
  This is a reasonable time to move an auto-pause screen, start rendering again and playing sounds.
  This is generally the signal that you are refocused and visible again (e.g.. the lock screen has been unlocked and you are visible).
• onStop
  Google now recommends freeing all graphics/3D resources here (either through GLES calls if the EGLContext is still bound, or via eglDestroyContext if the context has been unbound because the rendering surface was destroyed).
• onDestroy
  Release all of your native resources.

NVIDIA® GameWorks™ Documentation Rev. 1.0.220830 ©2014-2022. NVIDIA Corporation and affiliates. All Rights Reserved.