许可优化
许可优化
产品
产品
解决方案
解决方案
服务支持
服务支持
关于
关于
软件库
当前位置:服务支持 >  软件文章 >  Unity物理检测封装为静态类,代码规范优化建议

Unity物理检测封装为静态类,代码规范优化建议

阅读数 14
点赞 0
article_banner


3D版本

public static class PhysicRayCast

{

   #region 静态缓冲区

   // 3D射线检测缓冲区

   private static RaycastHit[] s_SingleRaycastBuffer = new RaycastHit[1];

   // 2D射线检测缓冲区

   private static RaycastHit2D[] s_SingleRaycastBuffer2D = new RaycastHit2D[1];

   #endregion

   #region 3D 物理检测

   /// <summary>

   /// 无分配版本的盒子碰撞检测

   /// </summary>

   /// <param name="center">盒子中心点</param>

   /// <param name="halfExtents">盒子半尺寸 (x=宽度/2, y=高度/2, z=深度/2)</param>

   /// <param name="direction">检测方向</param>

   /// <param name="hits">接收结果的缓冲区</param>

   /// <param name="distance">检测距离</param>

   /// <param name="layer">检测层级</param>

   /// <param name="queryTriggerInteraction">触发器交互模式</param>

   /// <param name="debugDraw">是否绘制调试线</param>

   /// <returns>命中的对象数量</returns>

   public static int BoxCastNonAlloc(

       Vector3 center,

       Vector3 halfExtents,

       Vector3 direction,

       RaycastHit[] hits,

       float distance,

       LayerMask layer,

       QueryTriggerInteraction queryTriggerInteraction = QueryTriggerInteraction.Ignore,

       bool debugDraw = false)

   {

       int hitCount = Physics.BoxCastNonAlloc(

           center, halfExtents, direction, hits, Quaternion.identity, distance, layer, queryTriggerInteraction);

       if (debugDraw)

       {

           // 绘制检测方向线

           Debug.DrawRay(center, direction * distance, hitCount > 0 ? Color.green : Color.red);

           // 绘制盒子轮廓

           DrawBoxWireframe(center, halfExtents, hitCount > 0 ? Color.green : Color.red);

       }

       return hitCount;

   }

   /// <summary>

   /// 无分配版本的球形碰撞检测

   /// </summary>

   /// <param name="origin">球形起点</param>

   /// <param name="radius">球形半径</param>

   /// <param name="direction">检测方向</param>

   /// <param name="hits">接收结果的缓冲区</param>

   /// <param name="distance">检测距离</param>

   /// <param name="layer">检测层级</param>

   /// <param name="queryTriggerInteraction">触发器交互模式</param>

   /// <param name="debugDraw">是否绘制调试线</param>

   /// <returns>命中的对象数量</returns>

   public static int SphereCastNonAlloc(

       Vector3 origin,

       float radius,

       Vector3 direction,

       RaycastHit[] hits,

       float distance,

       LayerMask layer,

       QueryTriggerInteraction queryTriggerInteraction = QueryTriggerInteraction.Ignore,

       bool debugDraw = false)

   {

       int hitCount = Physics.SphereCastNonAlloc(

           origin, radius, direction, hits, distance, layer, queryTriggerInteraction);

       if (debugDraw)

       {

           // 绘制检测方向线

           Debug.DrawRay(origin, direction * distance, hitCount > 0 ? Color.green : Color.red);

           // 绘制球形轮廓

           DrawSphereWireframe(origin, radius, hitCount > 0 ? Color.green : Color.red);

       }

       return hitCount;

   }

   /// <summary>

   /// 无分配版本的单条射线检测

   /// </summary>

   /// <param name="origin">射线起点</param>

   /// <param name="direction">射线方向</param>

   /// <param name="hit">命中结果</param>

   /// <param name="distance">射线长度</param>

   /// <param name="layer">检测层级</param>

   /// <param name="queryTriggerInteraction">触发器交互模式</param>

   /// <param name="debugDraw">是否绘制调试线</param>

   /// <returns>是否命中</returns>

   public static bool SingleRaycast(

       Vector3 origin,

       Vector3 direction,

       out RaycastHit hit,

       float distance,

       LayerMask layer,

       QueryTriggerInteraction queryTriggerInteraction = QueryTriggerInteraction.Ignore,

       bool debugDraw = false)

