YooAssetBridge

重要 注意 提醒

Coding Style wiki

---

YooAssetBridge 是 AssetLoader 对 YooAsset 的桥接工具，利用反射（Reflection）机制访问 YooAsset 内部（internal）成员，让框架在不修改 YooAsset 原生包源码的情况下获取必要信息。依桥接目标分为 YooAssetSettingsData、DownloadSystemHelper 与 DefaultBuildinFileSystemDefine 三个嵌套静态类。

命名空间	OxGFrame.AssetLoader.Bundle
类型	public static class
源码	YooAssetBridge.cs

using OxGFrame.AssetLoader.Bundle;

重要 YooAssetBridge 高度依赖反射，若未来 YooAsset 包版本更新并变动了内部类、属性或字段命名，此处会同步维护对应。

YooAssetBridge.YooAssetSettingsData

桥接 YooAsset 的全局设置数据（YooAssetSettingsData）。

方法总览

方法	说明
GetPackageManifestPrefix	获取清单文件前缀名称（PackageManifestPrefix）。
GetYooDefaultCacheRoot	获取 YooAsset 默认的缓存文件根目录（Sandbox）。
GetYooDefaultBuildinRoot	获取 YooAsset 默认的内置文件根目录（StreamingAssets）。

---

GetPackageManifestPrefix

public static string GetPackageManifestPrefix()

返回值

string — 清单文件前缀名称。

说明

通过反射读取 YooAsset 设置（YooAssetSettingsData.Setting）中的 PackageManifestPrefix 字段值，即资源清单（Manifest）文件的前缀名称。

---

GetYooDefaultCacheRoot

public static string GetYooDefaultCacheRoot()

返回值

string — YooAsset 默认的缓存文件根目录路径。

说明

通过反射调用 YooAsset 内部的 GetYooDefaultCacheRoot 方法，获取默认的缓存文件根目录（Sandbox，本地持久化的下载存储目录）。

提醒 BundleConfig.GetLocalSandboxRootPath 即以此方法获取根目录。

示例

// 获取本地缓存根目录（Sandbox）
string cacheRoot = YooAssetBridge.YooAssetSettingsData.GetYooDefaultCacheRoot();

---

GetYooDefaultBuildinRoot

public static string GetYooDefaultBuildinRoot()

返回值

string — YooAsset 默认的内置文件根目录路径。

说明

通过反射调用 YooAsset 内部的 GetYooDefaultBuildinRoot 方法，获取默认的内置文件根目录（位于 StreamingAssets 下）。

提醒 BundleConfig.GetBuiltinRootPath 即以此方法获取根目录。

---

YooAssetBridge.DownloadSystemHelper

桥接 YooAsset 的下载系统辅助（DownloadSystemHelper），负责路径转换。

方法总览

方法	说明
ConvertToWWWPath	将本地路径转换为 WWW / UnityWebRequest 可用的加载路径。

---

ConvertToWWWPath

public static string ConvertToWWWPath(string path)

参数

参数	类型	说明
path	string	原始本地路径。

返回值

string — 转换后的加载路径。

说明

通过反射调用 YooAsset 内部的 DownloadSystemHelper.ConvertToWWWPath 方法，将一般本地路径转换为适用于 UnityWebRequest（WWW）加载的格式。

注意 此方法会根据运行平台自动处理文件协议前缀（如 file://）。

示例

// 转换 StreamingAssets 路径为 UnityWebRequest 可用格式
string wwwPath = YooAssetBridge.DownloadSystemHelper.ConvertToWWWPath(Application.streamingAssetsPath);

---

YooAssetBridge.DefaultBuildinFileSystemDefine

桥接 YooAsset 内置文件系统的定义（DefaultBuildinFileSystemDefine）。

方法总览

方法	说明
BuildinCatalogBinaryFileName	获取内置资源目录清单（Catalog）的二进制文件名称。

---

BuildinCatalogBinaryFileName

public static string BuildinCatalogBinaryFileName()

返回值

string — 内置资源目录清单的二进制文件名称。

说明

通过反射读取 YooAsset 内部 DefaultBuildinFileSystemDefine.BuildinCatalogBinaryFileName 字段值，即内置资源目录清单（Catalog Binary File）的文件名称。

---