diff --git a/metaxr.md b/metaxr.md index ac4021d..a549b6d 100644 --- a/metaxr.md +++ b/metaxr.md @@ -1,15 +1,5 @@ # HISPlayer MetaXR Integration -## Integrate Meta XR All-in-One SDK - -Integrate HISPlayer SDK with the **[Meta XR All-in-One SDK](https://developer.oculus.com/downloads/package/meta-xr-sdk-all-in-one-upm/)**. - -First, please configure the Unity project for Oculus by following this [Tutorial](https://developer.oculus.com/documentation/unity/unity-tutorial-hello-vr/) and open **Window > Package Manager > Packages: In Project** to check Meta XR All-in-One SDK is installed properly. - -

-image -

- ## Requirements #### Meta XR All-in-One version @@ -31,18 +21,39 @@ First, please configure the Unity project for Oculus by following this [Tutorial #### Target Architecture - IL2CPP - ARM64 -#### Oculus platform -Open **Edit > Player Settings > MetaXR**, select the Android platform and clik "**Select All**" and "**Apply All**" in order to set up all the Oculus settings. +**Note**: If you plan to use **Meta XR SDK v74 or newer**, we recommend working with **Unity 2022.3 LTS or Unity 6+**. +Older Unity versions may still work but are limited to the Oculus XR Plugin and won’t support new Meta XR features. + +## Integrate Meta XR All-in-One SDK + +Integrate HISPlayer SDK with the **[Meta XR All-in-One SDK](https://developer.oculus.com/downloads/package/meta-xr-sdk-all-in-one-upm/)**. + +First, please configure the Unity project for Oculus by following this [Tutorial](https://developer.oculus.com/documentation/unity/unity-tutorial-hello-vr/) and open **Window > Package Manager > Packages: In Project** to check Meta XR All-in-One SDK is installed properly.

-image + image

-Select XR Plug-in Management, please make sure that you have the **Oculus** option checked. Otherwise, when you run the application, it will show a 2D window without XR environment. - - - **Edit > Project Settings > XR Plug-in Management** +Open **Edit > Player Settings > MetaXR**, select the Android platform and clik "**Fix All**" and "**Apply All**" in order to set up all the Oculus settings. It is possible that during the remaining processes new errors and warnings may arise that need to be fixed again. + +

+ image +

+ +In older versions of the Meta XR SDK, this step automatically installed Oculus XR. However, starting with Meta XR SDK v74 and later, the choice of plugin is up to you. Meta’s support has shifted to focus on OpenXR, so you should decide which plugin fits your project. + +## Which plugin should you choose, Oculus XR or OpenXR? + +When setting up the Meta XR All-in-One SDK in Unity, you’ll be asked to pick one of two XR providers: Oculus XR Plugin or Unity OpenXR Plugin. +- **Oculus XR Plugin**: Meta’s older, Oculus-specific integration. Only recommended if you are working with Unity < 6 or the Meta XR SDK prior to version v74. +- **Unity OpenXR Plugin**: Industry-standard OpenXR integration. Fully compatible with all new features of the Meta XR SDK (v74+). It also allows your app to run on other OpenXR-compliant platforms, not just Quest. -image +To install these plugins, open **Package Manage > Install Package by Name**, type *com.unity.xr.oculus* or *com.unity.xr.openxr* depending on which one best suits your application, and select install. + +Go to **Project Settings → XR Plug-in Management** and make sure that the provider you’ve chosen (Oculus XR or OpenXR) is checked. +

+ image +

## Import HISPlayer SDK If you have not imported HISPlayer SDK yet, please follow the [**Quickstart Guide**](./setup-guide.md). @@ -80,7 +91,7 @@ In our sample we're using the following options: * **3D Layout**: None

-image + image

### 180 Degrees Video Playback @@ -132,6 +143,13 @@ If you see the following errors and warning in HISPlayerSettings after copying t image

+### Disable Multithreaded Rendering Requirement + +There is a conflict between the recommended configuration of the HISPlayer SDK, which asks you to disable Multithreading, and the Meta XR SDK, which asks you to enable it. HISPlayer requires this to avoid certain issues with some Android devices, specifically mobile phones. Therefore, it is recommended to enable it as required for Meta Quest usage and ignore the HISPlayer warning. +

+ image + image +

### Vertically Inverted Video Issue