素材播放

单个全景素材的播放页：左侧展示素材信息卡，中间播放素材的全景效果，可通过链接中的素材标识直接打开。

1. 页面信息

网页地址：https://9kvr.cn/tour/media
所属模块：全景作品与工具 · 素材媒体
页面用途：这是素材播放的正式入口之一，常从素材列表、素材库进入。打开后会先显示全屏加载动画，随后在中间区域播放该素材，桌面端左侧展示可收起展开的素材信息卡，移动端改为点按按钮弹出信息面板。
适用用户：需要单独预览某个全景素材的用户
访问条件：公开访问（可能受素材自身的访问条件限制）

2. 功能说明

中间区域播放素材内容，桌面端左侧同步展示素材信息卡
桌面端信息卡可收起或展开，移动端以弹窗形式查看
没有素材标识时展示空状态，并提供「返回素材列表」入口
素材信息首次读取失败会自动延迟重试一次
播放异常会延迟确认后再提示，避免网络抖动误报
分享标题按素材名动态设置

3. 业务说明

界面结构

区域	内容
加载层	黑色背景的加载动画，等待素材信息与全景资源就绪
素材信息卡	桌面端固定在左侧，可收起 / 展开；移动端在弹窗中展示
收起按钮	位于信息卡右侧，点击后收起或展开信息卡
移动端信息按钮	移动端左下角的列表图标，点击弹出素材信息面板
播放区域	素材的全景播放器，占据中间主区域
错误提示	播放区域内的「加载失败，请稍后重试」提示
空状态	缺少素材标识或加载失败时展示，并可返回素材列表

进入方式

素材播放有两条正式入口：素材库列表中的单条素材、以及直接带素材标识的链接。两条入口指向同一套播放能力，页面本身不区分来源。

容错策略

素材信息首次读取失败会延迟重试一次，兼容全景文件刚生成、尚未就绪的短暂窗口；播放异常先等待一段时间再确认，避免 CDN 抖动被误判为失败。

4. 使用说明

从素材列表或带素材标识的链接打开本页
等待素材信息与全景资源加载完成
桌面端在左侧查看素材信息，可点击箭头收起或展开
移动端点按列表图标弹出素材信息面板
在中间区域沉浸式浏览素材内容

5. 规则与限制

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

6. 状态与异常

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

7. 相关文档

目录导航

下级页面（7）

同目录文档（6）

相关主题

8. 文档信息

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