対応ヘッドセット

このページでは、QtQuick3D.Xrがテストされ、サポートされているプラットフォームおよびデバイスについて概要を説明します。

XRプラットフォームの基本概念

QtQuick3D.Xrは、アプリケーション開発のAPIとしてOpenXRを採用するデバイスと、AppleのvisionOSを採用するデバイスの2つの主要プラットフォームをサポートしています。

OpenXR

OpenXRは、XRアプリケーションの開発に向けた共通のAPIセットを提供するオープンスタンダードです。OpenXRの実装は、AndroidやWindowsなど、さまざまなプラットフォームで利用可能です。

一部のVR/ARデバイスは、それ自体が完全なアプリケーション展開および実行プラットフォームとなっています。例えば、Meta Quest 3は、Androidベースの完全かつ独立したデバイスです。アプリケーション開発者の観点から見ると、そのワークフローはAndroidスマートフォンやタブレット向けの開発と非常に似ています。このようなデバイスとそのソフトウェアプラットフォームは、Standalone VR と呼ばれることもあります。

一方、他のヘッドセットは、完全なアプリケーション展開および実行プラットフォームを提供せず、通常はWindowsやLinuxを実行するコンピュータと組み合わせて使用されます。この場合、アプリケーションによってレンダリングされたコンテンツは、有線または無線接続を介してヘッドセットにストリーミングされます。 この構成は、PCVR と呼ばれることもあります。この場合、アプリケーションは通常のWindowsやLinuxのデスクトップアプリケーションとして開発・デプロイされます。ただし、一般的なデスクトップアプリケーションのように画面上にウィンドウを開いてコンテンツを表示するのではなく、OpenXRやDirect 3D、Vulkanなどの3D APIを介してオフスクリーンバッファにレンダリングされます。 生成されたコンテンツは、表示のためにヘッドセットへストリーミングされます。実際のストリーミングおよび関連する処理は、Qtやアプリケーションに対して透過的に、基盤となるソフトウェアスタックによって管理されます。このようなヘッドセットの例としては、Varjo社のいくつかのデバイスや、HTC Viveシリーズの非スタンドアロン型デバイスなどが挙げられます。

一部のデバイスは両方のカテゴリに該当します。特に、Meta Quest 3は両方の動作モードに対応しています。

スタンドアロン型デバイスでは、すべてのレンダリングと処理がヘッドセット自体で行われます。OpenXRおよび基盤となるランタイム環境の実装は1つだけであり、アプリケーションはデバイス上で起動された際にこれを使用します。

非スタンドアロン型デバイスでは、すべてのレンダリングおよび関連する処理の大部分がホストPC上で行われます。 品質とパフォーマンスはホストPCの性能に大きく依存しますが、ストリーミング技術や、無線ネットワークの帯域幅などの関連要因も結果に影響を与える可能性があります。PCVRの世界では、OpenXRの実装と有線または無線のストリーミングを提供する複数のソリューションが存在します。

OpenXRに基づかないデバイスおよびプラットフォーム

Qt Quick 3D Xrは現在、OpenXR以外のプラットフォームとして、AppleのvisionOSのみをサポートしています。Apple Vision Proなどのデバイスは、「Standalone VR 」のカテゴリに分類されます。

テストおよび検証済みのヘッドセット（ティア1）

これは、Qtによって定期的にテストおよび検証が行われ、Qt Quick 3D Xrの開発において積極的に使用されているデバイスのリストです。

• Meta Quest 3、スタンドアロン（Android）
• Meta Quest 3、PCVRモード（Windows）
• Apple Vision Pro、スタンドアロン（visionOS）

テストおよび検証済みのヘッドセット、ティア2

これは、Qt Quick の3D XR開発中に随時テストが行われている追加デバイスのリストです。動作は期待されますが、すべての機能が保証されるわけではありません。

• Meta Quest 2、スタンドアロン（Android）
• HTC Vive（PCVRモード、Linux）

特別な開発環境

これは、Qt Quick の3D XR開発中に使用されるVRシミュレーターソリューションの一覧であり、アプリケーション開発者にとっても役立つ可能性があります。これらのソリューションでは、特にAR機能に関して、すべての機能が保証されるわけではありません。

• Meta XR Simulator(Windows)。これはWindows向けのOpenXR実装であり、デスクトップウィンドウ内で左目と右目のレンダリングされたコンテンツを別々に表示するとともに、入力コントローラーのシミュレーションやその他多くの開発者向け機能を提供します。アプリケーションの観点からは、このシミュレーターを使用してもWindows上のPCVRと何ら変わりはありません。

追加の注意事項

前述の通り、Pico 4など、OpenXRを採用している他のデバイスでも動作する可能性がありますが、Qtによる検証は行われていません。テスト済みのデバイスのリストは、今後のQtリリースにおいて変更や追加が行われることが予想されます。

PCVRに関しては、考慮すべきソフトウェアスタックの詳細や複雑な要素がさらに存在します。詳細については、PCVR専用のページを参照してください。

Qt Quick 3D Xrは、デフォルトでデバッグ出力に警告を出力します。診断メッセージは、初期設定では出力されません。これらを有効にするには、「qt.quick3d.xr 」ロギングカテゴリを有効にしてください。例えば、環境変数QT_LOGGING_RULES=qt.quick3d.xr=true を設定します。詳細については、QLoggingCategory を参照してください。問題が発生した場合や、アプリケーションが期待通りに起動しない場合は、追加のデバッグ出力を有効にすることを強く推奨します。 問題を報告する際は、必ずエラーレポートにログの全文を含めてください。XRアプリケーションの実行方法は多岐にわたり、特にOpenXRが関与している場合は、何が起きているかをより正確に把握するために、これらのログが不可欠となります。