RealWall Album

将空白墙面变成沉浸式画廊，无需卷尺或模型图。RealWall Album 将 RealityKit 的精准 AR 放置与 SwiftUI 控件结合，让室内爱好者、摄影师和陈列人员能够以真实尺寸预览画框，将每个布局保存为可重复使用的相册，并在几秒内为客户捕捉展示媒体。

### 你可以做什么

- **在 AR 中固定真实艺术**：从照片图库导入照片，放置应用内生成的手工海报占位图（City、Nature、Beach、Mountain、Abstract 主题），或放置你在 Custom Box Manager 中设计的品牌 2D/3D 盒子。

- **保存并再次访问房间**：每次会话都会保存附件、变换以及可选的 ARWorldMap 数据，因此回到同一房间时布局可立即重新加载。

- **在应用内捕捉证明**：一键触发 ReplayKit 屏幕录制或抓取快照。Screenshots 和 Recordings 画廊通过上下文菜单整理修订并支持删除。

- **控制物理尺寸**：Photo Size Input 会在放置用户照片前询问宽度/高度，确保墙面渲染达到厘米级准确度。

- **构建自定义素材**：创建矩形、圆形或椭圆预设，可带可选深度（0.01-10m）和丰富图像。切换 3D、设置尺寸、附加参考艺术并保存无限变体。

- **保持有序**：Home hero card 显示相册数量、截图以及媒体、相册和 custom box manager 的快捷操作。彩色 glassmorphism sheet 让导航保持直观。

- **使用任意语言**：LocalizationController 支持从 home 齿轮图标在 English 和 Indonesian 之间即时切换，同时 fallback 字符串按代码库保持 English。

- **即使在模拟器上也可测试**：`SimulatorARPlaceholderView` 模拟 AR 体验，因此无需 LiDAR 设备也能规划 UI 状态。

### 为什么轻松

- Overlay controls（CreateControlsView 和 AlbumControlsView）浮在 RealityKit 之上，让放置来源、保存按钮和退出操作都能单手触达。

- 相册、截图、录屏和 custom box 通过 `AlbumStorage`、`MediaStorage` 和 `CustomBoxStorage` 持久保存，因此会话之间不会丢失内容。

- 保护性对话框确认取消操作，进度和徽章（GlassStatusBadge、StatBadge）则让状态一目了然。

- 可离线工作：Swift 文件中没有登录、服务器或后台分析。

## 使用方法（简短版）

1. 启动 RealWall Album，在 hero card 上点击 **Create Gallery**。

2. 移动设备扫描墙面；按照扫描提示 overlay 操作。

3. 选择内容来源（Photos picker、Poster placeholder、Custom Box）。如需要，输入物理尺寸。

4. 点击墙面放置，捏合缩放，拖动微调间距。可随时切换海报主题或自定义素材。

5. 点击 **Save Album** 保存附件 + ARWorldMap。确认名称并继续编辑。

6. 在 Album 模式中使用 **Screenshot** 或 **Record** 捕捉证明。之后可从 home 的 Quick Actions 查看。

7. 从 Album 列表重新打开已保存的画廊，应用会自动重新加载放置和变换。

Terms of Use (EULA):

https://www.apple.com/legal/internet-services/itunes/dev/stdeula/

Privacy Policy:

https://nuku.biz.id/privacy.html