   {

       bool hitFound = Physics.Raycast(origin, direction, out hit, distance, layer, queryTriggerInteraction);

       if (debugDraw)

       {

           Color color = hitFound ? Color.green : Color.red;

           Debug.DrawLine(origin, origin + direction * distance, color);

           // if (hitFound)

           // {

           //     // 绘制命中点和法线

           //     Debug.DrawLine(hit.point, hit.point + hit.normal * 0.5f, Color.blue);

           // }

       }

       return hitFound;

   }

   /// <summary>

   /// 无分配版本的多射线检测

   /// </summary>

   /// <param name="origins">射线起点数组</param>

   /// <param name="directions">射线方向数组</param>

   /// <param name="hits">接收结果的缓冲区</param>

   /// <param name="distance">射线长度</param>

   /// <param name="layer">检测层级</param>

   /// <param name="debugDraw">是否绘制调试线</param>

   /// <returns>(hitFound:是否有命中, hitCount:命中数量)</returns>

   public static (bool hitFound, int hitCount) MultiRaycastNoAlloc(

       Vector3[] origins,

       Vector3[] directions,

       RaycastHit[] hits,

       float distance,

       LayerMask layer,

       QueryTriggerInteraction queryTriggerInteraction = QueryTriggerInteraction.Ignore,

       bool debugDraw = false)

   {

       Debug.Assert(hits.Length >= origins.Length && hits.Length >= directions.Length, "hits缓冲区长度必须 >= 射线数量");

       bool hitFound = false;

       int hitCount = 0;

       for (int i = 0; i < origins.Length; i++)

       {

           // 使用静态缓冲区进行无分配检测

           int currentHitCount = Physics.RaycastNonAlloc(origins[i], directions[i], s_SingleRaycastBuffer, distance, layer, queryTriggerInteraction);

           bool currentHit = currentHitCount > 0;

           if (currentHit)

           {

               hits[i] = s_SingleRaycastBuffer[0];  // 将结果复制到输出缓冲区

               hitFound = true;

               hitCount++;

           }

           // 调试绘制

           if (debugDraw)

           {

               Color color = currentHit ? Color.green : Color.red;

               Debug.DrawLine(origins[i], origins[i] + directions[i] * distance, color);

               // if (currentHit)

               // {

               //     // 绘制命中点和法线

               //     Debug.DrawLine(hits[i].point, hits[i].point + hits[i].normal * 0.5f, Color.blue);

               // }

           }

       }

       return (hitFound, hitCount);

   }

   /// <summary>

   /// 便捷方法:三条射线检测(左、中、右)

   /// </summary>

   public static (bool hitFound, int hitCount) ThreeRaycastNoAlloc(

       Vector3 origin,

       float spacing,

       Transform transform,

       RaycastHit[] hits,

       float distance,

       LayerMask layer,

       QueryTriggerInteraction queryTriggerInteraction = QueryTriggerInteraction.Ignore,

       bool debugDraw = false)

   {

       Vector3[] origins = new Vector3[3];

       origins[0] = origin;                           // 中心

       origins[1] = origin - transform.right * spacing; // 左

       origins[2] = origin + transform.right * spacing; // 右

       Vector3[] directions = new Vector3[3];

       directions[0] = Vector3.down;  // 中心

       directions[1] = Vector3.down;  // 左

       directions[2] = Vector3.down;  // 右

       return MultiRaycastNoAlloc(origins, directions, hits, distance, layer, queryTriggerInteraction, debugDraw);

   }

   /// <summary>

   /// 便捷方法:五条射线检测(左、左中、中、右中、右)

   /// </summary>

   public static (bool hitFound, int hitCount) FiveRaycastNoAlloc(

       Vector3 origin,

       float spacing,

       Transform transform,

       RaycastHit[] hits,

       float distance,

       LayerMask layer,

       QueryTriggerInteraction queryTriggerInteraction = QueryTriggerInteraction.Ignore,

       bool debugDraw = false)

   {

       Vector3[] origins = new Vector3[5];

       origins[0] = origin - transform.right * spacing;       // 左

       origins[1] = origin - transform.right * spacing * 0.5f; // 左中

       origins[2] = origin;                                   // 中

       origins[3] = origin + transform.right * spacing * 0.5f; // 右中

       origins[4] = origin + transform.right * spacing;        // 右

       Vector3[] directions = new Vector3[5];

       for (int i = 0; i < 5; i++)

       {

           directions[i] = Vector3.down;

       }

       return MultiRaycastNoAlloc(origins, directions, hits, distance, layer, queryTriggerInteraction, debugDraw);

   }

   #endregion

   #region 3D 调试绘制辅助方法

   /// <summary>

   /// 绘制盒子线框

