MiniGameConfig.asset 配置文件说明
位于 Assets/WX-WASM-SDK-V2/Editor/MiniGameConfig.asset 即为 WXSDK 的导出配置文件,其中部分配置可在微信小游戏导出面板中可视化配置,本节将对配置文件中各项字段进行说明,开发者可直接修改其配置内容。
ProjectConfig:
| 字段 | 类型 | 说明 |
| projectName | string | 项目名称。 |
| Appid | string | 微信小游戏Appid,前往 https://mp.weixin.qq.com/ 注册获得。 |
| CDN | string | 游戏CDN前缀。 |
| assetLoadType | int | 首资源包加载方式,0: CDN加载;1: 小游戏包内加载。 |
| compressDataPackage | bool | 将首包资源Brotli压缩, 降低资源大小. 注意: 首次启动耗时可能会增加200ms, 仅推荐使用小游戏分包加载时节省包体大小使用。 |
| VideoUrl | string | 加载阶段视频URL,可缺省。 |
| DST | string | 导出路径。 |
| StreamCDN | string | 已废弃。 |
| bundleHashLength | int | 自定义Bundle文件名中hash部分长度,默认值32,用于缓存控制。 |
| bundlePathIdentifier | string | 路径中包含特定标识符开始下载bundle,将被自动缓存。半角分号分隔。 |
| bundleExcludeExtensions | string | 排除路径下指定类型文件不缓存。半角分号分隔。 |
| AssetsUrl | string | 已废弃。 |
| MemorySize: 256 | int | 游戏内存大小(MB)。 |
| HideAfterCallMain | bool | callmain完成后是否立即隐藏加载封面。 |
| preloadFiles | string | 预下载列表。半角分号分隔。 |
| Orientation | int | 设备方向,0:Portrait; 1:Landscape; 2:LandscapeLeft; 3:LandscapeRight。 |
| bgImageSrc | string | 启动背景图。 |
| dataFileSubPrefix | string | 拼接在DATA_CDN和首包资源文件名的路径,用于首包资源没放到DATA_CDN根目录的情况。 |
| maxStorage | int | 最大缓存容量,单位MB,设置后若接近容量阈值将自动回收。 |
| defaultReleaseSize | int | 清理缓存时默认额外清理的大小,单位Bytes,默认值30MB。 |
| texturesHashLength | int | 微信压缩纹理工具处理的尾部hash长度,用于识别缓存。 |
| texturesPath | string | 微信压缩纹理工具处理的纹理CDN拼接路径。 |
| needCacheTextures | bool | 是否缓存微信压缩纹理工具处理的贴图资源。 |
| loadingBarWidth | int | 加载进度条的宽度,默认240。 |
| needCheckUpdate | bool | 是否需要启动时自动检查小游戏是否有新版本。 |
| disableHighPerformanceFallback | bool | 是否禁止开启高性能模式后在不支持的iOS设备上回退为普通模式,注意:不要随意修改,只有开通高性能模式后并确认不回退才修改。 |
| IOSDevicePixelRatio | float | IOS限制固定的分辨率,以减少内存,但是会降低游戏画面品质。 |
SDKOptions:
| 字段 | 类型 | 说明 |
| UseFriendRelation | bool | 是否使用好友关系链。 |
| UseCompressedTexture | bool | 已废弃。 |
| UseMiniGameChat | bool | 是否使用社交组件。 |
| PreloadWXFont | bool | 是否使用预载系统字体。 |
CompileOptions:
| 字段 | 类型 | 说明 |
| DevelopBuild | bool | Development Build. |
| AutoProfile | bool | Autoconnect Profiler. |
| ScriptOnly | bool | Scripts Only Build. |
| Il2CppOptimizeSize | bool | 对应于Il2CppCodeGeneration选项,勾选时使用OptimizeSize(默认推荐),生成代码小15%左右,取消勾选则使用OptimizeSpeed。游戏中大量泛型集合的高频访问建议OptimizeSpeed,在使用HybridCLR等第三方组件时只能用OptimizeSpeed。(Dotnet Runtime模式下该选项无效)。 |
| profilingFuncs | bool | Profiling Funcs. |
| Webgl2 | bool | WebGL2.0 |
| fbslim | bool | 导出时自动清理UnityEditor默认打包但游戏项目从未使用的资源,瘦身首包资源体积。(团结引擎已无需开启该能力)。 |
| DeleteStreamingAssets | bool | Clear Streaming Assets. |
| ProfilingMemory | bool | Profiling Memory. |
| CleanBuild | bool | Clean WebGL Build. |
| CustomNodePath | string | 已废弃。 |
| showMonitorSuggestModal | bool | 是否显示最佳实践检测弹框。 |
| enableProfileStats | bool | 是否显示性能面板。 |
| enableRenderAnalysis | bool | 是否显示渲染分析日志(develop build才生效)。 |
| iOSAutoGCInterval | int | iOS高性能模式自动GC间隔(毫秒)。 |
| enableIOSPerformancePlus | bool | 是否使用iOS高性能Plus。 |
| brotliMT: 1 | bool | 是否使用brotli多线程压缩 |
| autoAdaptScreen | bool | 是否使用自适应屏幕尺寸变化 |
CompressTexture:
以下是微信压缩纹理工具涉及配置,如未使用微信压缩纹理工具可以不予设置。
| 字段 | 类型 | 说明 |
| halfSize | bool | 已废弃。 |
| useDXT5 | bool | 是否开启 PC 压缩纹理。 |
| bundleSuffix | string | 已废弃。 |
| parallelWithBundle | int | 已废弃。 |
| bundleDir | string | 自定义 AB 包目录路径。 |
| dstMinDir | string | 压缩纹理产物输出目录。 |
| debugMode | bool | 是否开启仅 ASTC 模式。 |
| force | bool | 是否强制重新执行。 |
PlayerPrefsKeys:
使用PlayerPref接口时传入的key,此处设置将预先加载。
FontOptions:
字体相关配置。请阅读 WXFont章节。
| 字段 | 类型 | 说明 |
| CJK_Unified_Ideographs | bool | - |
| C0_Controls_and_Basic_Latin | bool | - |
| CJK_Symbols_and_Punctuation | bool | - |
| General_Punctuation | bool | - |
| Enclosed_CJK_Letters_and_Months | bool | - |
| Vertical_Forms | bool | - |
| CJK_Compatibility_Forms | bool | - |
| Miscellaneous_Symbols | bool | - |
| CJK_Compatibility | bool | - |
| Halfwidth_and_Fullwidth_Forms | bool | - |
| Dingbats | bool | - |
| Letterlike_Symbols | bool | - |
| Enclosed_Alphanumerics | bool | - |
| Number_Forms | bool | - |
| Currency_Symbols | bool | - |
| Arrows | bool | - |
| Geometric_Shapes | bool | - |
| Mathematical_Operators | bool | - |
| CustomUnicode | bool | - |