⚡

Omniverse实时查看器Skill omniverse-realtime-viewer

该技能是 Omniverse Realtime Viewer USD 应用的顶级路由器，用于处理实时查看器应用请求和查看器参考文档。它指导开发者根据需求选择正确的实现路径（如浏览器流式 WebRTC、本地 ovui、Tauri/Electron 等），并遵循架构规范实现渲染、交互、场景加载等。关键词：Omniverse、USD、实时查看器、渲染、流媒体、数字孪生、场景交互。

仿真平台 0 次安装 0 次浏览 更新于 9/6/2026
名称 omniverse-realtime-viewer
描述 “用作 Omniverse Realtime Viewer USD 应用请求和重点查看器参考文档的顶级路由器。”
版本 “0.2.0”
开源协议 Apache-2.0 tools: - Read - Shell - Write compatibility: > 编排器技能。下游重点参考可能需要 NVIDIA GPU、ovrtx、ovstream、ovui、OpenUSD、Python、Node/React、Tauri、Electron、C++，或根据所选查看器路径访问云端 GPU 部署。 metadata:
作者 NVIDIA Omniverse tags: - omniverse - usd - viewer - workflow domain: ai-ml languages: - python - typescript - cpp

Omniverse 实时查看器

这是 Omniverse Realtime Viewer 技能包的顶级入口。它是独立的：所有必需的路由、约定和验证指南都位于所选参考文档中。

使用重点参考文档作为实现秘籍。本文件选择正确的秘籍，并保留所有生成的查看器应用必须遵守的架构规则。

说明

首先对请求的查看器进行分类，然后只阅读该交付路径和功能集所需的参考文档。先实现渲染路径，再在其上添加交互和 UI 行为，最后使用 references/validation.md 捕获验证证据。

阅读顺序

  1. 阅读 references/routing.md 以选择交付路径和重点参考。
  2. 在实现相机、输入、选择、视口、流媒体协议、场景加载或环境行为之前，阅读 references/conventions.md。
  3. 对于广泛的查看器请求，阅读 references/usd-viewer-app/README.md。
  4. 如果交付路径不清楚，阅读 references/streaming-vs-local/README.md。
  5. 如果提示包含布局、面板、控件、检查器、状态或用户体验要求，请阅读 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 在手柄交接前收集审查证据。

不可协商项

  • 所有 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/Agent：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 连接控件。

完成检查清单

  • 所选参考与用户意图和交付路径匹配。
  • 没有代码路径使用浏览器端 3D 渲染器渲染 USD。
  • 生成的应用程序对渲染步进和舞台变更具有单一清晰的所有者。
  • 用户 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 — 附加渲染器循环和运行时集成契约。