<!-- SPDX-FileCopyrightText: Copyright (c) 2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved. --> <!-- SPDX-License-Identifier: Apache-2.0 -->
Omniverse Realtime Viewer
Ceci est le point d'entrée de haut niveau pour le package de skill Omniverse Realtime Viewer. Il est autonome : tous les routages, conventions et orientations de validation requis se trouvent dans les références sélectionnées.
Utilisez les documents de référence ciblés comme recettes d'implémentation. Ce fichier choisit les bonnes recettes et préserve les règles architecturales qui doivent s'appliquer à toutes les applications viewer générées.
Instructions
Commencez par classer le viewer demandé, puis lisez uniquement les références nécessaires
pour ce chemin de livraison et cet ensemble de fonctionnalités. Implémentez d'abord le
chemin de rendu, superposez-y le comportement d'interaction et d'interface utilisateur,
et terminez en capturant les preuves de validation de references/validation.md.
Ordre de lecture
- Lisez
references/routing.mdpour choisir le chemin de livraison et les références ciblées. - Lisez
references/conventions.mdavant d'implémenter la caméra, l'entrée, la sélection, le viewport, le protocole de streaming, le chargement de scène ou le comportement de l'environnement. - Pour les demandes de viewer étendues, lisez
references/usd-viewer-app/README.md. - Si le chemin de livraison n'est pas clair, lisez
references/streaming-vs-local/README.md. - Si le prompt inclut la disposition, les panneaux, les contrôles, les inspecteurs, l'état ou l'UX,
lisez
references/viewer-ux-workflow/README.mdpuis les références d'interface utilisateur du viewer ciblé. Ceci s'applique aux applications React/WebRTC, Tauri, Electron,ovui,ovwidgetset Dear ImGui ; « frontend » désigne l'interface utilisateur visible, pas seulement l'interface du navigateur. - Pour l'interaction du viewport, lisez
references/viewer-input-routing/README.mdavantreferences/camera-controls/README.md,references/native-picking-selection/README.mdoureferences/object-selection/README.md. - Lisez uniquement les références de capacité ciblées nécessaires pour l'application demandée.
- Utilisez
references/validation.mdpour capturer les preuves d'examen avant la transmission.
Points non négociables
- Utilisez
ovrtxpour tout rendu USD et 3D. - Les applications navigateur affichent un flux vidéo
ovstreamWebRTC plus l'interface utilisateur. Le navigateur ne rend pas la géométrie USD. - Ne substituez pas WebGL, Three.js, Babylon.js, PlayCanvas, A-Frame, model-viewer, react-three-fiber, des viewers glTF pour navigateur ou d'autres rendeurs 3D côté client.
- Si la validation locale ne peut pas s'exécuter parce que l'environnement GPU/runtime est absent,
structurez le chemin
ovrtxet documentez l'exigence runtime. N'ajoutez pas de fallback de rendu navigateur. - Gardez les fichiers USD des utilisateurs inchangés. Les caméras viewer, les produits de rendu, les variables de rendu, les paramètres, les métadonnées de sélection et l'état runtime appartiennent aux couches de session/composite ou à l'état de l'application.
- Maintenez un seul propriétaire pour
renderer.step(), la mutation de scène, le picking natif, les écritures de sélection et les écritures d'attributs en direct. - Conservez l'acquisition des dépendances dans
references/dependencies/README.mdet les choix de déploiement dansreferences/cloud-deployment/README.md; ne dupliquez pas les emplacements de packages ou la configuration de déploiement.
Familles de références ciblées
- Points d'entrée et recettes :
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. - Rendu et scène :
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. - Livraison et runtime :
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. - Interface utilisateur/UX du viewer :
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. - Interaction :
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. - Infrastructure :
references/dependencies/README.md,references/windows-native-setup/README.md,references/cloud-assets/README.md,references/cloud-deployment/README.md,references/troubleshooting/README.md.
Workflow de construction
- Classez le prompt selon le chemin de livraison, l'utilisateur cible, les capacités requises, l'environnement runtime, les besoins de validation et les contraintes explicites.
- Sélectionnez un petit ensemble de références. Commencez par la référence de recette ou de routage, puis ajoutez des capacités ciblées comme la caméra, le picking, la hiérarchie, les propriétés, les paramètres de rendu, les outils de transformation ou le déploiement cloud.
- Lisez les références sélectionnées avant d'écrire le code de l'application. Suivez leur ordre de construction, ordre d'importation, contrats de canal de données et règles de propriété du rendu.
- Implémentez d'abord le chemin de rendu principal, puis le routage d'entrée et la caméra, puis les panneaux de sélection et de données, puis les fonctionnalités de scène/paramètres, puis l'empaquetage ou le déploiement.
- Traitez les références sélectionnées comme le contrat de comportement pour la forme d'API, la compatibilité et la structure de projet générée.
- Capturez les preuves de validation avant de déclarer le viewer prêt.
Exemples
- Pour une demande de viewer navigateur, utilisez les références de recette de streaming plus la caméra, le picking, la hiérarchie, les propriétés, les paramètres de rendu et les références d'état de flux.
- Pour une demande de viewer workstation local, utilisez les références de livraison locale ou native plus la configuration du rendu, le chargement de scène, l'entrée du viewport et la validation.
Liste de contrôle d'achèvement
- Les références sélectionnées correspondent à l'intention de l'utilisateur et au chemin de livraison.
- Aucun chemin de code n'utilise un rendu 3D côté navigateur pour USD.
- L'application générée a un seul propriétaire clair pour le stepping du rendu et la mutation de scène.
- Les fichiers USD des utilisateurs restent inchangés par les données de session détenues par le viewer.
- La caméra, l'entrée, la sélection, le chargement de scène et le comportement du flux suivent
references/conventions.md. - Les résultats de configuration/construction/exécution et les preuves d'interaction visuelle
sont capturés avec
references/validation.md.