素材播放

全景素材播放页：左侧展示可收起的素材信息卡，中间播放素材的全景内容，移动端改为弹窗查看信息。

1. 页面信息

• 网页地址：https://9kvr.cn/tour/media/play
• 所属模块：素材与模型
• 页面用途：从素材库列表进入预览单个全景素材。页面按链接中的素材标识加载素材信息，桌面端左侧展示可收起展开的信息卡，中间播放素材；移动端则点按按钮弹出信息面板。适合逐条核对素材的画质与信息。
• 适用用户：查看单个全景素材的用户
• 访问条件：公开访问（可能受素材自身的访问条件限制）

2. 功能说明

• 桌面端左侧素材信息卡，可收起或展开
• 移动端以侧边弹窗形式展示素材信息，可关闭
• 中间区域沉浸式播放素材内容
• 分享标题按素材名动态设置，缩略图取素材封面
• 素材信息首次读取失败会自动延迟重试一次
• 播放异常会延迟确认后再提示，避免网络抖动误报

3. 业务说明

界面结构

素材标识的来源

素材标识从进入链接的参数中读取，可以由素材列表点选生成，也可以由外部直接拼接。缺少标识时页面不会发起加载，而是直接展示空状态与返回入口。

为什么有一次延迟重试

全景文件刚生成时，服务端短时间内可能还拿不到可直接播放的文件地址。首次读取失败会自动延迟重试一次，避免用户看到"加载失败"后还得手动刷新。

4. 使用说明

1. 从素材列表点击某条素材进入本页
2. 等待素材信息与全景资源加载完成
3. 桌面端在左侧查看素材信息，点击箭头可收起或展开
4. 移动端点按列表图标弹出素材信息面板查看详情
5. 在中间区域沉浸式浏览素材内容

5. 规则与限制

• 链接必须携带有效的素材标识，否则提示从素材列表进入
• 首次读取素材信息失败会自动延迟重试一次
• 播放异常的提示会延迟确认后才展示
• 分享标题取自素材名称，缩略图取素材自身封面

6. 状态与异常

• 加载中：黑色背景加载动画
• 播放中：中间区域可交互浏览，信息卡可收起 / 展开
• 空状态：缺少素材标识时展示「缺少素材ID，请从素材列表进入预览」
• 加载失败：素材不存在或读取失败时展示提示与返回入口
• 素材不存在或加载失败时给出提示，并提供返回素材列表的入口
• 首次读取失败会自动延迟重试一次后再次判定

7. 相关文档

目录导航

• 所属目录索引：素材播放
• 上一篇：3D 物体环视编辑器

同目录文档（6）

• 我的素材收藏
• 我的全景素材
• 我的地图素材
• 移动端发布全景素材
• 移动端模型素材（规划中）
• 3D 物体环视编辑器

相关主题

• 我的全景素材
• 我的素材收藏

8. 文档信息

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