Added in API level 31

GameManager

class GameManager
kotlin.Any
   ↳ android.app.GameManager

The GameManager allows system apps to modify and query the game mode of apps.

Summary

Constants
static Int

Battery game mode will save battery and give longer game play time.

static Int

Custom game mode that has user-provided configuration overrides.

static Int

Performance game mode maximizes the game's performance.

static Int

Standard game mode means the platform will use the game's default performance characteristics.

static Int

Game mode is not supported for this application.

Public methods
Int

Return the user selected game mode for this application.

Unit
setGameState(gameState: GameState)

Called by games to communicate the current state to the platform.

Constants

GAME_MODE_BATTERY

Added in API level 31
static val GAME_MODE_BATTERY: Int

Battery game mode will save battery and give longer game play time.

Value: 3

GAME_MODE_CUSTOM

Added in API level 34
static val GAME_MODE_CUSTOM: Int

Custom game mode that has user-provided configuration overrides.

Custom game mode is expected to be handled only by the platform using users' preferred config. It is currently not allowed to opt in custom mode in game mode XML file nor expected to perform app-based optimizations when activated.

Value: 4

GAME_MODE_PERFORMANCE

Added in API level 31
static val GAME_MODE_PERFORMANCE: Int

Performance game mode maximizes the game's performance.

This game mode is highly likely to increase battery consumption.

Value: 2

GAME_MODE_STANDARD

Added in API level 31
static val GAME_MODE_STANDARD: Int

Standard game mode means the platform will use the game's default performance characteristics.

Value: 1

GAME_MODE_UNSUPPORTED

Added in API level 31
static val GAME_MODE_UNSUPPORTED: Int

Game mode is not supported for this application.

Value: 0

Public methods

getGameMode

Added in API level 31
fun getGameMode(): Int

Return the user selected game mode for this application.

An application can use android:isGame="true" or android:appCategory="game" to indicate that the application is a game. If an application is not a game, always return GAME_MODE_UNSUPPORTED.

Developers should call this API every time the application is resumed.

If a game's targetSdkVersion is android.os.Build.VERSION_CODES#TIRAMISU or lower, and when the game mode is set to GAME_MODE_CUSTOM which is available in android.os.Build.VERSION_CODES#UPSIDE_DOWN_CAKE or newer, this API will return GAME_MODE_STANDARD instead for backward compatibility.

Return
Int Value is android.app.GameManager#GAME_MODE_UNSUPPORTED, android.app.GameManager#GAME_MODE_STANDARD, android.app.GameManager#GAME_MODE_PERFORMANCE, android.app.GameManager#GAME_MODE_BATTERY, or android.app.GameManager#GAME_MODE_CUSTOM

setGameState

Added in API level 33
fun setGameState(gameState: GameState): Unit

Called by games to communicate the current state to the platform.

Parameters
gameState GameState: An object set to the current state. This value cannot be null.