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