加載方式

重要 注意 提醒

Coding Style wiki

---

通過 Resources 加載

提醒 使用 Resources 加載時，不需要進行額外配置，僅將資源放在 Resources 下，並且直接使用 res# 作為前墜 + 資源路徑進行加載。

重要 使用 res# 作為前墜時，將會切換成 Resources 加載方式。

// res# prefix
AssetLoaders.LoadAssetAsync<GameObject>("res#MyPrefabs/Cube");

---

通過 AssetBundle 加載

步驟 1.

必須先通過 YooAsset Collector 配置。

注意 尋址名稱需要注意，圖中的 DefaultPackage 包含尋址名稱的有 Cube。

步驟 2.

另外使用 AssestBundle 進行開發時，也需要 PatchLauncher 進行 Runtime 配置，主要是使用 AssetBundle 加載時，需要初始相關配置。

注意 匯入後拖曳到 Hierarchy 窗體。

步驟 3.

配置預設 Packages，將會在 Runtime 時進行初始。

• 預設 App Packages。
• 預設 DLC Packages。

重要 預設 Packages 將由主下載器進行管理與檢查，所以不包含在預設中的 Packages，必須自行通過 API 初始，說明如下。

App Package

// [Load asset and download from specific package (Export App Bundles for CDN)]

AppPackageInfoWithBuild packageInfo = new AppPackageInfoWithBuild()
{
    buildMode = BundleConfig.BuildMode.ScriptableBuildPipeline,
    packageName = "OtherPackage"
};

bool isInitialized = await AssetPatcher.InitAppPackage(packageInfo, true);
if (isInitialized)
    await AssetLoaders.LoadAssetAsync<GameObject>("packageName", "assetName");

DLC Package

// [Load asset and download from specific package (Export Individual DLC Bundles for CDN)]

DlcPackageInfoWithBuild packageInfo = new DlcPackageInfoWithBuild()
{
    buildMode = BundleConfig.BuildMode.ScriptableBuildPipeline,
    packageName = "DlcPackage",
    dlcVersion = "dlcVersion",
    withoutPlatform = false
};

bool isInitialized = await AssetPatcher.InitDlcPackage(packageInfo, true);
if (isInitialized)
    await AssetLoaders.LoadAssetAsync<GameObject>("packageName", "assetName");

注意 區分 App Packages 跟 DLC Packages，注意路徑不同。

• App Packages
  • 路徑隨著主程式版號 (.../CDN/<ProductName>/<Platform>/<AppVersion>/<PackageName>)。
  • 手動進行 AssetPatcher.InitAppPackage 的初始 (如果 autoUpdate = false，則需要自行另外調用 AssetPatcher.UpdatePackage 進行 Manifest 的更新)。
• DLC Packages
  • 路徑包含平台 (.../CDN/<ProductName>/<Platform>/DLC/<PackageName>/<DlcVersion>)。
  • 路徑不含平台 (.../CDN/<ProductName>/DLC/<PackageName>/<DlcVersion>)，屬於所有平台的共用資源。
  • 支持特定版本 DLC package 的下載與 DLC package 卸載功能，需手動進行 AssetPatcher.InitDlcPackage，並且指定特定 dlcVersion，對於 dlcVersion 也可以單一固定 dlcVersion (ex: "latest")，變成只要 DLC 有更新就可以使用固定路徑進行更新。

注意 另外，Play Mode 的說明如下。

• Editor Simulate Mode (模擬模式)，加快開發。
• Offline Mode (單機模式)，需將 AB 打包至 Built-in，並且產出相關配置，需注意 PatchLauncher 的解密設定。
• Host Mode (聯機模式)，需將 AB 打包區分 Built-in 跟 Patch，並且產出相關配置，需注意 PatchLauncher 的解密設定。
  • 允許選擇 Semantic Version 版號檢查規則 (比對完整版號 X.Y.Z 或比對大小版號 X.Y)。
  • 允許跳過 Preset App Packages 主下載階段 (強制邊玩邊下載)。
• WebGL Mode (僅支持 WebGL 平台)，需將 AB 全部打包至 Built-in (StreamingAssets)。
  • 不支持事先下載，主要是因為 WebGL 是邊玩邊下載。

步驟 4.

前置作業完成後，並且確保主配置流程已初始 -> AssetPatcher.IsInitialized()，就可以開始加載了，如以下。

從 DefaultPackage 中加載尋址名稱為 Cube 的物件。

AssetLoaders.LoadAssetAsync<GameObject>("DefaultPackage", "Cube");

注意 額外補充，流程先後順序，說明如下。

• 輪詢初始狀態 AssetPatcher.IsInitialized() == true -> 即可加載內置資源與執行檢查更新。
• 執行檢查更新 AssetPatcher.Check() -> 輪詢完成狀態 AssetPatcher.IsDone() == true -> 完成更新後 -> 即可加載更新資源。