ORCA开源项目使用教程

1. 项目介绍

ORCA（Optimal Reciprocal Collision Avoidance）是一个用于Unity的开源库，它允许开发者在Unity项目中添加局部碰撞避免功能。此库适用于创建模拟环境，其中的代理（agents）能够向目标移动并平滑地避免彼此之间的碰撞，无需使用物理引擎。

ORCA库目前正处于开发阶段，支持移动代理、静态代理（动态、圆形障碍物）以及多边形障碍物。模拟使用Unity的作业系统（Job System）和Burst编译器实现，因此运行效率较高。它默认在平面坐标系（XY）上运行模拟，但也适用于3D项目（XZ平面）。

2. 项目快速启动

在Unity中使用ORCA之前，需要确保安装了Unity的包管理器以及相关的依赖库。

安装

1. 在Unity编辑器中，确保已经安装了Git依赖解析器（Git Dependency Resolver for Unity）。
2. 通过Unity的包管理器添加ORCA库。

快速启动代码

using Nebukam.ORCA;
using UnityEngine;

// 创建ORCABundle对象，包含运行模拟所需的所有组件
ORCABundle<Agent> bundle = new ORCABundle<Agent>();
bundle.plane = AxisPair.XY;

// 添加代理
Agent myFirstAgent = bundle.agents.Add(new float3(0f, 0f, 0f));

// 设置代理的期望速度
myFirstAgent.prefVelocity = new float3(1f, 1f, 0f);

void Update()
{
    // 完成模拟作业
    if (bundle.orca.TryComplete())
    {
        // 获取模拟后的代理速度和位置
        myFirstAgent.velocity //= simulated agent velocity;
        myFirstAgent.position //= simulated agent position;
    }

    // 调度下一次模拟
    bundle.orca.Schedule(Time.deltaTime);
}

3. 应用案例和最佳实践

案例一：避免代理之间的碰撞

在游戏或模拟环境中，使用ORCA库来使代理在移动时避免相互碰撞。通过设置代理的期望速度和位置，ORCA会自动计算避免碰撞的路径。

最佳实践

• 限制代理的数量，每个代理拥有多个分段，而不是大量代理拥有少量分段，以提高性能。
• 避免使用凹形障碍物，特别是具有锐角的凹形障碍物。
• 避免在同一个障碍物中使用交叉或相交的线段。

4. 典型生态项目

ORCA库是Nebukam公司一系列Unity相关开源项目中的一部分，以下是一些典型的生态项目：

• N:Beacon: 一个模块化的导航解决方案。
• N:Beacon-ORCA: 提供用户友好的ORCA实现。
• N:V-Field: 用于处理向量场的轻量级库。
• N:Geom: 一个用于程序化几何的工具包。

以上是对ORCA开源项目的简要介绍，快速启动指南，应用案例和典型生态项目的概述。开发者可以根据这些信息来集成和使用ORCA库，以增强其Unity项目中的碰撞避免功能。