---
title: "Multi-Window Architecture"
type: concept
tags: []
sources: [visionos-spatial-engineer]
last_updated: 2026-04-25
---

## Definition
visionOS 应用的多窗口管理模式，基于 WindowGroup 场景类型，支持 single-instance 窗口、volumetric 展示和空间场景管理。

## Window Types
- **Unique Windows（单实例窗口）**：应用主窗口，每次只存在一个实例
- **Volumetric Presentations（空间展示）**：在 3D volume 内呈现的辅助内容窗口
- **Spatial Scenes（空间场景）**：完整的 3D 空间应用场景定义

## Core Patterns
- **WindowGroup Management**：通过 WindowGroup 管理同类型窗口的生命周期
- **Glass Background Effects**：每个窗口默认带有 Liquid Glass 风格的毛玻璃背景
- **Spatial Presentation Hierarchy**：窗口之间的空间层级关系管理
- **Presentation State**：SwiftUI 状态驱动的窗口展示模式切换

## Related Concepts
- [[Spatial Widgets]]：与主窗口协同工作的空间小组件
- [[Liquid Glass Design System]]：多窗口场景下的统一视觉语言
- [[Multi-Window Architecture]] — 见本文

## Sources
- [[visionos-spatial-engineer]] — visionOS Spatial Engineer Agent 角色定义