feat : oppo file system support

Assets/YooAsset/Samples~/Mini Game/Runtime/OppoFileSystem.meta

@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: d3406054572d78a42afc498103c31643
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Assets/YooAsset/Samples~/Mini Game/Runtime/OppoFileSystem/OppoFileSystem.cs

@@ -0,0 +1,34 @@
+#if UNITY_WEBGL && OPPOMINIGAME
+using YooAsset;
+
+public static class OppoFileSystemCreater
+{
+    public static FileSystemParameters CreateFileSystemParameters(string packageRoot, IRemoteService remoteService)
+    {
+        string fileSystemClass = $"{nameof(OppoFileSystem)},YooAsset.MiniGame";
+        var fileSystemParams = new FileSystemParameters(fileSystemClass, packageRoot);
+        fileSystemParams.AddParameter(EFileSystemParameter.RemoteService, remoteService);
+        return fileSystemParams;
+    }
+    public static FileSystemParameters CreateFileSystemParameters(string packageRoot, IRemoteService remoteService, IBundleDecryptor decryptor)
+    {
+        string fileSystemClass = $"{nameof(OppoFileSystem)},YooAsset.MiniGame";
+        var fileSystemParams = new FileSystemParameters(fileSystemClass, packageRoot);
+        fileSystemParams.AddParameter(EFileSystemParameter.RemoteService, remoteService);
+        fileSystemParams.AddParameter(EFileSystemParameter.AssetbundleDecryptor, decryptor);
+        return fileSystemParams;
+    }
+}
+
+/// <summary>
+/// OPPO 小游戏文件系统
+/// </summary>
+internal class OppoFileSystem : WebGameFileSystem
+{
+    /// <inheritdoc/>
+    protected override IWebGamePlatform CreatePlatform(string packageRoot)
+    {
+        return new OppoPlatform();
+    }
+}
+#endif

Assets/YooAsset/Samples~/Mini Game/Runtime/OppoFileSystem/OppoFileSystem.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: e25c7db2877c44ed9f9105dbd0057c47
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Assets/YooAsset/Samples~/Mini Game/Runtime/OppoFileSystem/OppoPlatform.cs

@@ -0,0 +1,30 @@
+#if UNITY_WEBGL && OPPOMINIGAME
+using UnityEngine;
+using UnityEngine.Networking;
+using YooAsset;
+
+/// <summary>
+/// OPPO 小游戏平台实现
+/// </summary>
+internal class OppoPlatform : IWebGamePlatform
+{
+    /// <inheritdoc/>
+    public UnityWebRequest CreateAssetBundleRequest(string url)
+    {
+        return UnityEngine.Networking.UnityWebRequestAssetBundle.GetAssetBundle(url);
+    }
+
+    /// <inheritdoc/>
+    public AssetBundle ExtractAssetBundle(UnityWebRequest request)
+    {
+        var downloadHandler = (DownloadHandlerAssetBundle)request.downloadHandler;
+        return downloadHandler.assetBundle;
+    }
+
+    /// <inheritdoc/>
+    public void UnloadAssetBundle(AssetBundle assetBundle, bool unloadAll)
+    {
+        assetBundle.Unload(unloadAll);
+    }
+}
+#endif

Assets/YooAsset/Samples~/Mini Game/Runtime/OppoFileSystem/OppoPlatform.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: c88ea27c91d34f5a9bb45bd9f6b025a3
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

Assets/YooAsset/Samples~/Mini Game/Runtime/OppoFileSystem/README.md

@@ -0,0 +1,74 @@
+# OPPO 小游戏文件系统
+
+该示例用于在 YooAsset 的 WebGL 运行模式下接入 OPPO 小游戏。
+
+参考文档：[OPPO 小游戏资源缓存](https://github.com/oppominigame/unity-webgl-to-oppo-minigame/blob/main/doc/AssetCache.md)
+
+## 环境要求
+
+先安装 OPPO Unity WebGL 小游戏 SDK，并将项目切换到 WebGL 构建目标。
+
+在 WebGL Player 的 Scripting Define Symbols 中启用以下宏：
+
+- `OPPOMINIGAME`
+
+该宏是 YooAsset OPPO 小游戏示例约定的编译开关，用于和其它小游戏平台适配代码保持一致。
+
+## 初始化 YooAsset
+
+在 OPPO 小游戏构建中初始化 `WebPlayModeOptions` 时，使用 `OppoFileSystemCreater` 创建文件系统参数。
+
+```csharp
+#if UNITY_WEBGL && OPPOMINIGAME && !UNITY_EDITOR
+var createParameters = new WebPlayModeOptions();
+
+string defaultHostServer = GetHostServerURL();
+string fallbackHostServer = GetHostServerURL();
+string packageRoot = "/__GAME_FILE_CACHE";
+IRemoteService remoteService = new RemoteService(defaultHostServer, fallbackHostServer);
+
+createParameters.WebServerFileSystemParameters =
+    OppoFileSystemCreater.CreateFileSystemParameters(packageRoot, remoteService);
+
+var initializationOperation = package.InitializePackageAsync(createParameters);
+#endif
+```
+
+对当前文件系统来说，`packageRoot` 只需要是一个非空值。OPPO 真正的 AssetBundle 缓存行为由生成后小游戏工程里的 `manifest.json` 控制。
+
+## OPPO 缓存配置
+
+配置小游戏工程的 `manifest.json`，让 OPPO 能识别 YooAsset 的资源包 URL：
+
+```json
+{
+  "disableBundleCache": false,
+  "gameCDNRoot": "https://your-cdn.example.com/StreamingAssets",
+  "bundlePathIdentifier": "StreamingAssets;bundles",
+  "excludeFileExtensions": ".json;.hash;.version;.bytes",
+  "bundleHashLength": 32,
+  "defaultReleaseSize": 30,
+  "keepOldVersion": false,
+  "enableCacheLog": true
+}
+```
+
+`gameCDNRoot` 必须和 YooAsset `IRemoteService` 返回的 CDN 根地址一致。如果不匹配，OPPO 会把请求当成普通网络请求处理，不会进入资源缓存逻辑。
+
+`excludeFileExtensions` 建议包含 YooAsset 的清单、版本和哈希文件后缀，让 OPPO 只缓存 AssetBundle 文件。
+
+## 资源包命名
+
+OPPO 通过远端文件名里的 hash 识别可缓存资源。YooAsset 推荐只使用 `HashName` 文件命名风格。
+
+`HashName` 会生成纯 hash 文件名，例如：
+
+```text
+8d265a9dfd6cb7669cdb8b726f0afb1e.bundle
+```
+
+该命名方式和 OPPO 资源缓存规则最匹配，也能避免暴露原始 Bundle 名称。OPPO 缓存构建不建议使用 `BundleName` 或 `BundleName_HashName`。
+
+## 注意事项
+
+加密 AssetBundle 仍然会走 YooAsset 常规的 Web 下载和解密流程。非加密 AssetBundle 会使用 OPPO 平台适配器；当 `manifest.json` 缓存规则匹配时，可由 OPPO 小游戏运行时缓存。

Assets/YooAsset/Samples~/Mini Game/Runtime/OppoFileSystem/README.md.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: a0f637cda89f4889a7f7d7c169b4390b
+TextScriptImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: