Here you will find information and links to GearVRf hardware and software requirements, project files, source code, samples and demos, developer documents, tutorials, and more.
GearVRf applications (your own or sample apps) can be run on devices that meet the following requirements and will require the following software environments.
Gear VR/Oculus Hardware Requirements
- Gear VR compatible Samsung phone - Galaxy S8, Galaxy S8+, Galaxy S7, Galaxy S7 Edge, Note 5, Galaxy S6, Galaxy S6 Edge, Galaxy Edge+, Note 4.
- Samsung Gear VR headset
Daydream Hardware Requirements
- Daydream-ready phone
- Google Daydream View VR headset
- JDK 1.7 and above
- Oculus Mobile SDK 1.5.0 or Google VR SDK 1.30.0
- Android SDK (version 5.0.1, or higher, is preferred) and/or KitKat SDK (version 4.4.x )
- Android Studio IDE 2.1
GearVRf Project Files
Download the GearVRf release files here: https://github.com/Samsung/GearVRf/releases
GearVRf Source Code
NOTE: You should only download the GearVRf source code if you wish to perform a clean rebuild of the source code, edit the source code, or make a contribution to the community. The .aar files located at https://github.com/Samsung/GearVRf/releases are sufficient to start building VR applications with GVRf.
To get the source code to the GearVR Framework, clone from this repository:
$ git clone https://github.com/Samsung/GearVRf.git -b release_v3.2
GearVRf Samples and Demos
To get the GearVR Framework Samples and Demos, clone the following repository in the same directory as where you did the clone for the framework source code:
$ git clone https://github.com/gearvrf/GearVRf-Demos.git -b release_v3.2
NOTE: You should put both GearVRf/ and GearVRf-Demos/ in the same directory.
GearVRf Developer Guide
GearVRf developer guidance, explanations, directions, and sample code.
How to import, build, and run your own and sample GearVRf applications in Android Studio.
GearVRf API Reference
Details about the GearVRf API (including packages, classes, and methods).
Online GearVRf API Reference (http://docs.gearvrf.org)
GearVRf Video Tutorials
Video tutorials to help you get started here are located here: GearVRf Project Tutorials
Sample GearVRf Applications
Sample GearVRf applications, available in the GearVRf SDK, can provide you with valuable insight into writing your own VR applications.
NOTE: The flat images below represent GearVRf applications with actual stereographic displays.
|Solar system with four inner rotating planets revolving around the rotating sun as viewed from the point on the moon closest to Earth
Asynchronous loading of meshes and textures is used.
Loading order is by priority; no mesh or texture is loaded twice.
Animation is used to create the illusion of rotation and revolution.
|Dynamic Graphics Board
|Images and video displayed on a board inside a 3D scene
A video or image is displayed in a rectangular scene object (up the stairs).
Animation is used to switch images and video smoothly.
OnStep decides and defines the animation to apply, based on HMD orientation.
Post-effect converts view to sepia colors.
|Color of objects (bunnies and rectangles) changes to red when an object is at the center of the view
OnStep updates scene object colors.
Implements a color custom shader.
|Pick and Move
|3D mirror ball can be selected and repositioned in a 3D scene
Uses the HMD trackpad.
Uses Cubemap support.
Uses scene picking.
|Useful Scene Objects
|Contains fundamental scene objects (such as a cube, sphere, cone, and text) that you can use in your own apps|
Developing GearVRf Applications
GearVRf runs full-screen and in a single Android View of its own, so you do not need any themes, menus, or layout files. But GearVRf apps can use Android resources (such as strings, ints, drawables, assets, and res/raw files).
For details about developing your own GearVRf applications: