静态播放器

静态播放器：把本地静态全景项目的 HTML 入口拖进来，在独立窗口中运行完整项目；桌面端还可保留最近项目记录方便再次打开。

1. 页面信息

网页地址：https://9kvr.cn/tour/workbench/static-player
所属模块：全景作品与工具
页面用途：从「工具箱」进入本页。页面标题「静态播放器」，副标题「打开本地 HTML 入口，在独立窗口中运行完整的静态全景项目。」如果当前不在桌面客户端里，页面会改为提示「下载桌面端，拖入 HTML 即可播放」并给出下载按钮；在桌面客户端中则显示拖拽区「拖入 HTML 入口文件」与「选择 HTML 文件」按钮，下方是「最近项目」列表。
适用用户：需要在本机离线运行静态全景项目的用户
访问条件：公开访问（功能需要在桌面客户端内使用）

2. 功能说明

面包屑导航：首页 / 工具箱 / 静态播放器
非桌面端提示区：标题「下载桌面端，拖入 HTML 即可播放」，说明需要读取完整的本地项目目录，提供「下载芊云全景桌面端」按钮
下载指引：安装并登录后，进入工具箱找到“静态播放器”，拖入 HTML 文件即可运行
拖拽区：标题「拖入 HTML 入口文件」，说明入口同级目录将作为站点根目录，自动加载 JS、CSS、图片、切片和媒体资源
「选择 HTML 文件」按钮，可手动选择入口文件
「最近项目」区：最多保留 10 个入口，打开时会重新检查本地文件
最近项目条目显示项目名、入口路径与上次打开时间；文件失效时标注「文件失效」并禁止打开
每个条目有「打开」按钮与删除记录的图标按钮
记录区右上角有「清空记录」按钮
没有记录时展示空状态「还没有最近项目」

3. 业务说明

界面结构

控件 / 入口	类型	取值来源	限制 / 说明
下载芊云全景桌面端	按钮	客户端下载页	非桌面端时显示；用于获取可运行静态项目的能力
拖入 HTML 入口文件	拖拽区	本地 HTML 文件	只接受 HTML 或 HTM 文件
选择 HTML 文件	按钮	本地文件选择	打开过程中按钮禁用并显示加载态
最近项目列表	列表	本机记录	最多保留 10 个入口，打开时会重新检查本地文件
项目名 / 入口路径 / 上次打开时间	只读文字	本机记录	时间按本地时间格式展示
文件失效	状态标识	文件检查结果	失效项目不可打开
打开	操作	入口路径	失效项目或正在打开时不可点击
清空记录	按钮	固定行为	清空本机全部最近项目记录
删除记录	图标按钮	入口路径	只删除这一条记录
还没有最近项目	空状态	记录为空时	提示拖入或选择一个 HTML 文件后它会出现在这里

运行方式

播放器把拖入的 HTML 入口所在的同级目录当作站点根目录，自动加载其中的 JS、CSS、图片、切片与媒体资源，然后在独立窗口中运行整个静态全景项目，不需要手工拼装文件结构。

最近项目

最近项目记录保存在本机，最多保留 10 条；每次打开都会重新检查本地文件是否仍然存在，失效的条目会被标记为「文件失效」并禁止打开。

4. 使用说明

在桌面客户端里登录后，从「工具箱」进入「静态播放器」
把静态全景项目的 HTML 入口文件拖进拖拽区，或点「选择 HTML 文件」手动选择
等待播放器在独立窗口中打开并运行项目
需要再次打开时，在「最近项目」里找到对应条目点「打开」
本机文件已被删除的条目会显示「文件失效」，此时需要重新拖入
不再需要的记录点删除图标，或点右上角「清空记录」一次性清空

5. 规则与限制

该功能依赖桌面客户端，浏览器中打开会提示先下载桌面端
只接受 HTML 或 HTM 入口文件，其它类型会提示「请拖入 HTML 或 HTM 文件」
入口文件的同级目录会被当作站点根目录，需要保持项目目录结构完整
最近项目最多保留 10 个，超出后按最新记录替换
打开前会重新检查本地文件，失效的条目不可打开
记录保存在本机，清空后无法恢复

6. 状态与异常

非桌面端：展示下载桌面端的引导区
待操作：展示拖拽区与最近项目区
打开中：按钮进入加载禁用态
记录为空：展示「还没有最近项目」空状态
文件失效：条目带「文件失效」标识且不可打开
非 HTML 文件：提示「请拖入 HTML 或 HTM 文件」
选择文件失败：提示「选择文件失败」
播放器打开失败：提示「播放器打开失败」
读取最近项目失败：提示「读取静态播放器最近项目失败」与「最近项目读取失败」

7. 相关文档

目录导航

所属目录索引：/tour/workbench
上一篇：短链工作台
下一篇：富文本转图片

同目录文档（14）

相关主题

8. 文档信息

事实来源：芊云全景官网页面核验
文档构建时间：2026-10-21 00:05:20
数据获取/快照时间：不适用（静态产品知识）
可信状态：已核验