AndroidCompat

AI-generated Key Takeaways

• AndroidCompat is a utility class for using VR features that may not be available on all Android versions.

• This class provides methods for setting sustained performance mode and enabling VR mode for an Activity.

• The functionality provided by AndroidCompat is experimental and may change in the future.

• setVrModeEnabled only has an effect on Android N+ and may require Google VR Services to be installed and enabled.

• Using setVrModeEnabled on Daydream-ready devices without Google VR Services may result in limited functionality.

public final class AndroidCompat

Utility class for using VR-related features that may not be available with all Android versions.

Warning: The functionality is experimental and subject to change in future releases.

Public Methods

static void	setSustainedPerformanceMode(Activity activity, boolean enabled) Sets the current android.view.Window to sustained performance mode, when available.
static boolean	setVrModeEnabled(Activity activity, boolean enabled) Sets the appropriate "VR mode" setting for an Activity.

Inherited Methods

From class java.lang.Object

boolean	equals(Object arg0)
final Class<?>	getClass()
int	hashCode()
final void	notify()
final void	notifyAll()
String	toString()
final void	wait(long arg0, int arg1)
final void	wait(long arg0)
final void	wait()

Public Methods

public static void setSustainedPerformanceMode (Activity activity, boolean enabled)

Sets the current android.view.Window to sustained performance mode, when available.

Parameters

activity	The current Activity.
enabled	Whether to enable sustained performance mode.

public static boolean setVrModeEnabled (Activity activity, boolean enabled)

Sets the appropriate "VR mode" setting for an Activity.

This should typically be called in Activity.onCreate for pure VR activities, and will only have an effect on Android N+.

On Daydream-ready devices, if Google VR Services is not present and enabled, this will prompt the user to install or enable Google VR Services before continuing. If the user continues without Google VR Services present and enabled, the Android OS will not enter VR mode, and some functionality may not be available (e.g. the controller).

Parameters

activity	The Activity for which to set VR mode.
enabled	Whether to enable VR mode.

Returns

• true if this succeeded, false otherwise. This can fail either because the device does not support VR mode, or because Google VR Services is unavailable.