WebGL Unity项目中如何加载StreamingAssets文件夹下的otud格式外部文件

核心前提说明 #

WebGL平台不支持System.IO相关的本地文件同步读取接口，所有放置在Assets/StreamingAssets目录下的资源，都必须通过异步HTTP请求的方式加载，不能直接用File.ReadAllBytes等本地文件接口读取。

具体实现步骤 #

• 第一步：路径拼接
  直接使用Unity内置的Application.streamingAssetsPath作为基础路径，拼接你的otud文件相对路径即可，WebGL环境下Unity会自动映射到对应的部署后资源地址，不需要手动修改路径规则。
• 第二步：异步加载文件内容
  参考如下代码实现加载逻辑：

  using UnityEngine;
  using UnityEngine.Networking;
  using System.Collections;
  using System.IO;
  
  public class OtudLoader : MonoBehaviour
  {
      IEnumerator LoadOtudFile(string relativePath)
      {
          string fullPath = Path.Combine(Application.streamingAssetsPath, relativePath);
          using (UnityWebRequest request = UnityWebRequest.Get(fullPath))
          {
              yield return request.SendWebRequest();
              
              if (request.result != UnityWebRequest.Result.Success)
              {
                  Debug.LogError($"加载otud文件失败：{request.error}");
                  yield break;
              }
              
              // 拿到otud文件二进制数据
              byte[] otudBytes = request.downloadHandler.data;
              // 直接调用OpenTibiaUnity内置的otud解析接口处理二进制数据即可
          }
      }
  
      // 调用示例：加载StreamingAssets根目录下的custom.otud
      public void StartLoadTargetFile()
      {
          StartCoroutine(LoadOtudFile("custom.otud"));
      }
  }
  

• 第三步：打包配置检查
  确认你的otud文件在Unity导入设置中没有被设置为特殊资源类型，不需要打包到AssetBundle，保持默认导入设置即可，Unity打包WebGL时会自动将StreamingAssets目录下的所有文件原样复制到部署包中。

注意事项 #

• 必须等待异步加载完成后再执行依赖otud文件的游戏逻辑，不要尝试同步等待加载结果，WebGL为单线程运行，同步等待会直接导致页面无响应。
• 部署到服务器后，要确认服务器配置了otud后缀文件的MIME类型，避免资源访问被拦截的问题。

内容的提问来源于stack exchange，提问作者Arthur Mini