omniverse-realtime-viewer

Omniverse 实时查看器

这是 Omniverse 实时查看器技能包的顶层入口。 它是自包含的：所有必需的路由规则、约定和验证指南 都包含在所选参考文档中。

将精简的参考文档用作实现方案。本文件会选择 合适的方案，并保留所有生成的查看器应用都必须遵守的架构规则。

说明

首先对所请求的查看器进行分类，然后只阅读该交付路径和功能集所需的参考文档。先实现渲染路径，再在其上 叠加交互和 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/viewer-input-routing/README.md，再阅读 references/camera-controls/README.md、references/native-picking-selection/README.md 或 references/object-selection/README.md。
7. 只阅读所请求应用所需的精简功能参考文档。
8. 在交接前，使用 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 文件不被修改。查看器相机、渲染产品、渲染变量、 设置、选择元数据和运行时状态都应放在会话/组合图层或应用状态中。
• 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. 在宣布查看器已就绪前，收集验证证据。

示例

• 对于浏览器查看器请求，使用流式传输配方参考资料，并添加摄像机、拾取、层级、属性、渲染设置和流状态参考资料。
• 对于本地工作站查看器请求，使用本地或原生交付参考资料，并添加渲染器设置、场景加载、视口输入和验证参考资料。

完成检查清单

• 选定的参考资料符合用户意图和交付路径。
• 没有代码路径使用浏览器端 3D 渲染器处理 USD。
• 生成的应用只有一个明确的渲染步进和场景修改所有者。
• 用户的 USD 文件不会被查看器拥有的会话数据修改。
• 摄像机、输入、选择、场景加载和流行为遵循 references/conventions.md。
• 使用 references/validation.md 收集设置/构建/运行结果和视觉交互证据。