Maintained at https://github.com/OSVR/OSVR-Unreal
For details, see http://osvr.github.io
For support, see http://support.osvr.com
This OSVR plugin is now integrated in the official Unreal Engine 4.12.x release. To use it, simply enable the OSVR plugin from your project's plugin page - it is listed in the Virtual Reality section.
The code for the plugin is maintained at https://github.com/OSVR/OSVR-Unreal and source code drops are sent from here to the Unreal engine code, so community contributions should be made there first.
The OSVRUnreal
folder contains a sample application using the plugin from source, for ease of development.
The plugin itself is inside OSVRUnreal/Plugins/OSVR
.
Currently works with Unreal Engine 4.12.x. If you are on 4.11.x or 4.10.x,
you may need to modify IOSVR.h
to change OSVR_UNREAL_4_12
to 0 (for 4.11)
and additionally OSVR_UNREAL_4_11
to 0, if targeting unreal 4.10. However, 4.10 and 4.11
support will be limited, going forward (community contributions always welcome).
To update your game to the latest OSVR-Unreal plugin source, you need to install the plugin as a local plugin in your project, just as was done prior to the official release of the built-in plugin. You will need to disable the built-in plugin first, if you previously enabled it.
The current recommended way to integrate the OSVR Unreal plugin with an existing project is directly from source.
ImportFromSDK.cmd "C:\Program Files (x86)\OSVR\SDK" "C:\Program Files\OSVR\SDK" D:\3rdParty\osvr-android-ndk
Confirm that the OSVR plugin binaries were copied correctly to YourProject/Binaries/Win64 and YourProject/Binaries/Android/armeabi-v7a. If not, you will need to copy binaries from YourProject/Plugins/OSVR/Binaries (or YourProject/Plugins/OSVR/Source/OSVRClientKit/bin if Binaries is not available) to YourProject/Binaries.
Note: Android support is currently preliminary/alpha-quality. It is not yet ready for production. If you still want to build for Android without OSVR support enabled, remove Android from the WhiteListPlatforms of both OSVR and OSVRInput modules in /OSVRUnreal/Plugins/OSVR/OSVR.uplugin.
More detailed documentation, including documentation for the controller/motion-controller support is included in Documentation.md.
Video showing how to integrate OSVR into an Unreal project is here: http://youtu.be/jLCkuJb--7w
This project: Licensed under the Apache License, Version 2.0.