From 192bbb6890c83d294fdd1a1ecd42faa8ea390c85 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=93scar=20Fern=C3=A1ndez=20Romano?= <47836840+OskarFreestyle@users.noreply.github.com> Date: Tue, 26 Aug 2025 14:04:24 +0200 Subject: [PATCH 01/13] Update metaxr.md --- metaxr.md | 33 +++++++++++++++++---------------- 1 file changed, 17 insertions(+), 16 deletions(-) diff --git a/metaxr.md b/metaxr.md index ac4021d..9b07671 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,29 @@ 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. +## 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 +

+ +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. It is possible that during the remaining processes new errors and warnings may arise that need to be fixed again.

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** +## 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. ## Import HISPlayer SDK If you have not imported HISPlayer SDK yet, please follow the [**Quickstart Guide**](./setup-guide.md). From 8d6fb992c5745b957a6d84319172b3551ab10b10 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=93scar=20Fern=C3=A1ndez=20Romano?= <47836840+OskarFreestyle@users.noreply.github.com> Date: Tue, 26 Aug 2025 14:21:09 +0200 Subject: [PATCH 02/13] Update metaxr.md --- metaxr.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/metaxr.md b/metaxr.md index 9b07671..18ff073 100644 --- a/metaxr.md +++ b/metaxr.md @@ -37,6 +37,8 @@ Open **Edit > Player Settings > MetaXR**, select the Android platform and clik " 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. @@ -45,6 +47,9 @@ When setting up the Meta XR All-in-One SDK in Unity, you’ll be asked to pick o 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). From cd14a71a57f9f00a47f505d629c2b21e1a88aab4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=93scar=20Fern=C3=A1ndez=20Romano?= <47836840+OskarFreestyle@users.noreply.github.com> Date: Tue, 26 Aug 2025 14:21:37 +0200 Subject: [PATCH 03/13] Update metaxr.md --- metaxr.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/metaxr.md b/metaxr.md index 18ff073..02878a3 100644 --- a/metaxr.md +++ b/metaxr.md @@ -42,8 +42,8 @@ In older versions of the Meta XR SDK, this step automatically installed Oculus X ## 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. +- **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. 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. From 98fdffee855b0b9b6cf4a343b27f84066773c053 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=93scar=20Fern=C3=A1ndez=20Romano?= <47836840+OskarFreestyle@users.noreply.github.com> Date: Tue, 26 Aug 2025 14:39:58 +0200 Subject: [PATCH 04/13] Update metaxr.md --- metaxr.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/metaxr.md b/metaxr.md index 02878a3..2cd7c72 100644 --- a/metaxr.md +++ b/metaxr.md @@ -21,6 +21,9 @@ #### Target Architecture - IL2CPP - ARM64 +**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/)**. @@ -138,6 +141,9 @@ If you see the following errors and warning in HISPlayerSettings after copying t image

+### Disable Multithreaded Rendering Requirement + +image ### Vertically Inverted Video Issue From 818911f4abe05129086645b7b570d7e9f8b67cad Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=93scar=20Fern=C3=A1ndez=20Romano?= <47836840+OskarFreestyle@users.noreply.github.com> Date: Tue, 26 Aug 2025 14:46:11 +0200 Subject: [PATCH 05/13] Update metaxr.md --- metaxr.md | 1 + 1 file changed, 1 insertion(+) diff --git a/metaxr.md b/metaxr.md index 2cd7c72..8ac59e4 100644 --- a/metaxr.md +++ b/metaxr.md @@ -143,6 +143,7 @@ If you see the following errors and warning in HISPlayerSettings after copying t ### Disable Multithreaded Rendering Requirement +There's a conflict between the recommended configuration for 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's recommended that you enable it as required by Meta. image ### Vertically Inverted Video Issue From dc0698bcd2e1c5b74a89a1061407635638062caf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=93scar=20Fern=C3=A1ndez=20Romano?= <47836840+OskarFreestyle@users.noreply.github.com> Date: Tue, 26 Aug 2025 14:46:48 +0200 Subject: [PATCH 06/13] Update metaxr.md --- metaxr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/metaxr.md b/metaxr.md index 8ac59e4..e02fb4b 100644 --- a/metaxr.md +++ b/metaxr.md @@ -143,7 +143,7 @@ If you see the following errors and warning in HISPlayerSettings after copying t ### Disable Multithreaded Rendering Requirement -There's a conflict between the recommended configuration for 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's recommended that you enable it as required by Meta. +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 by Meta and ignore the HISPlayer warning. image ### Vertically Inverted Video Issue From e36ad5faffc2da4131f53d80a3a099db898ad6de Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=93scar=20Fern=C3=A1ndez=20Romano?= <47836840+OskarFreestyle@users.noreply.github.com> Date: Tue, 26 Aug 2025 14:47:58 +0200 Subject: [PATCH 07/13] Update metaxr.md --- metaxr.md | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/metaxr.md b/metaxr.md index e02fb4b..e9a1040 100644 --- a/metaxr.md +++ b/metaxr.md @@ -31,13 +31,13 @@ Integrate HISPlayer SDK with the **[Meta XR All-in-One SDK](https://developer.oc 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

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. It is possible that during the remaining processes new errors and warnings may arise that need to be fixed again.

