跳到主要内容

常见问题解答

本文整理了用户在使用 BZ全景漫游可视化编辑器 时最常遇到的问题。

全景图相关​

什么样的全景图适合做漫游?​

  • 格式: JPG / PNG
  • 比例: 严格 2:1 (等距圆柱投影 / equirectangular)
  • 分辨率: 推荐 4096×2048 ~ 8192×4096
  • 来源: 全景相机直出 (Insta360, RICOH Theta, Matterport 等) 或 PTGui / Hugin 拼接

全景图不是 2:1 比例可以用吗?​

不可以。非 2:1 的图导入后会变形, 球面贴图会撕裂。请先用 PS / Affinity Photo 把图裁剪到严格 2:1 后再导入。

拼接缝 / 三脚架很明显怎么办?​

两种方法:

  1. 在 PS 里手动修复 (推荐): 用仿制图章工具修补, 再导入软件
  2. 用遮罩盖住: 详见 遮罩设置, 上传一张 PNG 圆形遮罩遮住地面三脚架

一个作品最多放多少场景?​

技术上不限, 实际推荐 5 ~ 20 个。场景过多会:

  • 切片导出时间过长
  • 导出 H5 包体过大 (单张 4K 全景切片约 30~80 MB)
  • 移动端首屏加载慢

热点相关​

添加切换热点后, 点击没反应?​

检查:

  1. 是否选了"目标场景"? 热点列表会显示"未选择目标场景"
  2. 是否点了"完成"保存?
  3. 是否点了顶部的"保存作品"?

自定义热点图标边缘有方块?​

图片不是 PNG 透明背景, 或者 alpha 通道有损坏。重新用 PS 导出"PNG-24 (含透明度)"。

环物 (VIEWER) 热点提示"文件名错误"?​

环物对文件名很严格:

  • 必须从 1 开始连续编号: 1.png, 2.png, ...
  • 不能以 0 开头 (01.png 会被拒)
  • 必须同一后缀名
  • 必须连续不缺号 (缺一号都会报错)

可以批量用 Bulk Rename Utility / Total Commander 重命名。

弹窗里的图片很慢才加载?​

相册 / 图文热点的图片体积影响加载速度, 单张建议 < 500 KB。在原始图上用 PS 的"导出为 Web 所用格式"压缩一遍。

音频相关​

为什么打开作品没有声音?​

浏览器对"自动播放音频"有严格限制, 通常需要用户首次点击 / 触摸后才会响。这是 Web 标准, 不是 BUG。可以加一个"开始浏览"按钮引导用户首次点击。

支持非 MP3 格式吗?​

软件文件选择对话框只允许 .mp3。

想给整个作品配一个 BGM, 不想每个场景设一次?​

在任意一个场景配好背景音乐后, 点击 应用到所有场景 按钮即可一键同步。

软件运行相关​

软件第一次启动很慢?​

首次启动需要初始化数据库和工作目录, 等待 10~30 秒属于正常。

切片全景图很慢?​

切片 (生成多分辨率瓦片) 是 CPU 密集任务, 一张 8K 图大约需要 10~30 秒, 多核 CPU 更快。如果进度卡在某个百分比不动:

  • 检查源图是否真的是 2:1
  • 检查目标磁盘可用空间
  • 重启软件后再试一次

软件无法启动 / 启动后白屏?​

  • 把软件添加到杀毒软件白名单 (有的杀毒软件会拦截)
  • 右键 → 以管理员身份运行
  • 确认是 Windows 7 SP1 / Windows 10 / Windows 11 64 位系统

注册激活后还显示水印?​

  • 确认注册码输入正确 (复制时不要带空格, 不要带 license:// 前缀)
  • 19 位短激活码必须以 kve 开头
  • 重启软件刷新; 标题栏出现"专业版"字样才算激活成功

导出与发布​

导出的 H5 直接双击 index.html 打不开?​

部分浏览器 (Chrome 高版本) 因 CORS 同源策略 不允许从 file:// 协议加载本地 XML, 但部署到 Web 服务器后可以正常打开。本地测试可以:

# 在导出目录运行
npx http-server -p 8080
# 然后访问 http://localhost:8080

或安装 VS Code 的 Live Server 扩展 一键预览。

导出包太大, 上传服务器很慢?​

主要是全景瓦片占空间。可以:

  1. 降低全景图原始分辨率 (4K → 2K), 切片大小减半
  2. 上传后开启服务器的 Gzip / Brotli 压缩
  3. 使用 CDN 加速

想去掉水印?​

购买专业版激活即可, 见 购买与激活指南。

支持手机, 平板, VR 头显观看吗?​

支持:

  • PC: 鼠标拖拽 + 滚轮缩放
  • 手机/平板: 手指拖拽 + 双指缩放, 自动调用陀螺仪 (可选)
  • VR 头显: 双屏立体显示 (Cardboard 兼容)

发到微信能直接打开吗?​

可以。把导出目录上传到 HTTPS 站点 (微信要求 HTTPS), 转发分享链接即可。建议加 JS-SDK 的分享卡片 美化朋友圈/会话卡片样式 (需要服务端配合)。

其他​

软件支持中英双语吗?​

当前版本 UI 仅中文。如果需要英文发布作品, 可以手动在 PS 上把英文标注加在全景图上, 或者用文本热点写英文说明。

作品文件存在哪里? 怎么备份?​

所有作品和素材都存在用户的工作目录 (默认在 C:\Users\<用户名>\Documents\<软件目录> 之类的位置)。直接整目录复制即可备份, 换电脑后还原同一路径即可恢复。

软件有 Mac / Linux 版吗?​

当前只发布 Windows 版