Skip to content

MiniGameConfig.asset 配置文件说明

位于 Assets/WX-WASM-SDK-V2/Editor/MiniGameConfig.asset 即为 WXSDK 的导出配置文件,其中部分配置可在微信小游戏导出面板中可视化配置,本节将对配置文件中各项字段进行说明,开发者可直接修改其配置内容。

ProjectConfig:

字段类型说明
projectNamestring项目名称。
Appidstring微信小游戏Appid,前往 https://mp.weixin.qq.com/ 注册获得。
CDNstring游戏CDN前缀。
assetLoadTypeint首资源包加载方式,0: CDN加载;1: 小游戏包内加载。
compressDataPackagebool将首包资源Brotli压缩, 降低资源大小. 注意: 首次启动耗时可能会增加200ms, 仅推荐使用小游戏分包加载时节省包体大小使用。
VideoUrlstring加载阶段视频URL,可缺省。
DSTstring导出路径。
StreamCDNstring已废弃。
bundleHashLengthint自定义Bundle文件名中hash部分长度,默认值32,用于缓存控制。
bundlePathIdentifierstring路径中包含特定标识符开始下载bundle,将被自动缓存。半角分号分隔。
bundleExcludeExtensionsstring排除路径下指定类型文件不缓存。半角分号分隔。
AssetsUrlstring已废弃。
MemorySize: 256int游戏内存大小(MB)。
HideAfterCallMainboolcallmain完成后是否立即隐藏加载封面。
preloadFilesstring预下载列表。半角分号分隔。
Orientationint设备方向,0:Portrait; 1:Landscape; 2:LandscapeLeft; 3:LandscapeRight。
bgImageSrcstring启动背景图。
dataFileSubPrefixstring拼接在DATA_CDN和首包资源文件名的路径,用于首包资源没放到DATA_CDN根目录的情况。
maxStorageint最大缓存容量,单位MB,设置后若接近容量阈值将自动回收。
defaultReleaseSizeint清理缓存时默认额外清理的大小,单位Bytes,默认值30MB。
texturesHashLengthint微信压缩纹理工具处理的尾部hash长度,用于识别缓存。
texturesPathstring微信压缩纹理工具处理的纹理CDN拼接路径。
needCacheTexturesbool是否缓存微信压缩纹理工具处理的贴图资源。
loadingBarWidthint加载进度条的宽度,默认240。
needCheckUpdatebool是否需要启动时自动检查小游戏是否有新版本。
disableHighPerformanceFallbackbool是否禁止开启高性能模式后在不支持的iOS设备上回退为普通模式,注意:不要随意修改,只有开通高性能模式后并确认不回退才修改。
IOSDevicePixelRatiofloatIOS限制固定的分辨率,以减少内存,但是会降低游戏画面品质。

SDKOptions:

字段类型说明
UseFriendRelationbool是否使用好友关系链。
UseCompressedTexturebool已废弃。
UseMiniGameChatbool是否使用社交组件。
PreloadWXFontbool是否使用预载系统字体。

CompileOptions:

字段类型说明
DevelopBuildboolDevelopment Build.
AutoProfileboolAutoconnect Profiler.
ScriptOnlyboolScripts Only Build.
Il2CppOptimizeSizebool对应于Il2CppCodeGeneration选项,勾选时使用OptimizeSize(默认推荐),生成代码小15%左右,取消勾选则使用OptimizeSpeed。游戏中大量泛型集合的高频访问建议OptimizeSpeed,在使用HybridCLR等第三方组件时只能用OptimizeSpeed。(Dotnet Runtime模式下该选项无效)。
profilingFuncsboolProfiling Funcs.
Webgl2boolWebGL2.0
fbslimbool导出时自动清理UnityEditor默认打包但游戏项目从未使用的资源,瘦身首包资源体积。(团结引擎已无需开启该能力)。
DeleteStreamingAssetsboolClear Streaming Assets.
ProfilingMemoryboolProfiling Memory.
CleanBuildboolClean WebGL Build.
CustomNodePathstring已废弃。
showMonitorSuggestModalbool是否显示最佳实践检测弹框。
enableProfileStatsbool是否显示性能面板。
enableRenderAnalysisbool是否显示渲染分析日志(develop build才生效)。
iOSAutoGCIntervalintiOS高性能模式自动GC间隔(毫秒)。
enableIOSPerformancePlusbool是否使用iOS高性能Plus。
brotliMT: 1bool是否使用brotli多线程压缩
autoAdaptScreenbool是否使用自适应屏幕尺寸变化

CompressTexture:

以下是微信压缩纹理工具涉及配置,如未使用微信压缩纹理工具可以不予设置。

字段类型说明
halfSizebool已废弃。
useDXT5bool是否开启 PC 压缩纹理。
bundleSuffixstring已废弃。
parallelWithBundleint已废弃。
bundleDirstring自定义 AB 包目录路径。
dstMinDirstring压缩纹理产物输出目录。
debugModebool是否开启仅 ASTC 模式。
forcebool是否强制重新执行。

PlayerPrefsKeys:

使用PlayerPref接口时传入的key,此处设置将预先加载。

FontOptions:

字体相关配置。请阅读 WXFont章节

字段类型说明
CJK_Unified_Ideographsbool-
C0_Controls_and_Basic_Latinbool-
CJK_Symbols_and_Punctuationbool-
General_Punctuationbool-
Enclosed_CJK_Letters_and_Monthsbool-
Vertical_Formsbool-
CJK_Compatibility_Formsbool-
Miscellaneous_Symbolsbool-
CJK_Compatibilitybool-
Halfwidth_and_Fullwidth_Formsbool-
Dingbatsbool-
Letterlike_Symbolsbool-
Enclosed_Alphanumericsbool-
Number_Formsbool-
Currency_Symbolsbool-
Arrowsbool-
Geometric_Shapesbool-
Mathematical_Operatorsbool-
CustomUnicodebool-

Released under the MIT License.