   /// </summary>

   private static void DrawBoxWireframe(Vector3 center, Vector3 halfExtents, Color color)

   {

       Vector3[] corners = new Vector3[8];

       // 计算8个顶点

       corners[0] = center + new Vector3(-halfExtents.x, -halfExtents.y, -halfExtents.z);

       corners[1] = center + new Vector3(halfExtents.x, -halfExtents.y, -halfExtents.z);

       corners[2] = center + new Vector3(halfExtents.x, -halfExtents.y, halfExtents.z);

       corners[3] = center + new Vector3(-halfExtents.x, -halfExtents.y, halfExtents.z);

       corners[4] = center + new Vector3(-halfExtents.x, halfExtents.y, -halfExtents.z);

       corners[5] = center + new Vector3(halfExtents.x, halfExtents.y, -halfExtents.z);

       corners[6] = center + new Vector3(halfExtents.x, halfExtents.y, halfExtents.z);

       corners[7] = center + new Vector3(-halfExtents.x, halfExtents.y, halfExtents.z);

       // 绘制12条边

       int[] edges = {

           0,1, 1,2, 2,3, 3,0,  // 底面

           4,5, 5,6, 6,7, 7,4,  // 顶面

           0,4, 1,5, 2,6, 3,7   // 垂直边

       };

       for (int i = 0; i < edges.Length; i += 2)

       {

           Debug.DrawLine(corners[edges[i]], corners[edges[i + 1]], color);

       }

   }

   /// <summary>

   /// 绘制球形线框

   /// </summary>

   private static void DrawSphereWireframe(Vector3 center, float radius, Color color)

   {

       int segments = 16;

       float angleStep = 360f / segments;

       // 绘制XY平面的圆

       for (int i = 0; i < segments; i++)

       {

           float angle1 = i * angleStep * Mathf.Deg2Rad;

           float angle2 = (i + 1) * angleStep * Mathf.Deg2Rad;

           Vector3 p1 = center + new Vector3(Mathf.Cos(angle1) * radius, Mathf.Sin(angle1) * radius, 0);

           Vector3 p2 = center + new Vector3(Mathf.Cos(angle2) * radius, Mathf.Sin(angle2) * radius, 0);

           Debug.DrawLine(p1, p2, color);

       }

       // 绘制XZ平面的圆

       for (int i = 0; i < segments; i++)

       {

           float angle1 = i * angleStep * Mathf.Deg2Rad;

           float angle2 = (i + 1) * angleStep * Mathf.Deg2Rad;

           Vector3 p1 = center + new Vector3(Mathf.Cos(angle1) * radius, 0, Mathf.Sin(angle1) * radius);

           Vector3 p2 = center + new Vector3(Mathf.Cos(angle2) * radius, 0, Mathf.Sin(angle2) * radius);

           Debug.DrawLine(p1, p2, color);

       }

       // 绘制YZ平面的圆

       for (int i = 0; i < segments; i++)

       {

           float angle1 = i * angleStep * Mathf.Deg2Rad;

           float angle2 = (i + 1) * angleStep * Mathf.Deg2Rad;

           Vector3 p1 = center + new Vector3(0, Mathf.Cos(angle1) * radius, Mathf.Sin(angle1) * radius);

           Vector3 p2 = center + new Vector3(0, Mathf.Cos(angle2) * radius, Mathf.Sin(angle2) * radius);

           Debug.DrawLine(p1, p2, color);

       }

   }

   #endregion


免责声明:本文系网络转载或改编,未找到原创作者,版权归原作者所有。如涉及版权,请联系删

相关文章
技术文档
QR Code
微信扫一扫,欢迎咨询~
customer

online

联系我们
武汉格发信息技术有限公司
湖北省武汉市经开区科技园西路6号103孵化器
电话:155-2731-8020 座机:027-59821821
邮件:tanzw@gofarlic.com
Copyright © 2023 Gofarsoft Co.,Ltd. 保留所有权利
遇到许可问题?该如何解决!?
评估许可证实际采购量? 
不清楚软件许可证使用数据? 
收到软件厂商律师函!?  
想要少购买点许可证,节省费用? 
收到软件厂商侵权通告!?  
有正版license,但许可证不够用,需要新购? 
联系方式 board-phone 155-2731-8020
close1
预留信息,一起解决您的问题
* 姓名:
* 手机:

* 公司名称:

姓名不为空

姓名不为空

姓名不为空
手机不正确

手机不正确

手机不正确
公司不为空

公司不为空

公司不为空