开始使用适用于Android的Google VR SDK

如果你使用Google VR SDK构建Daydream和VR眼镜应用程序，本指南将教会你如何设置Android Studio进行Google VR开发，以及如何使用Treasure Hunt示例应用程序。

设置开发环境

硬件要求：

• 开发Daydream应用：你需要一款支持Daydream的手机和Daydream View VR眼镜。

• 开发VR眼镜应用： 您需要安装Android 4.4“Kit Kat”（第19版API）或更高版本的Android设备和VR眼镜。

软件要求：

• Android Studio2.3.3或更高版本。

• Android SDK 7.1.1“牛轧糖”（第25版API）或更高版本。在Android Studio中，点击首选项 > 外观和行为 > 系统设置 > Android SDK可查看或更新已安装的SDK。

• Android版Google VR SDK1.80.0版本或更高版本。

在Android Studio中打开已有Goog​​le VR SDK项目

1. 下载Google VR SDK并解压至你想安装SDK的位置。

2. 打开Android Studio并选择打开现有的Android Studio项目，选择您解压缩Google VR SDK的目录。

3. 在项目窗口中，查看gvr-android-sdk > 样本中的示例gradle模块：

设置硬件设备

• 启用开发人员选项

• 启用USB调试模式

构建并运行示例应用

1. 使用USB线将手机连接到电脑。

2. 在Android Studio中，选择运行 > 运行...，然后选择samples-sdk-treasurehunt目标，即可让Android Studio在手机上编译并运行应用程序。

3. 将手机放入VR眼镜就可以开始体验这个VR应用了。

   • 转转头可以看到大型立方体。

   • 如果你是使用Daydream设备： 可以将控制器指向立方体，这时按下触摸板按钮就能拾起它。

   • 如果你是使用VR眼镜 可以看向立方体，让视线落在上面，这时按下VR眼镜上的按钮就能拾起它。

   • 再按一下钮按，可以将立方体放下，从而完成移动立方体的动作。

“寻宝”应用程序演示了Google VR SDK的以下核心特性：

了解更多详细信息，请参阅寻宝示例演示。

在您自己的项目中使用Google VR

要在自己的项目中使用Google VR SDK或NDK，请安装好Google VR的依赖包。如果您在应用程序中使用了ProGuard，请添加规则，以确保它不会和任何SDK或NDK代码混淆。

设置Google VR相关依赖

1. 配置您的项目级别build.gradle文件：

   • 确保声明好默认的jcenter()仓库位置。

   • 声明以下任一Android Gradle插件依赖：

    对于 **Google VR SDK项目**：使用`gradle:2.3.3`或更高版本。

    对于 **Google VR NDK项目**：使用`gradle-experimental:0.9.3`或更高版本。

allprojects {        
    repositories {
        jcenter()
    }
}
dependencies {
    // 需要安装Google VR SDK 2.3.3或更高版本。            
    classpath 'com.android.tools.build:gradle:2.3.3'       

    // 需要安装Google VR NDK 0.9.3实验版或更高版本。            
    classpath 'com.android.tools.build:gradle-experimental:0.9.3'
}

1. 在您的模块级别build.gradle文件中添加Google VR SDK库依赖项。可以在gvr-android-sdk > 库中查看可用的库及其版本。

   As an example, review the dependencies declared for the Treasure Hunt app in gvr-android-sdk > samples > sdk-treasurehunt > build.gradle.

   例如，点击gvr-android-sdk > samples > sdk-treasurehunt > build.gradle查看为“treasurehunt”应用程序声明的“依赖关系”。

   dependencies {
    // 添加Google VR空间音频支持        
    compile 'com.google.vr:sdk-audio:1.80.0'      
   
    // Google VR应用程式都必需安装此库
    compile 'com.google.vr:sdk-base:1.80.0'     
   }
   

   要了解更多相关信息，请参阅Android Studio指南中的添加构建依赖关系。

配置ProGuard

如果您正在使用ProGuard来压缩应用的APK文件，请确保ProGuard源码不会和Google VR SDK或NDK源码产生混淆，这样有利于调试跟踪。

Add the Google VR ProGuard proguard-gvr.txt rules to your module level build.gradle file:

将Google VR ProGuard [proguard-gvr.txt]（// github.com/googlevr/gvr-android-sdk/blob/master/proguard-gvr.txt）规则添加到您的模块级别build.gradle文件中：

android {
    ...    
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles.add(file('../../proguard-gvr.txt'))
        }
    }
}

下一步

要了解更多有关Google VR SDK的信息，请参阅以下资源。

• 寻宝示例代码演示

• Google VR SDK视频和全景图像示例应用程序演示

• 了解更多Daydream元素中的Google VR设计和开发原则。

• Android的空间音频教程

• Google VR API参考

• Daydream: 进一步了解如何在您的应用程序中实现Daydream控制器用户交互：

  • 点击 gvr-android-sdk > 库 > sdk-controller，查看控制器库。

  • 另请参阅控制器库API参考。

版权所有，翻印必究。Java是隶属于Oracle及旗下产品注册商标。

最后更新时间：2017年9月8日