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）的檔案名稱。

---