# 众趣科技房产VR展示指导文档总览

本文档是**众趣 zqsdk VR 看房**相关指导文档的门户页，按「引导」与「进阶」两部分组织。引导部分帮助你在自己的项目中从零完成 VR 展示及常用功能集成；进阶部分面向基于本仓库进行二次开发的开发者，说明项目规范与扩展方式。

---

## 部署部分（可选）

如需将模型数据部署到您的阿里云存储（oss对象存储），请参考以下文档：

| 文档 | 说明 |
|------|------|
| [数据包部署指南](../数据包部署指南/数据包部署指南.md) | 模型数据包结构说明、阿里云存储部署方式、zqsdk `resourceRequestConf` 配置、常见问题排查。 |
| [数据包资源替换指南](../数据包部署指南/数据包资源替换指南.md) | 一键换装、AI 讲房等功能模块的离线数据包增量资源替换说明。 |
---

## 引导部分

以下文档面向**接入众趣 zqsdk 的开发者**，按推荐阅读与实现顺序排列：先完成 VR 初始化与展示，再按需接入户型图、导览、标尺、AI 讲房、一键换装等功能。

| 文档 | 说明 |
|------|------|
| [VR 初始化展示指南](./VR初始化展示指南.md) | 一步步完成 VR 展示：准备容器、引入依赖、获取模型 ID、调用 `zqsdk.init`、在 `complete` 中注册事件并执行 `housePlay.start()`，以及加载进度与错误处理。 |
| [户型图集成指南](./户型图集成指南.md) | 实现全景模式下的迷你户型图（雷达 + 房间名/面积）与平面模式下的全屏户型图（房间名、入户门、标尺、朝向）；涉及 `getFloorPlanParam`、`modeChange`、`floorChange`、`panoChange`、`compass`、`flyingEnd` 等。 |
| [导览集成指南](./导览集成指南.md) | 实现按场景自动漫游：在 `init_UI` 中根据 `heroLocations` 判断并初始化场景列表，监听 `stopTour` / `updateTour`，调用 `play()` / `pause()` / `gotoScenebyId(index)`。 |
| [标尺显隐集成指南](./标尺显隐集成指南.md) | 实现全景标尺的显隐控制与左/右/高三条测量线的展示：调用 `enablePanoramaSize` / `disablePanoramaSize`，监听 `updatePanoSize` 并绘制线段与尺寸文案。 |
| [AI 讲房集成指南](./AI讲房集成指南.md) | 实现 AI 讲房：在 `init_UI` 中根据 `vr_speak_data` 判断并初始化段落列表，监听 `lectureUpdate` / `lecturePause` / `lectureEnd`，调用 `startLecture` / `pauseLecture` / `goToLectureByName`，以及可选的地图/小区图联动（`connect_ui_operation`）。 |
| [一键换装集成指南](./一键换装集成指南.md) | 实现装修前后对比：在 SDK 初始化完成后根据 `has_decoration` 判断是否支持换装，调用 `changeShowMode` 切换展示模式（普通/分屏/全屏），实现换装入口与模式切换按钮。 |
| [房源详情集成指南](./房源详情集成指南.md) | 实现房源详情展示：配置房源详情接口与百度地图密钥，在顶部标题栏点击展开详情面板（房源信息、地图位置、小区照片），以及与讲房模式的交互处理。 |
| [VR带看集成指南](./带看集成指南.md) | 实现「一方操作，另一方同步跟随」的远程带看体验。两个用户各自打开同一模型的 VR 页面，通过 IM（即时通讯）通道实时同步相机视角、场景切换、标尺操作等。 |

**推荐路径**：先按 [VR 初始化展示指南](./VR初始化展示指南.md) 在页面上看到 VR 场景，再根据产品需求从 [户型图](./户型图集成指南.md)、[导览](./导览集成指南.md)、[标尺](./标尺显隐集成指南.md)、[AI 讲房](./AI讲房集成指南.md)、[一键换装](./一键换装集成指南.md)、[房源详情](./房源详情集成指南.md)、[VR带看集成指南](./带看集成指南.md) 中选读并集成。

---

## 进阶部分

面向**基于本仓库（estate-lookhouse-samplecode）进行二次开发**的开发者，用于统一技术栈、目录职责与扩展方式。

| 文档 | 说明 |
|------|------|
| [二次开发规范指南](./二次开发规范指南.md) | 项目技术栈、目录结构、开发规范（Vue 3 + Composition API、Pinia、类型与命名等）、扩展指引（新增模式、新增楼层栏、接入业务接口等），以及本仓库与 SDK 的职责边界。 |

在完成引导部分的能力接入后，若需在本样例工程上定制或扩展，请以进阶部分为依据保持风格一致并降低维护成本。
