chaldea 中文文档 下载 App

图片加载失败——缓存、服务器源、Force Online 模式

为什么图片可能加载失败

Chaldea 的图片不是打包在安装包里的——大部分图片(从者头像、礼装立绘、技能图标、buff 图标)是按需从服务器下载的。

所以启动时只需要下载程序本身(Flutter 引擎),图片等看到具体页面时才下载。这种设计能让安装包变小,但需要网络好。

常见原因与排查

原因一:网络断开

Chaldea 启动时会检查网络。如果发现离线,部分功能会禁用,图片自然也加载不出来。

排查:

  1. 检查手机 / 电脑是否真的有网络连接
  2. 打开浏览器访问百度试试
  3. 如果是"显示离线但实际上有网"——在设置里切换Force Online Mode(强制在线模式,绕过离线检测)

原因二:下载源选了海外源(国内用户)

国内用户如果选了海外下载源:

解决:设置 → 应用数据 → 游戏数据管理 → 下载源 → 切换为国内源(cn.chaldea.center)。

原因三:缓存损坏

图片下载后会缓存在本地 assets/ 目录。但缓存文件可能损坏:

解决:设置 → 应用数据 → 游戏数据管理 → 清理缓存图标。清理后重新进入页面会自动重新下载。

原因四:服务器临时不可用

Chaldea 自己的服务器偶尔会维护或遇到问题。此时:

其中一个不可用时,另一个可能还能用。快速排查:在浏览器里分别访问这两个域名,看哪个能打开。两个都打不开就是服务器整体问题,等一会儿再试。

如果一直加载不出来

步骤一:清理缓存图标

设置 → 应用数据 → 游戏数据管理 → 清理缓存图标(全选清理)。

步骤二:切换下载源

国内 ↔ 海外,两个都试。

步骤三:Force Online Mode

设置里打开 Force Online Mode,绕过离线检测直接尝试下载。

步骤四:重启 App

有时候重启能解决网络状态识别问题。

步骤五:换网络试试

手机流量 / 不同 Wi-Fi / 移动热点,换一个网络试试。

图片类型说明

图片类型是否必需下载时机
从者头像是从者列表页加载时
从者立绘是详情页 → 立绘标签
礼装立绘是礼装列表页
技能 / buff 图标是技能描述、战斗模拟
语音否播放语音时

头像和立绘是必需的——没有它们从者列表就是一片灰。语音可以不下载。