众趣科技房产VR展示指导文档总览
本文档是众趣 zqsdk VR 看房相关指导文档的门户页，按「引导」与「进阶」两部分组织。引导部分帮助你在自己的项目中从零完成 VR 展示及常用功能集成；进阶部分面向基于本仓库进行二次开发的开发者，说明项目规范与扩展方式。
注意：samplecode源码请联系众趣人员获取
项目演示地址
SDK 接口参考
| 文档 | 说明 |
|---|---|
| 众趣 zqsdk 使用指南（housePlay 使用说明文档） | zqsdk 全量接口参考文档，包含 housePlay 对象的所有方法、事件、属性的详细说明。各功能集成指南中涉及的 API 均可在此文档中查阅完整定义与用法。 |
部署部分（可选）
如需将模型数据部署到您的阿里云存储（oss对象存储），请参考以下文档：
| 文档 | 说明 |
|---|---|
| 数据包部署指南 | 模型数据包结构说明、阿里云存储部署方式、zqsdk resourceRequestConf 配置、常见问题排查。 |
| 数据包资源替换指南 | 一键换装、AI 讲房等功能模块的离线数据包增量资源替换说明。 |
| --- |
引导部分
以下文档面向接入众趣 zqsdk 的开发者，按推荐阅读与实现顺序排列：先完成 VR 初始化与展示，再按需接入户型图、导览、标尺、AI 讲房、一键换装等功能。
| 文档 | 说明 |
|---|---|
| VR 初始化展示指南 | 一步步完成 VR 展示：准备容器、引入依赖、获取模型 ID、调用 zqsdk.init、在 complete 中注册事件并执行 housePlay.start()，以及加载进度与错误处理。 |
| 户型图集成指南 | 实现全景模式下的迷你户型图（雷达 + 房间名/面积）与平面模式下的全屏户型图（房间名、入户门、标尺、朝向）；涉及 getFloorPlanParam、modeChange、floorChange、panoChange、compass、flyingEnd 等。 |
| 导览集成指南 | 实现按场景自动漫游：在 init_UI 中根据 heroLocations 判断并初始化场景列表，监听 stopTour / updateTour，调用 play() / pause() / gotoScenebyId(index)。 |
| 标尺显隐集成指南 | 实现全景标尺的显隐控制与左/右/高三条测量线的展示：调用 enablePanoramaSize / disablePanoramaSize，监听 updatePanoSize 并绘制线段与尺寸文案。 |
| AI 讲房集成指南 | 实现 AI 讲房：在 init_UI 中根据 vr_speak_data 判断并初始化段落列表，监听 lectureUpdate / lecturePause / lectureEnd，调用 startLecture / pauseLecture / goToLectureByName，以及可选的地图/小区图联动（connect_ui_operation）。 |
| 一键换装集成指南 | 实现装修前后对比：在 SDK 初始化完成后根据 has_decoration 判断是否支持换装，调用 changeShowMode 切换展示模式（普通/分屏/全屏），实现换装入口与模式切换按钮。 |
| 房源详情集成指南 | 实现房源详情展示：配置房源详情接口与百度地图密钥，在顶部标题栏点击展开详情面板（房源信息、地图位置、小区照片），以及与讲房模式的交互处理。 |
| VR带看集成指南 | 实现「一方操作，另一方同步跟随」的远程带看体验。两个用户各自打开同一模型的 VR 页面，通过 IM（即时通讯）通道实时同步相机视角、场景切换、标尺操作等。 |
推荐路径：先按 VR 初始化展示指南 在页面上看到 VR 场景，再根据产品需求从 户型图、导览、标尺、AI 讲房、一键换装、房源详情、VR带看集成指南 中选读并集成。
进阶部分
面向基于本仓库（estate-lookhouse-samplecode）进行二次开发的开发者，用于统一技术栈、目录职责与扩展方式。
| 文档 | 说明 |
|---|---|
| 二次开发规范指南 | 项目技术栈、目录结构、开发规范（Vue 3 + Composition API、Pinia、类型与命名等）、扩展指引（新增模式、新增楼层栏、接入业务接口等），以及本仓库与 SDK 的职责边界。 |
在完成引导部分的能力接入后，若需在本样例工程上定制或扩展，请以进阶部分为依据保持风格一致并降低维护成本。