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

Transcription

1 Introduction to Gear VR Development in Unity APPENDIX A: SETUP (WINDOWS 7/8) 3-hour Workshop Version Contact us at Presented by Samsung Developer Connection and MSCA Engineering - Dallas

2 1 Table of Contents Requirements... 2 Hardware... 2 Software... 2 Windows Setup... 3 Oculus Mobile SDK Java SE Development Kit Android SDK... 8 Download and install the SDK... 8 Install the USB Driver Unity 5.1.1p Mandatory device setup for personal devices Set up device for development Oculus Signature File Manually retrieve Device ID with a Command Prompt Use the Device ID app to retrieve Device ID Download Oculus Signature file... 17

3 2 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 Unity 5.1.1p4 Java Development Kit 8 (JDK) Android SDK 5.0 and SDK Tools Use the following instructions to setup your laptop for the workshop.

4 APPENDIX A: SETUP (WINDOWS 7/8), Introduction to Gear VR Development in Unity (3-hour Workshop) Windows Setup Note: The following steps apply to both Windows 7 and Windows 8 operating systems. Oculus Mobile SDK Navigate to and select the MOBILE SDK (V ) 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_ zip package to a location that is easily accessible on your machine (e.g., Desktop or Documents). Open the ovr_mobile_sdk_ package and review the contents. 4. 3

5 4 Java SE Development Kit 8 1. Navigate to 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 latest verstion. The last version tested for the workshop was version. Also, to determine if your computer is 32-bit or 64-bit, right-click on Computer, choose Properties and look at the System type. If your computer is 64-bit, download Windows x64. If it is 32-bit, download Windows x86.

6 5 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. Note: This setting may also appear as System > Advanced system settings.

7 6 8. In the System Properties window, select the Advanced tab and click the Environment Variables button.

8 7 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 11. Click OK (multiple times if necessary) to close out all dialogs.

9 8 Android SDK Download and install the SDK 1. Navigate to 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_r windows.exe file, accepting the license agreement as necessary. 3. Launch the installer package and follow the instructions to install Android SDK Tools.

10 9 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 (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. 7. In the Choose Packages to Install dialog, select license on the left hand side and enable the Accept License radio button. Once all licenses have been accepted, click the Install button.

11 10 Install the USB Driver 1. On your computer, navigate to 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. 3. Launch the EXE file and follow the instructions to install the Samsung USB Driver.

12 11 4. When you connect your device to your computer via USB cable on the day of the workshop, your computer should recognize your device and you should see it appear as a removable device in Windows Explorer.

13 12 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: Windows 64-bit: 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. 4. Once you ve activated Unity, the application will launch and prompt you to create a new project. At this point, you can close Unity.

14 13 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. 6. Select the Developer options menu item.

15 14 7. In the Developer options, navigate to the DEBUGGING section and enable USB debugging. In the Allow USB debugging? dialog, tap OK. 8. In the next dialog, check the Always allow this computer box and tap OK.

16 15 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 9. Type the following command and you will that a device has been connected to your machine: adb devices

17 16 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: 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. 3. Open the Device Id Fetch app on your device and copy your Device ID.

18 17 Download Oculus Signature file 1. Navigate to and sign into your Oculus account. If you do not have an account, create one now. 2. Once you've signed into your account, paste your Device ID into the form field and click the DOWNLOAD FILE button. Your signature file will be downloaded. Be sure to keep this file in a location that can be easily accessed.