omniverse-realtime-viewer

Omniverse Realtime Viewer

これは、Omniverse Realtime Viewer スキルパッケージの最上位エントリーポイントです。 自己完結型であり、必要なルーティング、規約、検証ガイダンスはすべて、選択したリファレンスに記載されています。

実装手順として、対象を絞ったリファレンスドキュメントを使用してください。このファイルでは、適切な手順を選択し、生成するすべてのビューアアプリで守るべきアーキテクチャ上のルールを示します。

Instructions

まず、要求されたビューアを分類し、その提供経路と機能に必要なリファレンスだけを読んでください。最初にレンダリング経路を実装し、その上にインタラクションと UI の動作を重ね、最後に references/validation.md に基づいて検証の証跡を記録してください。

Read Order

1. 提供経路と対象を絞ったリファレンスを選ぶため、references/routing.md を読んでください。
2. カメラ、入力、選択、ビューポート、ストリーミングプロトコル、シーン読み込み、または環境の動作を実装する前に、references/conventions.md を読んでください。
3. 幅広いビューアの要求では、references/usd-viewer-app/README.md を読んでください。
4. 提供経路が不明な場合は、references/streaming-vs-local/README.md を読んでください。
5. プロンプトにレイアウト、パネル、コントロール、インスペクター、ステータス、または UX が含まれている場合は、references/viewer-ux-workflow/README.md を読み、その後、対象を絞ったビューア UI リファレンスを読んでください。 これは、React/WebRTC、Tauri、Electron、ovui、ovwidgets、Dear ImGui の各アプリに適用されます。「フロントエンド」とは、ブラウザー UI だけでなく、ユーザー向け UI を意味します。
6. ビューポートのインタラクションについては、references/camera-controls/README.md、references/native-picking-selection/README.md、または references/object-selection/README.md より先に、references/viewer-input-routing/README.md を読んでください。
7. 新しいビューアアプリや ovrtx の作業では、レンダラー、シーン読み込み、ステージ管理、カメラ、選択、またはトランスフォーム書き込みのリファレンスより先に、ovstage のリファレンスを読んでください。
8. NVCF のセルフホスト可能なデプロイでは、選択したクラウドデプロイとストリーミングのリファレンスより先に、references/cloud-deployment/nvcf-self-hosted.md を読んでください。
9. 要求されたアプリに必要な、対象を絞った機能リファレンスだけを読んでください。
10. 引き渡しの前に、レビュー用の証跡を記録するため references/validation.md を使用してください。

Non-Negotiables

• すべての USD および 3D レンダリングに ovrtx を使用してください。
• ブラウザーアプリでは、ovstream の WebRTC ビデオストリームと UI を表示します。ブラウザーで USD ジオメトリをレンダリングしてはいけません。
• WebGL、Three.js、Babylon.js、PlayCanvas、A-Frame、model-viewer、react-three-fiber、glTF ブラウザービューア、その他のクライアント側 3D レンダラーに置き換えてはいけません。
• GPU／ランタイム環境がなくローカル検証を実行できない場合は、ovrtx の経路を用意し、ランタイム要件を記載してください。ブラウザーレンダラーへのフォールバックを追加してはいけません。
• ユーザーの USD ファイルは変更しないでください。ビューアのカメラ、レンダー製品、レンダー変数、設定、選択メタデータ、ランタイム状態は、セッション／コンポジットレイヤー、OVStage ランタイム状態、またはアプリ状態に保持してください。
• renderer.step()、ステージの変更、ネイティブピッキング、選択の書き込み、OVStage の公開、ライブ属性の書き込みは、それぞれ単一の所有者にまとめてください。
• 交換可能なトランスフォームアニメーション、マテリアル／エフェクト属性、表示切り替え、物理ポーズサンプル、可逆なビューア所有状態には、OVStage ランタイム書き込みを使用してください。レンダリング、ピックキュー、選択アウトライン表示には、ネイティブの OVRTX API を使用してください。
• 依存関係の取得方法は references/dependencies/README.md に、デプロイ方法は references/cloud-deployment/README.md に集約してください。パッケージの場所やデプロイ設定を重複して記載しないでください。

注目のリファレンスファミリー

