xLua中处理UnityEngine.QualitySettings方法黑名单过滤的注意事项

在xLua项目开发过程中，我们经常需要将Unity引擎的C#方法暴露给Lua脚本使用。xLua提供了黑名单机制，允许开发者排除某些不希望被自动生成桥接代码的方法。然而，在实际使用中，处理引用类型参数的方法时可能会遇到一些特殊情况。

问题现象

当尝试将UnityEngine.QualitySettings类的GetAllRenderPipelineAssetsForPlatform方法加入黑名单时，发现即使配置了黑名单规则，该方法仍然会被生成到桥接代码中。经过排查，发现问题的根源在于引用类型参数的处理方式。

问题分析

GetAllRenderPipelineAssetsForPlatform方法的签名包含一个List的引用类型参数。在配置黑名单时，直接使用typeof(List).FullName获取的类型名称与xLua内部处理时使用的类型名称不匹配，导致过滤失效。

根本原因在于：

1. 对于引用类型参数，需要调用MakeByRefType()方法获取正确的类型信息
2. 直接使用类型FullName无法正确匹配引用参数的类型签名

解决方案

正确的黑名单配置应该如下：

new List<string>() {
    "UnityEngine.QualitySettings", 
    "GetAllRenderPipelineAssetsForPlatform", 
    typeof(string).FullName, 
    typeof(List<RenderPipelineAsset>).MakeByRefType().FullName
}

这种配置方式能够确保：

1. 正确识别方法所属的类
2. 准确匹配方法名称
3. 正确处理参数类型，特别是引用类型参数

最佳实践

在处理xLua黑名单配置时，特别是对于包含引用参数的方法，建议：

1. 始终使用MakeByRefType()处理输出参数或引用参数
2. 对于泛型类型，确保使用完整的泛型类型名称
3. 可以通过反射获取方法的确切签名，确保黑名单配置的准确性
4. 在复杂情况下，可以打印出方法的完整签名进行比对

总结

xLua的黑名单机制虽然强大，但在处理特殊类型参数时需要格外注意。理解C#类型系统在反射中的表现，特别是引用类型和泛型的处理方式，能够帮助我们更准确地配置黑名单规则，避免不必要的桥接代码生成。