-image + 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. @@ -51,7 +51,9 @@ When setting up the Meta XR All-in-One SDK in Unity, you’ll be asked to pick o 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 +

+ image +

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

-image + image

### 180 Degrees Video Playback @@ -144,7 +146,9 @@ If you see the following errors and warning in HISPlayerSettings after copying t ### 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 by Meta and ignore the HISPlayer warning. -image +

+ image +

### Vertically Inverted Video Issue From 73246d8e34c2c0550a0d9ce9382e1fd8bf9e1ae7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=93scar=20Fern=C3=A1ndez=20Romano?= <47836840+OskarFreestyle@users.noreply.github.com> Date: Tue, 26 Aug 2025 15:47:21 +0200 Subject: [PATCH 08/13] Update metaxr.md --- metaxr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/metaxr.md b/metaxr.md index e9a1040..5a8fcb7 100644 --- a/metaxr.md +++ b/metaxr.md @@ -34,7 +34,7 @@ First, please configure the Unity project for Oculus by following this [Tutorial image

-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. It is possible that during the remaining processes new errors and warnings may arise that need to be fixed again. +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 From fbfe7632d88ec26850e873d7797128fbd5ed443d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=93scar=20Fern=C3=A1ndez=20Romano?= <47836840+OskarFreestyle@users.noreply.github.com> Date: Tue, 26 Aug 2025 15:49:22 +0200 Subject: [PATCH 09/13] Update metaxr.md --- metaxr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/metaxr.md b/metaxr.md index 5a8fcb7..9c76b32 100644 --- a/metaxr.md +++ b/metaxr.md @@ -52,7 +52,7 @@ To install these plugins, open **Package Manage > Install Package by Name**, typ Go to **Project Settings → XR Plug-in Management** and make sure that the provider you’ve chosen (Oculus XR or OpenXR) is checked.

- image + image

## Import HISPlayer SDK From c81e3f89f91276cbf21d9134c827b9b993d42812 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=93scar=20Fern=C3=A1ndez=20Romano?= <47836840+OskarFreestyle@users.noreply.github.com> Date: Tue, 26 Aug 2025 16:28:02 +0200 Subject: [PATCH 10/13] Update metaxr.md --- metaxr.md | 1 + 1 file changed, 1 insertion(+) diff --git a/metaxr.md b/metaxr.md index 9c76b32..379ec01 100644 --- a/metaxr.md +++ b/metaxr.md @@ -147,6 +147,7 @@ If you see the following errors and warning in HISPlayerSettings after copying t 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 by Meta and ignore the HISPlayer warning.

+ image image

From c67d313018f72db5897d301d3a1ff82ca66ffdee Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=93scar=20Fern=C3=A1ndez=20Romano?= <47836840+OskarFreestyle@users.noreply.github.com> Date: Tue, 26 Aug 2025 16:28:45 +0200 Subject: [PATCH 11/13] Update metaxr.md --- metaxr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/metaxr.md b/metaxr.md index 379ec01..814818f 100644 --- a/metaxr.md +++ b/metaxr.md @@ -145,7 +145,7 @@ If you see the following errors and warning in HISPlayerSettings after copying t ### 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 by Meta and ignore the HISPlayer warning. +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 Meta Quest usage and ignore the HISPlayer warning.

image image From c60b4163f3df077a5930725438a65de0c639c8c7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=93scar=20Fern=C3=A1ndez=20Romano?= <47836840+OskarFreestyle@users.noreply.github.com> Date: Tue, 26 Aug 2025 16:31:01 +0200 Subject: [PATCH 12/13] Update metaxr.md --- metaxr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/metaxr.md b/metaxr.md index 814818f..4e2816c 100644 --- a/metaxr.md +++ b/metaxr.md @@ -145,7 +145,7 @@ If you see the following errors and warning in HISPlayerSettings after copying t ### 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 Meta Quest usage and ignore the HISPlayer warning. +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 From 6c76810447cd477de950e8ed55234c80daadd815 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=93scar=20Fern=C3=A1ndez=20Romano?= <47836840+OskarFreestyle@users.noreply.github.com> Date: Tue, 26 Aug 2025 16:32:13 +0200 Subject: [PATCH 13/13] Update metaxr.md --- metaxr.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/metaxr.md b/metaxr.md index 4e2816c..a549b6d 100644 --- a/metaxr.md +++ b/metaxr.md @@ -148,7 +148,7 @@ If you see the following errors and warning in HISPlayerSettings after copying t 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 + image

### Vertically Inverted Video Issue