# 360转大楼 Widget PRD

版本：v0.2  
优先级：P2  
状态：待独立页面原型与实现验证

## 修订记录

| 日期 | 版本 | 变更类型 | 变更摘要 |
| --- | --- | --- |
| 2026-08-03 | v0.1 | 初始创建 | 定义以独立沉浸视图查看建筑外观的任务。 |
| 2026-08-03 | v0.2 | 默认视角与退出结果补充 | 根据 DeepSeek PM 评审明确默认角度的顾客可读定义，并将退出验收改为顾客可感知结果。 |

## 1. 基本信息

| 属性 | 定义 |
| --- | --- |
| Widget 名称 | 360转大楼 |
| 唯一标识 | `building-360-rotation` |
| 分类 | 建筑与空间 |
| 一句话介绍 | 让顾客通过可连续旋转的建筑外观素材，环视项目整体形象。 |
| 封面图 | 建筑外观 360 代表帧。 |
| 设计图 | 全屏旋转画布与操作提示设计示意。 |

## 2. 目标与场景

面向需要直观观察建筑整体外观的顾客。顾客拖动或自动播放建筑环视、暂停/复位并退出，完成外观角度浏览；这是独立页面主承载，不要求与普通内容区块组合。

## 3. 内容与数据

必需为一组连续外观帧或可用的 360 环视内容、项目名称；封面、角度标签、说明可选。内容须完整可加载；缺帧或不可访问时不启动交互。

## 4. 使用与配置

选择一个环视内容，可配置默认角度、自动播放、速度和操作提示。默认角度以内容提供的帧序号或顾客可读方位标签（如正面/东北侧）指定；配置不对应有效帧时回到内容首帧。自动播放关闭时不自动开始。内容无效时显示不可用与返回。

## 5. C端 UI 与交互

默认显示全屏建筑画布、角度提示、播放/暂停、复位与退出。顾客可拖动/滑动旋转、播放/暂停和复位。加载中显示进度可退出；失败显示封面（如有效）与错误提示，不伪造旋转。移动端支持单指拖动。

## 6. 用户用例与验收

**UC-01**：顾客旋转建筑并在任意角度暂停。  
**UC-02**：顾客复位或退出独立体验。

| 验收编号 | 验收条件 |
| --- | --- |
| AC-01 | 连续内容有效时可连续旋转、播放/暂停、复位。 |
| AC-02 | 加载失败或中断时有清晰提示和退出。 |
| AC-03 | 顾客退出后回到启动该体验的上一级 C端内容，并能继续浏览。 |