本指南将展示如何使用 HUAWEI VR SDK 3.5 For OpenXR 插件,结合 OpenXR 引擎开发适配华为 Glasses 眼镜的 VR 应用。
基于OpenXR开发的应用调用SDK接口的逻辑如下图所示。APP调用Loader层,Loader层转到SDK层。其中Loader层集成在OpenXR APP中的lib_loader.so中。lib_loader.so和OpenXR的标准头文件即可视为OpenXR插件,具体文件见OpenXR Demo。OpenXR插件实现了OpenXR APP层与SDK层的连接。

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函数,开发者可根据需要修改场景内容。
应用程序的AndroidManifest必须符合以下内容:
<meta-data android:name="com.huawei.android.vr.application.mode" android:value="vr_only"/>
<meta-data android:name="android.max_aspect" android:value="2.1" />
<meta-data android:name="com.huawei.android.vr.application.type" android:value="game" />
<activity android:name="yourPackage.yourActivity">
<intent-filter>
<action android:name="com.huawei.android.vr.action.MAIN"/>
<category android:name="android.intent.category.DEFAULT"/>
</intent-filter>
</activity><uses-permission android:name="com.huawei.android.permission.VR"/>
<uses-permission android:name="com.huawei.vrhandle.permission.DEVICE_MANAGER" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<meta-data android:name="com.huawei.vr.application.freeDegree" android:value="3dof|6dof" />
以上内容都可参考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。
动作 |
按键 |
按键时间 |
功能 |
|---|---|---|---|
单击 |
Home按键 |
<1s |
进入VRLauncher界面 |
长按 |
Home按键 |
>=1s |
视点重置 |
长按 |
返回按键 |
>=3s |
进入VRSetting界面 |
长按 |
Home + Trigger |
>=1s |
实现截图 |
开发者如需自定义快捷键,请避免与上述快捷键组合冲突。