Question

JavaScript => static function OverlapArea(pointA: Vector2, pointB: Vector2, layerMask: int = DefaultRaycastLayers, minDepth: float = -Mathf.Infinity, maxDepth: float = Mathf.Infinity): Collider2D;
C# => static Collider2D OverlapArea(Vector2 pointA, Vector2 pointB, int layerMask = DefaultRaycastLayers, float minDepth = -Mathf.Infinity, float maxDepth = Mathf.Infinity);

Parameters 参数

pointA	One corner of the rectangle. 矩形的一个角。
pointB	Diagonally opposite corner of the rectangle. 矩形的对角。
layerMask	Filter to detect Colliders only on certain layers. 只在某些层过滤检测碰撞器。
minDepth	Only include objects with a Z coordinate (depth) greater than this value. 只包括Z坐标(深度)大于这个值的对象。
maxDepth	Only include objects with a Z coordinate (depth) less than this value. 只包括Z坐标(深度)小于这个值的对象。

Description 描述

Check if a collider falls within a rectangular area.
检测一个碰撞器是否与落在一个矩形区域（里面）。

The rectangle is defined by two diagonally opposite corner coordinates in world space. You can think of these as top-left and bottom-right but the test will still work if the ordering of the points is reversed. The optional layerMask allows the test to check only for objects on specific layers.
矩形是由两个在世界空间中的对角坐标点定义出来的。你可以当作定义一个左上角和一个右下角的两个点，而且这两个点就算调换顺序矩形检测还是一样工作的。图层遮罩可以用于指定检测特定某些图层的对象。

Although the Z axis is not relevant for rendering or collisions in 2D, you can use the minDepth and maxDepth parameters to filter objects based on their Z coordinate. If more than one collider falls within the area then the one returned will be the one with the lowest Z coordinate value. Null is returned if there are no colliders in the area.
虽然Z轴与2D的渲染或碰撞无关，但是你可以使用minDepth和maxDepth参数去排除一些对象基于他们的Z轴。如果有好几个碰撞器都落在（重叠）检测区域，那么最小的Z坐标的那个碰撞器将会被返回。如果没有碰撞器在区域中就返回Null了。

Note that this function will allocate memory for the returned Collider2D object. You can use OverlapAreaNonAlloc to avoid this overhead if you need to make the check frequently.
还要注意这个函数会分配内存给返回的Collider2D对象。在你需要频繁做这个检测的时候，可以使用OverlapAreaNonAlloc这个函数去避免这些开销。

See Also: OverlapCircle, OverlapPoint, OverlapCircleAll, OverlapAreaNonAlloc.