目录

应用开发

本指南将展示如何使用 HUAWEI VR SDK 3.5 For OpenXR 插件,结合 OpenXR 引擎开发适配华为 Glasses 眼镜的 VR 应用。

开发流程

[h2]集成 SDK 3.5 OpenXR 插件

基于OpenXR开发的应用调用SDK接口的逻辑如下图所示。APP调用Loader层,Loader层转到SDK层。其中Loader层集成在OpenXR APP中的lib_loader.so中。lib_loader.so和OpenXR的标准头文件即可视为OpenXR插件,具体文件见OpenXR Demo。OpenXR插件实现了OpenXR APP层与SDK层的连接。

[h2]运行OpenXR Demo

OpenXR Demo是一个Android工程,利用Android Studio直接打开,按照说明的Android环境配置要求进行配置,编译运行即可。

OpenXR Demo中涉及Java侧代码通过JNI调用C++侧的OpenXR接口。JNI涉及的接口见GL2JNILib.java。OpenXR接口调用入口见xr_demo.cpp中Run函数。OpenXR Demo中的场景绘制具体见xr_demo.cpp中renderView函数,开发者可根据需要修改场景内容。

[h2]应用程序的AndroidManifest配置

应用程序的AndroidManifest必须符合以下内容:

以上内容都可参考Assets\Plugins\Android下默认的AndroidManifest.xml文件。

如果应用的目标平台为 Android 11(API 级别 30)或更高版本,则另外需要在manifest标签下增加如下配置,以可正常支持手柄连接。

<queries>
    <package android:name="com.huawei.vrhandle" />
    <package android:name="com.huawei.hvrsdkserverapp" />
    <intent>
        <action android:name="com.huawei.vrhandle.service.vrdeviceservice"/>
    </intent>
</queries>

另外,如果开发者需要不连接头盔看到手机上的显示,需要在AndroidManifest的application下包含以下meta-data,但是,正式发布的应用程序中必须去掉该标签,此功能仅用于调试。

<meta-data android:name="com.huawei.android.vr.sensor.mode" android:value="mobile"/>

在OpenXR上修改AndroidManifest.xml的方法可参见OpenXR Demo源码目录下的AndroidManifest.xml。

[h2]手柄按键特殊说明

手柄默认快捷键如下表所示:

表1 默认快捷键说明

动作

按键

按键时间

功能

单击

Home按键

<1s

进入VRLauncher界面

长按

Home按键

>=1s

视点重置

长按

返回按键

>=3s

进入VRSetting界面

长按

Home + Trigger

>=1s

实现截图

开发者如需自定义快捷键,请避免与上述快捷键组合冲突。