Oculus Integration インポート手順
最終更新：
orika_ex_miyako 2026年05月06日(水) 14:29:03履歴
本記事では、Unityに Oculus Integration を導入し、Meta Quest でVR開発を開始できる状態までの手順を解説します。
初心者の方でも迷わないように、「なぜこの設定が必要か」も含めて説明しています。
Oculus Integration と Meta XR SDK について
2023年10月より Oculus Integration が非推奨になり、Meta社は新しいSDKである「Meta XR SDK（All-in-One SDK）」への移行を進めています。
Unity Asset Store Oculus Integration (Deprecated)
https://assetstore.unity.com/packages/tools/integr...
Unity Asset Store Meta XR All-in-One SDK
https://assetstore.unity.com/packages/tools/integr...
なお、Meta XR DK の一部の機能のみ使いたいのであれば、Unity のパッケージマネージャー経由で UPM としてインストールも可能です。
ただし Meta の公式サイトでは、XR SDK のすべての機能を利用できるようにするため、アセットストア経由でのインポートを勧めています。
詳細は下記の公式サイトをご確認ください。
Meta
Meta XR UPMパッケージ
https://developers.meta.com/horizon/documentation/...
Meta
Unityアセットストアからパッケージをダウンロードしてインポートする
https://developers.meta.com/horizon/documentation/...
Meta
Oculus統合SDKパッケージをインポートする(レガシー)
https://developers.meta.com/horizon/documentation/...
全体の流れ
まず最初に、全体の流れを確認しておきます。
この順番に合わせて記事も作成していますので、この手順でで進めれば動作する状態になります。
��Oculus Integration のインポート
Unityに Oculus Integration をインポートする際の確認画面です。アセットストアからリダイレクトされて PackageManager ウインドウが表示されます。
Oculus関連の各機能（Audio / Interaction / VR など）が一覧表示されます。
基本的にはすべてチェックを入れたまま「Import」をクリックしてください。
内容が不足していると後からエラーや動作不良の原因になります。ただし、SampleFramework は不要なら外してもらって構いません。
Oculus Integration をインポートすると、いくつかのダイアログ（警告や確認）が表示されます。
それぞれ内容と対応方法が異なるため、順番に解説します。
なお、これらのダイアログは初回インポート時に必ず表示されますが、すべて正常な処理なので安心して進めて問題ありません。
��Interaction SDK のクリーンアップ
１．Interaction SDK の事前確認
インポート直後に、Interaction SDK の構成整理を行う前段階の確認画面です。
Oculus Integration はバージョンごとにフォルダ構成が変わるため、「古い構成」と「新しい構成」とが混ざる可能性があります。
「Show Assets（Recommended）」をクリックしてください。削除・変更されるファイルを事前に確認できます。
Oculus Integration 内の古い Interaction SDK 関連ファイルを削除する処理です。
これは主に「バージョンアップによる構成変更」や「古いファイルとの競合防止」のために表示されます。
「Clean Up（Recommended）」をクリックして、クリーンアップを行ってください。
２．クリーンアップ最終確認
Interaction SDK のクリーンアップ処理における最終確認ダイアログです。
削除処理は取り消しできないため、ユーザーに最終判断を求めています。
「Clean Up Package」をクリックして進めてください。
�� プラグイン更新系ダイアログ・Unity 再起動
１．OVRPlugin アップデート確認
Oculus のコアプラグインに新しいバージョンがあるため、更新するか確認しているダイアログです。
「Yes」をクリックしてください。更新することでバグ修正が入ったり、新機能対応が追加されたり、デバイスの互換性向上が見込めます。
２．OVRPlugin 更新による再起動
Oculus の内部プラグイン（OVRPlugin）が自動で更新されたため、Unityエディタの再起動が必要という通知です。
このプラグインは、ヘッドセットとの通信やトラッキングに関わる重要な部分です。
再起動しないと正常に動作しない場合があります(特にVRプレビューや実機接続で問題が出る原因になります)ので、「Restart」をクリックして Unity を再起動してください。
３、Spatializer Plugin アップデート
3Dオーディオ（立体音響）プラグインの更新です。
アップグレードすることで、音の位置表現の改善、バグの修正、新しいデバイス対応といった機能が受けられます。
「Upgrade」をクリックしてください。
古いプラグインは .old として残るため、完全に削除されるわけではありません。安全に更新できます。
４．Spatializer Plugin 更新（再起動）
3Dオーディオ（空間音響）関連のプラグインが更新された通知です。
音声系プラグインもネイティブコードで動作するため、Unity 再起動しないと更新が反映されません。
再起動しない場合の問題点としては、「音が出ない」「位置による音の変化が効かない」「エラーの原因になる」といったことがあげられます。
「Restart」をクリックして、Unity を再起動してください。
�� OpenXR設定
１．OpenXR Backend の選択
Oculus の実行方式を
・新しい方式（OpenXR）
・従来方式（Legacy）
どちらにするか選ぶ画面です。
基本は「Use OpenXR」を選択してください。
現在の主流は OpenXR であり、Meta（旧Oculus）も OpenXR を推奨しています。
また、Passthrough（現実映像）などは OpenXR 限定の機能です。
以下の場合のみ Legacy を検討してください。
・古いプロジェクトをそのまま動かす
・Rift の特殊機能を使う
２．OpenXR 有効化の最終確認
先ほど選択した OpenXR が正式に適用されたことを知らせる確認ダイアログです。
「OK」をクリックで問題ありません。
�� Unity（XR / Android設定）
１．XR Plug-in Management の設定
Unityの XR Plug-in Management の設定画面です。Project Settings 内の XR Plug-in Management を選択します。
VR機能を有効にするための最も重要な設定の一つです。ここでは、UnityがどのVRプラグインを使用するかを指定します。
以下の２つの項目にチェックを入れてください。
✔ Initialize XR on Startup：ON → 起動時に自動でVRを有効化する設定です。OFF だと、VRとして起動しない(カメラが通常視点のままになる）
✔ Oculus：チェックON → Oculusデバイス（Meta Quest）と接続するために必要です。OFF だとヘッドセットが認識されない(VR表示されない)
２．Player Settings −Android設定
VRアプリとしてビルドするための基本設定（Android向け設定）を行います。Project Settings 内の Player Settings を選択します。
主に Oculus（Meta Quest）向けに必要な設定を確認・変更します。
Meta Quest は Android ベースのため、この設定が正しくないとビルドや動作に問題が出ます。
APIが低すぎるとビルドエラーが発生したり、ストア提出時に弾かれる可能性あります。
Minimum API Level の選択ドロップダウン画面です。
API Level はMeta Quest の仕様や最新の SDK の機能を利用するための要件になります。
またストア公開の要件にもなっていますので、なるべく高めで設定します(低すぎると動きません。)
Android 7.0'Nougat'（API Level 24）以上を選択してください。
推奨としては Android 10.0(API Level 29)以上になります。
Oculus（Meta Quest）向けの設定として、Unityが自動的に Minimum API Level を 23（Android 6.0）に変更したことを示すログです。
３．Player Settings − Graphics API（描画設定）の確認
Player Settings 内の「Rendering」設定です。こちらも Android 内の設定画面から行います。
描画APIは、VRのパフォーマンスや安定性に直接影響します。
OpenGLES3 は必須(メイン)、Vulkan は任意です。
OpenGLES3 をメインに使う理由としては、Meta Quest の標準対応であり、安定性の高さや不具合が少ないといった点です。
Vulkan は環境依存による不具合が出るケースがあります。
なお OpenGLES2 は非対応ですので、削除推奨になります。
�� 最終確認
PackageManager ウインドウを開き、パッケージが正常にインポートされているか最終確認します。
１．Oculus XR Plugin の確認
このパッケージは、UnityとOculusデバイスを接続するための公式プラグインです。
これが無いと、VRとして起動しなかったり、ヘッドトラッキングが動かなかったり、コントローラー入力が取得できないといった不具合が発生します。
XR Plugin Management とセットで動作しますので、VR 開発の必須パッケージです。
２．Oculus Integration の確認（Package Manager）
Package Manager 上で Oculus Integration がインポート済みであることを確認する画面です。
Asset Store からインポートされたパッケージが、プロジェクト内に正常に追加されている状態であることを確認します。
まれにインポートが失敗し、ファイルが欠損してしまったり、あるいはバージョンの不整合が発生したりします。
それらの問題がある場合には警告アイコンが表示されますので、その際には再インポートをおこなったり、Re-Download を実行してください。
参考サイト
参考にさせていただきました。ありがとうございます。
初心者の方でも迷わないように、「なぜこの設定が必要か」も含めて説明しています。
Oculus Integration と Meta XR SDK について 
2023年10月より Oculus Integration が非推奨になり、Meta社は新しいSDKである「Meta XR SDK（All-in-One SDK）」への移行を進めています。
Unity Asset Store Oculus Integration (Deprecated)
https://assetstore.unity.com/packages/tools/integr...
Unity Asset Store Meta XR All-in-One SDK
https://assetstore.unity.com/packages/tools/integr...
なお、Meta XR DK の一部の機能のみ使いたいのであれば、Unity のパッケージマネージャー経由で UPM としてインストールも可能です。
ただし Meta の公式サイトでは、XR SDK のすべての機能を利用できるようにするため、アセットストア経由でのインポートを勧めています。
詳細は下記の公式サイトをご確認ください。
Meta
Meta XR UPMパッケージ
https://developers.meta.com/horizon/documentation/...
Meta
Unityアセットストアからパッケージをダウンロードしてインポートする
https://developers.meta.com/horizon/documentation/...
Meta
Oculus統合SDKパッケージをインポートする(レガシー)
https://developers.meta.com/horizon/documentation/...
全体の流れ
まず最初に、全体の流れを確認しておきます。
�� Oculus Integration をインポート �� Interaction SDK のクリーンアップ �� プラグイン更新系ダイアログ・Unity 再起動 �� OpenXR設定 �� Unity（XR / Android設定） �� 最終確認
この順番に合わせて記事も作成していますので、この手順でで進めれば動作する状態になります。
��Oculus Integration のインポート
Unityに Oculus Integration をインポートする際の確認画面です。アセットストアからリダイレクトされて PackageManager ウインドウが表示されます。
Oculus関連の各機能（Audio / Interaction / VR など）が一覧表示されます。
基本的にはすべてチェックを入れたまま「Import」をクリックしてください。
内容が不足していると後からエラーや動作不良の原因になります。ただし、SampleFramework は不要なら外してもらって構いません。
Oculus Integration をインポートすると、いくつかのダイアログ（警告や確認）が表示されます。
それぞれ内容と対応方法が異なるため、順番に解説します。
なお、これらのダイアログは初回インポート時に必ず表示されますが、すべて正常な処理なので安心して進めて問題ありません。
��Interaction SDK のクリーンアップ
１．Interaction SDK の事前確認
このツールはクリーンアップ処理を行い、 Interaction SDK のファイルを整理・移動し、 互換性のための不要ファイルを削除します。 「Show Assets」を押すと対象一覧が表示されます。 その後、クリーンアップを実行できます。
インポート直後に、Interaction SDK の構成整理を行う前段階の確認画面です。
Oculus Integration はバージョンごとにフォルダ構成が変わるため、「古い構成」と「新しい構成」とが混ざる可能性があります。
「Show Assets（Recommended）」をクリックしてください。削除・変更されるファイルを事前に確認できます。
削除対象のアセットがあります（完全に削除されます） （大量のファイル一覧が表示される）
Oculus Integration 内の古い Interaction SDK 関連ファイルを削除する処理です。
これは主に「バージョンアップによる構成変更」や「古いファイルとの競合防止」のために表示されます。
「Clean Up（Recommended）」をクリックして、クリーンアップを行ってください。
２．クリーンアップ最終確認
削除対象のアセットは完全に削除されます。 実行前にバックアップを強く推奨します。
Interaction SDK のクリーンアップ処理における最終確認ダイアログです。
削除処理は取り消しできないため、ユーザーに最終判断を求めています。
「Clean Up Package」をクリックして進めてください。
�� プラグイン更新系ダイアログ・Unity 再起動
１．OVRPlugin アップデート確認
新しい OVRPlugin が利用可能です。 最新版の使用が推奨されています。 有効にしますか？ 現在のバージョン：不明 利用可能バージョン：1.78.0
Oculus のコアプラグインに新しいバージョンがあるため、更新するか確認しているダイアログです。
「Yes」をクリックしてください。更新することでバグ修正が入ったり、新機能対応が追加されたり、デバイスの互換性向上が見込めます。
２．OVRPlugin 更新による再起動
OVRPlugin が 1.78.0 に更新されました。 アップデートを完了するために Unity Editor を再起動してください。
Oculus の内部プラグイン（OVRPlugin）が自動で更新されたため、Unityエディタの再起動が必要という通知です。
このプラグインは、ヘッドセットとの通信やトラッキングに関わる重要な部分です。
再起動しないと正常に動作しない場合があります(特にVRプレビューや実機接続で問題が出る原因になります)ので、「Restart」をクリックして Unity を再起動してください。
３、Spatializer Plugin アップデート
新しい Spatializer プラグインが見つかりました。 アップグレードしますか？ アップグレードすると、古いプラグインは 「.old」としてリネームされます。
3Dオーディオ（立体音響）プラグインの更新です。
アップグレードすることで、音の位置表現の改善、バグの修正、新しいデバイス対応といった機能が受けられます。
「Upgrade」をクリックしてください。
古いプラグインは .old として残るため、完全に削除されるわけではありません。安全に更新できます。
４．Spatializer Plugin 更新（再起動）
Spatializer プラグインが更新されました。 アップデートを完了するために Unity を再起動してください。
3Dオーディオ（空間音響）関連のプラグインが更新された通知です。
音声系プラグインもネイティブコードで動作するため、Unity 再起動しないと更新が反映されません。
再起動しない場合の問題点としては、「音が出ない」「位置による音の変化が効かない」「エラーの原因になる」といったことがあげられます。
「Restart」をクリックして、Unity を再起動してください。
�� OpenXR設定
１．OpenXR Backend の選択
OpenXR は Oculus で完全にサポートされています。 ただし、一部機能はまだ完全には対応していません。 以下の機能を使用している場合は「Cancel」を押して 従来のバックエンドを使用してください： ・Rift の Mixed Reality Capture 新機能（Passthrough API など）は OpenXR のみ対応です。 バックエンドは後からいつでも切り替え可能です。
Oculus の実行方式を
・新しい方式（OpenXR）
・従来方式（Legacy）
どちらにするか選ぶ画面です。
基本は「Use OpenXR」を選択してください。
現在の主流は OpenXR であり、Meta（旧Oculus）も OpenXR を推奨しています。
また、Passthrough（現実映像）などは OpenXR 限定の機能です。
以下の場合のみ Legacy を検討してください。
・古いプロジェクトをそのまま動かす
・Rift の特殊機能を使う
２．OpenXR 有効化の最終確認
OpenXR バックエンドを使用した OVRPlugin がデフォルトで有効になります
先ほど選択した OpenXR が正式に適用されたことを知らせる確認ダイアログです。
「OK」をクリックで問題ありません。
�� Unity（XR / Android設定）
１．XR Plug-in Management の設定
Unityの XR Plug-in Management の設定画面です。Project Settings 内の XR Plug-in Management を選択します。
VR機能を有効にするための最も重要な設定の一つです。ここでは、UnityがどのVRプラグインを使用するかを指定します。
以下の２つの項目にチェックを入れてください。
✔ Initialize XR on Startup：ON → 起動時に自動でVRを有効化する設定です。OFF だと、VRとして起動しない(カメラが通常視点のままになる）
✔ Oculus：チェックON → Oculusデバイス（Meta Quest）と接続するために必要です。OFF だとヘッドセットが認識されない(VR表示されない)
２．Player Settings −Android設定
VRアプリとしてビルドするための基本設定（Android向け設定）を行います。Project Settings 内の Player Settings を選択します。
主に Oculus（Meta Quest）向けに必要な設定を確認・変更します。
・Minimum API Level : Android 7.0'Nougat'（API Level 24）以上 ・Target API Level：Automatic（最新）
Meta Quest は Android ベースのため、この設定が正しくないとビルドや動作に問題が出ます。
APIが低すぎるとビルドエラーが発生したり、ストア提出時に弾かれる可能性あります。
Minimum API Level の選択ドロップダウン画面です。
API Level はMeta Quest の仕様や最新の SDK の機能を利用するための要件になります。
またストア公開の要件にもなっていますので、なるべく高めで設定します(低すぎると動きません。)
Android 7.0'Nougat'（API Level 24）以上を選択してください。
推奨としては Android 10.0(API Level 29)以上になります。
Android の Minimum API Level が 23 に更新されました。 これは Oculus ビルドに必要な最低要件です。
Oculus（Meta Quest）向けの設定として、Unityが自動的に Minimum API Level を 23（Android 6.0）に変更したことを示すログです。
３．Player Settings − Graphics API（描画設定）の確認
Player Settings 内の「Rendering」設定です。こちらも Android 内の設定画面から行います。
描画APIは、VRのパフォーマンスや安定性に直接影響します。
OpenGLES3 は必須(メイン)、Vulkan は任意です。
OpenGLES3 をメインに使う理由としては、Meta Quest の標準対応であり、安定性の高さや不具合が少ないといった点です。
Vulkan は環境依存による不具合が出るケースがあります。
なお OpenGLES2 は非対応ですので、削除推奨になります。
�� 最終確認
PackageManager ウインドウを開き、パッケージが正常にインポートされているか最終確認します。
１．Oculus XR Plugin の確認
このパッケージは、UnityとOculusデバイスを接続するための公式プラグインです。
これが無いと、VRとして起動しなかったり、ヘッドトラッキングが動かなかったり、コントローラー入力が取得できないといった不具合が発生します。
XR Plugin Management とセットで動作しますので、VR 開発の必須パッケージです。
２．Oculus Integration の確認（Package Manager）
Package Manager 上で Oculus Integration がインポート済みであることを確認する画面です。
Asset Store からインポートされたパッケージが、プロジェクト内に正常に追加されている状態であることを確認します。
まれにインポートが失敗し、ファイルが欠損してしまったり、あるいはバージョンの不整合が発生したりします。
それらの問題がある場合には警告アイコンが表示されますので、その際には再インポートをおこなったり、Re-Download を実行してください。
参考サイト
参考にさせていただきました。ありがとうございます。
ForgeVision Engineer Blog 様
Oculus Integrationの廃止と、Meta XR UPM パッケージの採用について
https://techblog.forgevision.com/entry/meta_xr_upm
Qiita @noritsune in Fignny Co.,Ltd. 様
既存プロジェクトをOculus IntegrationからMeta XR SDKに移行した話
https://qiita.com/noritsune/items/24005df368f4154e...
コメントをかく