This site has been permanently archived. The content on this site was last updated in 2019.

All developers actively developing experiences for Google Cardboard should use the open source Cardboard SDKs for iOS, Android NDK, and Unity XR Plugin.
The Daydream View VR headset is no longer available for purchase as of October 15, 2019. As of November 2023, previously supported devices will no longer be able to download and install Google VR Serivces (Android application ID com.google.vr.vrcore) for new users.

UserPrefs

AI-generated Key Takeaways

The UserPrefs class stores user preferences, such as controller handedness and enabled runtime features, and remains valid until the GVR context is destroyed.
It provides methods to get the user's preferred controller hand (left or right) and check if a specific runtime feature is enabled.
Runtime features can be enabled or disabled by the user and may persist while the activity is running, but could be changed when the activity stops.
Developers can use the requestFeatures method of the GvrApi class to prompt users to enable or disable runtime features.

public class UserPrefs

Contains information about user preferences. This object will remain valid until the GVR context (wrapped by GvrApi) is destroyed.

class	UserPrefs.ControllerHandedness		The hand the user prefers to hold the controller in.
enum	UserPrefs.RuntimeFeature		These are features that may be available on some devices but can be enabled or disabled by the user.

int	getControllerHandedness() Returns the current controller handedness setting.
boolean	isFeatureEnabled(UserPrefs.RuntimeFeature feature) Queries whether a particular runtime feature is currently enabled.

From class java.lang.Object

Returns the current controller handedness setting. Will be either ControllerHandedness.RIGHT_HANDED or ControllerHandedness.LEFT_HANDED.

Queries whether a particular runtime feature is currently enabled. Use requestFeatures(UserPrefs.RuntimeFeature[], UserPrefs.RuntimeFeature[], android.app.PendingIntent) to ask the user to enable it. If a feature is enabled by the user, it will remain enabled while the Activity is running. However, it may be disabled by the user when the Activity is stopped.

feature	The `UserPrefs.RuntimeFeature` being queried.