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 | - |