Introduction to Gear VR Development in Unity APPENDIX A: SETUP (WINDOWS 7/8)

(1)

APPENDIX A: SETUP (WINDOWS 7/8)

3-hour Workshop

Version 2015.07.13

Contact us at hello-dev@samsung.com

(2)

©2015 Samsung Electronics America, Inc. Samsung, Gear VR and Milk VR are trademarks of Samsung Electronics Co. Ltd. Other company names and/or product names mentioned herein are the property of their respective owners and may be trademarks or registered trademarks. Screen images simulated.

Requirements

Hardware

These configured devices will be provided at the workshop. You will be expected to share the devices with another attendee.

■ Samsung Gear VR Innovator Edition for Note 4 and Samsung GALAXY Note 4 ■ Samsung Gear VR Innovator Edition for S6 and Samsung GALAXY S6 or S6 Edge

If you plan on using your own devices, refer to the Gear VR User Manual and Gamepad User Manual bundled with your Gear VR to get started with your devices.

Software

This software is required for Gear VR development using Unity. ■ Oculus Mobile SDK 0.6.0.1

■ Unity 5.1.1p4

■ Java Development Kit 8 (JDK) ■ Android SDK 5.0 and SDK Tools

(4)

Windows Setup

Note: The following steps apply to both Windows 7 and Windows 8 operating systems.

Oculus Mobile SDK 0.6.0.1

1. Navigate to https://developer.oculus.com/ and select the MOBILE SDK (V.0.6.0.1) button.

2. On the Oculus Mobile SDK page, check the box to agree to the terms of the EULA and click the DOWNLOAD button.

3. Extract the ovr_mobile_sdk_0.6.0.1.zip package to a location that is easily accessible on your machine (e.g., Desktop or Documents).

(5)

Java SE Development Kit 8

1. Navigate to http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html. 2. In the Java SE Development Kit 8u31 section, select the Accept License Agreement radio button and

download the Windows x86 or Windows x64 file.

Note: A newer version of the Java Development Kit may be available for download. You may choose to use the

(6)

3. Open the EXE file to install the JDK. Before installing the JDK, note the installation location.

4. Follow the instructions to complete the JDK installation.

5. To ensure the JDK has been successfully installed, open a Command Prompt window, type the following command and press Enter:

java -version

6. Your current Java version will display in the window.

7. Open your Control Panel and navigate to System and Security > System > Advanced system settings.

(7)

(8)

9. In the Environment Variables window, locate the User variables section and click the New… button.

10. In the New User Variable dialog, fill out the fields as follows: • Variable name: PATH

• Variable value: C:\[your JDK path]\bin

(9)

Android SDK

Download and install the SDK

1. Navigate to http://developer.android.com/sdk/index.html. Here you will be given the option of downloading Android Studio, which packages the official Android IDE and SDK tools, or downloading the SDK Tools only. For this workshop, you will only need the SDK Tools.

2. Scroll down to the Other Download Options section. Under SDK Tools Only, locate the Windows platform and download the installer_r24.0.2-windows.exe file, accepting the license agreement as necessary.

(10)

4. In the Android SDK Tools Setup window, when the installer has finished, check the box to Start SDK Manager and click Finish. This will open the Android SDK Manager.

5. Check the boxes for the following packages: • Android Platform-tools

• Android SDK Build-tools (the latest version) • Android 5.0.1 (API 21)

Note: When the Android SDK Manager launches, some packages may be preselected for installation. For this

workshop, you will only need to install the packages listed above. If any of the preselected packages are not on this list, feel free to uncheck the items before starating the installation process.

6. Click the Install button.

(11)

Install the USB Driver

1. On your computer, navigate to http://www.samsung.com/us/support/downloads. In the Product Name field, search for your device (e.g., Note 4 or S6) and select your device from the list.

2. On the device page, scroll down to the Manuals & Downloads section. Under Downloads, click the Download

(EXE) button to download the USB driver for the device.

(12)

(13)

Unity 5.1.1p4

Note: You must download Unity patch release 5.1.1p4 for this workshop. If you are using an older version of Unity 5.1,

you may experience app crashes and rendering issues on the Gear VR headset.

1. Navigate to one of the following links to download Unity 5.1.1p4 for Windows: • Windows 32-bit:

http://beta.unity3d.com/download/c439df19cd24/Windows32EditorInstaller/UnitySetup32-5.1.1p4.exe • Windows 64-bit:

http://beta.unity3d.com/download/c439df19cd24/Windows64EditorInstaller/UnitySetup64-5.1.1p4.exe 2. Open the UnitySetup-5.1.1p4.exe installer package and follow the instructions to install Unity on your machine. 3. Launch Unity and sign into your Unity account. If you do not have and account, create one now.

(14)

Mandatory device setup for personal devices

Note: Gear VR, Note 4, and/or S6/S6 Edge devices will be available for use at the workshop. If you plan on borrowing a

device at the workshop, your setup is complete. If you plan on using your own devices, you must continue with the remaining sections to set up your device for development and create an Oculus Signature File.

Set up device for development

1. Connect your Samsung GALAXY Note 4 or S6/S6 Edge to your computer via USB cable. 2. On your device, go to Apps > Settings.

3. In the Settings app, scroll down to the SYSTEM section. If you see the Developer options menu item, skip to

step 6. Otherwise, continue to step 4 to enable Developer options.

4. Select the About phone menu item.

5. Scroll down and tap Build number seven times. This will activate Developer options on your device. Return to the main settings page.

(15)

7. In the Developer options, navigate to the DEBUGGING section and enable USB debugging. In the Allow USB

debugging? dialog, tap OK.

(16)

9. Open a Command Prompt window and type the following command to navigate to your Android SDK’s

/platform-tools directory:

CD [pathToAndroidSDK]/platform-tools

(17)

Oculus Signature File

Manually retrieve Device ID with a Command Prompt

1. With your device plugged into your Windows machine, open a Command Prompt window.

Note: If you completed the previous section, Set up device for development, you will already have a Command

Prompt window open listing your device and Device ID. Copy the Device ID and continue onto the Download

Oculus Signature File section.

2. Navigate to the /platform-tools directory in the Android SDK with the following command: CD [pathToAndroidSDK]/platform-tools

3. Type the following command to retrieve your Device ID: adb devices

4. Copy your Device ID.

Use the Device ID app to retrieve Device ID

This is an alternative way of getting your Device ID.

1. If not already installed, download the Device Id Fetch app here: http://bit.ly/1FuLsOq

2. Transfer the APK file to your device and install the app.

Note: You may be asked to allow Unknown sources on your device. To do this go to Settings > Security and

enable the Unknown sources option.

(18)

Download Oculus Signature file

1. Navigate to https://developer.oculus.com/tools/osig/ and sign into your Oculus account. If you do not have an account, create one now.