collisionFilters.*

类型
修订 发行版 2024.3703
关键词 物理学、碰撞、筛选
平台 安卓、iOS、macOS、Windows、tvOS
另请参阅 碰撞检测 (指南)
物理体 (指南)

概述

此插件旨在规避使用 categoryBitsmaskBits 创建物理体碰撞筛选时的数学计算和复杂性,如 此处 所述。这一过程允许你分配用户友好的名称给物理模拟中的对象“类别”,而无需担心在调整游戏行为时可能发生变化的内部二进制值和总和。

重要信息

此插件强制遵守 Box2D 的标准,以确保正确的功能,包括

  • 最多可以使用 16 个不同的碰撞类别(请注意,即使是复杂的游戏通常也不需要超过 10 个)。

  • 在必要时,将添加新筛选器和未配对掩码以确保符合 Box2D类别+掩码关系。此时,将生成控制台警报。

语法

local collisionFilters = require( "plugin.collisionFilters" )

项目设置

要使用此插件,请在 build.settingsplugins 表中添加一个条目。添加后,构建服务器将在构建阶段整合该插件。

settings =
{
    plugins =
    {
        ["plugin.collisionFilters"] =
        {
            publisherId = "com.coronalabs"
        },
    },
}

函数

collisionFilters.setupFilters()

collisionFilters.getFilter()

collisionFilters.viewAllFilters()