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. 要求されたアプリに必要な機能のリファレンスだけを読みます。
8. 引き渡し前に、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 ファイルは変更しないでください。ビューアーのカメラ、レンダープロダクト、レンダーバー、設定、選択メタデータ、ランタイム状態は、セッションレイヤー、コンポジットレイヤー、またはアプリの状態に保持します。
• renderer.step()、ステージの変更、ネイティブピッキング、選択への書き込み、ライブ属性への書き込みは、それぞれ単一の所有者に任せます。
• 依存関係の取得方法は 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/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/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/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/dependencies/README.md、references/windows-native-setup/README.md、references/cloud-assets/README.md、 references/cloud-deployment/README.md、references/troubleshooting/README.md。

ビルドのワークフロー

1. プロンプトを、配信経路、対象ユーザー、必要な機能、ランタイム環境、検証要件、明示された制約に基づいて分類します。
2. 少数のリファレンスを選択します。レシピまたはルーティングのリファレンスから始め、カメラ、ピッキング、階層、プロパティ、レンダリング設定、トランスフォームツール、クラウドアセット、デプロイなどの機能に特化したリファレンスを追加します。
3. アプリのコードを書く前に、選択したリファレンスを読みます。ビルド順序、インポート順序、データチャネルの契約、レンダラーの所有権ルールに従います。
4. まずコアとなるレンダリング経路を実装し、次に入力ルーティングとカメラ、その後に選択機能とデータパネル、続いてシーン機能と設定、最後にパッケージ化またはデプロイを実装します。
5. API の形式、互換性、生成されるプロジェクト構造に関する動作契約として、選択したリファレンスを扱います。
6. ビューアーの準備が整ったと判断する前に、検証の証拠を記録します。

例

• ブラウザービューアーのリクエストでは、ストリーミングのレシピリファレンスに加え、カメラ、ピッキング、階層、プロパティ、レンダリング設定、ストリームステータスのリファレンスを使用します。
• ローカルワークステーションビューアーのリクエストでは、ローカルまたはネイティブ配信のリファレンスに加え、レンダラーのセットアップ、ステージの読み込み、ビューポート入力、検証のリファレンスを使用します。

完了チェックリスト

• 選択したリファレンスが、ユーザーの意図と配信経路に合致している。
• USD に対して、ブラウザー側の 3D レンダラーを使用するコード経路がない。
• 生成されたアプリで、レンダリングのステップ実行とステージの変更をそれぞれ一元的に管理している。
• ユーザーの USD ファイルが、ビューアー側のセッションデータによって変更されない。
• カメラ、入力、選択、シーンの読み込み、ストリームの動作が references/conventions.md に従っている。
• セットアップ／ビルド／実行の結果と、視覚的な操作の証拠が references/validation.md に記録されている。