Entitas CookBook 翻译 - 106_Index 索引

Index 索引

当我们想获取所有拥有Position Component 的Entity的时候,我们会创建一个Group然后遍历他。但是,如果我们只想获取某个Position上的Entity时,我们要怎么做呢?我们可以遍历所有有Position Component的Entity然后找到特定Position的Entity,或者我们可以用Index。

为了创建一个索引,我们需要给Component增加以下属性(注释):

using Entitas;
using Entitas.CodeGeneration.Attributes;

[Game]
public sealed class PositionComponent : IComponent {

    [EntityIndex]
    public IntVector2 value;
}

这个EntityIndex属性会告诉我们的代码生成器,在Context上创建一个让用户能够根据IntVector2来获取Entities的API。

这是MatchOne例子上从ProcessInputSystem中提取出来的代码片段:

foreach (var e in _contexts.game.GetEntitiesWithPosition(
                    new IntVector2(input.x, input.y)
                  ).Where(e => e.isInteractive)) {
    e.isDestroyed = true;
}

在这个片段中,我们向Context请求所有所有“input”位置上的Entities并且筛选出所有interactive的Entities。

在内部,Index其实就是一个group观察者。他在context初始化的时候创建,从一开始就订阅了group变化的事件。当我们开始创建entites并且在上面增加components时,他们就会进入groups以及index会被通知到entity被增加了对应的component。我们可以使用component的值来做哈希表中的key,entity本身作为value。这样我们就建立起了一个index。当我们replace或者 remove component的时候,这个index也会被通知到,它会获取到之前的component。所以当我们在entity中replace成其他component的时候,index会从哈希表中移除旧component的key,并且接受到一个带有新的value的added event。

在Entitas-CSharp中,我们有两种内置的index。EntityIndex以及PrimaryEntityIndexEntityIndex 是依靠哈希表来存储一组entity来作为值,这就意味着你可以有多个entity在同一个位置上。PrimaryEntityIndex确保每一个key都是只与一个entity相关联。当你拥有IdComponent并且想用IdComponent来查找Entity的时候,就非常方便了。但你需要存储一个Entity的引用到另一个Entity中时,我们也推荐你使用这种方法(更多关于这方面的会在ingredience 的章节中说到)。

就像上一段中说到的,Entitas-CSharp仅仅实现了两种简单的Entity Indexing的策略。你可能会需要更多更复杂的Index来让你获取某个范围内的enitity或是拥有一个更为复杂的Index key。这种情况下呢,你可以看一看AbstractEntityIndex类。将这本书提供给你的知识融会贯通,你应该会非常轻易地理解Index的实现并且写出自己自定义的Index。

你可能感兴趣的:(Entitas CookBook 翻译 - 106_Index 索引)