• エントリーポイントとレシピ: references/usd-viewer-app/README.md、references/streaming-viewer-recipe/README.md、 references/ovui-local-viewer-recipe/README.md、references/streaming-vs-local/README.md、references/electron-shm-viewer/README.md、 references/ovwidgets-editor-shell/README.md。
• レンダリングとステージ: references/ovstage-runtime/README.md、references/ovstage-population/README.md、 references/ovstage-data-plane/README.md、references/ovstage-ovrtx-integration/README.md、 references/ovrtx-rendering/README.md、references/stage-loading/README.md、 references/stage-management/README.md、references/render-settings/README.md、 references/aov-switching/README.md、references/stage-hierarchy/README.md、 references/stage-queries/README.md、references/stage-attribute-reads/README.md、 references/camera-auto-select/README.md、references/camera-picker/README.md、 references/prim-transform-safety/README.md、references/usd-sample-data/README.md。
• 配信とランタイム: references/streaming-server/README.md、references/streaming-client/README.md、 references/streaming-messages/README.md、references/streaming-lifecycle/README.md、references/local-viewer/README.md、 references/tauri-local-viewer/README.md、references/cpp-native-viewer/README.md、references/headless-shm-cli/README.md、 references/viewer-backend-interface/README.md、references/webgl-shm-transport/README.md。
• ビューアーの UI/UX: references/viewer-ux-workflow/README.md、references/viewer-layout-patterns/README.md、 references/viewer-control-patterns/README.md、references/viewer-data-view-patterns/README.md、 references/viewer-feedback-status/README.md。
• インタラクション: references/viewer-input-routing/README.md、references/camera-controls/README.md、 references/object-selection/README.md、references/native-picking-selection/README.md、references/selection-feedback/README.md、 references/physics-simulation/README.md、 references/selection-animation/README.md、references/transform-manipulator/README.md、references/gl-viewport-overlay/README.md、 references/ovui-library/README.md、references/prim-pick-effects/README.md、references/prim-info-display/README.md、 references/viewport-overlays/README.md、references/physics-simulation/README.md。
• インフラストラクチャ: references/dependencies/README.md、references/windows-native-setup/README.md、references/cloud-assets/README.md、 references/cloud-deployment/README.md、references/cloud-deployment/nvcf-self-hosted.md、 references/cloud-deployment/nvcf-viewer-container-contract.md、 references/cloud-deployment/gpu-container-runtime.md、 references/cloud-deployment/container-image-build.md、 references/cloud-deployment/webrtc-network-diagnostics.md、references/troubleshooting/README.md。
• AI/エージェント: references/a2ui-scene-copilot/README.md。
• CAE/CFD 可視化: references/cae-cfd-visualization/README.md、 references/cae-cfd-visualization/data-and-operators.md、 references/cae-cfd-visualization/cae-data-ingestion.md、 references/cae-cfd-visualization/temporal-playback.md、 references/cae-cfd-visualization/usd-authoring-and-materials.md、 references/cae-cfd-visualization/ovstage-render-and-camera.md、 references/cae-cfd-visualization/ovui-controls.md、 references/cae-cfd-visualization/glyphs.md、 references/cae-cfd-visualization/volume-rendering.md、 references/cae-cfd-visualization/driving-cae-viz-via-ovstage.md、 references/cae-cfd-visualization/emitter-and-seed-sources.md、 references/cae-cfd-visualization/streaming-cae-viewer.md、 references/cae-cfd-visualization/rtwt-blueprint-recreation.md、 references/cae-cfd-visualization/coordinate-systems-and-up-axis.md。

ビルドのワークフロー

1. プロンプトを、提供方法、対象ユーザー、必要な機能、実行環境、検証要件、明示された制約に基づいて分類します。
2. 少数の参考資料を選びます。まずレシピまたはルーティングの参考資料を確認し、次にカメラ、ピッキング、階層、プロパティ、レンダリング設定、トランスフォームツール、クラウドアセット、デプロイなど、焦点を絞った機能を追加します。
3. アプリのコードを書く前に、選択した参考資料を読みます。ビルドの順序、インポートの順序、データチャネルの契約、レンダラーの所有権ルールに従います。
4. まず OVStage のデータ投入／データプレーン経路とコアレンダリング経路を実装し、次に入力ルーティングとカメラ、次に選択とデータパネル、次にシーン／設定の機能、最後にパッケージ化またはデプロイを実装します。
5. API の形状、互換性、生成されるプロジェクト構造について、選択した参考資料を動作仕様として扱います。
6. ビューアーの準備が整ったと判断する前に、検証の証拠を取得します。

例

• ブラウザー用ビューアーの依頼では、ストリーミングのレシピを参考にし、カメラ、ピッキング、階層、プロパティ、レンダリング設定、ストリーム状態の参考資料を追加します。
• ローカルワークステーション用ビューアーの依頼では、ローカルまたはネイティブの提供方法に関する参考資料に加え、レンダラーのセットアップ、ステージの読み込み、ビューポート入力、検証の参考資料を使用します。
• 「CAE/CFD データをリアルタイムで可視化する」依頼では、CAE/CFD を単独のアプリではなくレイヤーとして扱います。まず提供方法を選択し（references/streaming-vs-local/README.md）、対応するレシピ（references/ovui-local-viewer-recipe/README.md または references/streaming-viewer-recipe/README.md）を使って基本ビューアーを構築します。次に references/cae-cfd-visualization/README.md（データ → オペレーター → USD オーサリング → シーン）を重ね、references/cae-cfd-visualization/driving-cae-viz-via-ovstage.md を通じてコントロールを接続します。

完了チェックリスト

• 選択した参考資料が、ユーザーの意図と提供方法に合っています。
• USD に対するブラウザー側の 3D レンダラーを使用するコードパスはありません。
• 生成されたアプリでは、レンダリングのステップ実行とステージの変更を担当する箇所が明確に 1 つあります。
• ユーザーの USD ファイルは、ビューアーが所有するセッションデータによって変更されません。
• カメラ、入力、選択、シーン読み込み、ストリームの動作は references/conventions.md に従っています。
• セットアップ／ビルド／実行の結果と、視覚的な操作の証拠が references/validation.md に沿って取得されています。

ovstage の参考資料

新しいビューアーアプリケーションでは、レンダラー、シーン、インタラクション、提供方法に関する参考資料を確認する前に、次の資料を読んでください。

• references/ovstage-runtime/README.md — ランタイムの所有権、オーディナル、パブリケーション、復旧。
• references/ovstage-population/README.md — 合成された USD のデータ投入とシーンの世代。
• references/ovstage-data-plane/README.md — クエリ、書き込み、トランスフォーム、ランタイム DTO。
• references/ovstage-ovrtx-integration/README.md — 接続されたレンダラーループとランタイム統合の契約。