开发技巧：特征匹配

应用背景

• （先抛开cocos应用环境，考虑抽象的形式。）设有对象：A、B、C、D、Z。
• 分别含有特征如下：

A: ['大', '红', '圆']
B: ['小', '红', '方']
C: ['小', '绿', '方']
D: ['小', '红', '长']
Z: ['大', '粉', '长']

应用案例A

• 若要以[A, B, D]为集合进行特征匹配，得到结果为：

可匹配的特征：['红']
不可匹配的特征：['大', '小', '圆', '方', '长']
可匹配的对象：[A, B, D]
不可匹配的对象：[]

• 以上结果可以根据需求分为以下理解方式：

• 由于可匹配的特征非空，说明[A, B, D]是有共同特征的。
• 由于不可匹配的特征非空，说明[A, B, D]并不完全含有相同的特征。

应用案例B

• 若以Z的特征作为参考，来匹配[A, B, C, D]，的到结果为：

可匹配的特征：['大', '长']
不可匹配的特征：['红', '圆', '小', '方', '绿', '粉']
可匹配的对象：[A, D]
不可匹配的对象：[B, C]

• 以上结果可以根据需求分为以下理解方式（在以Z的特征作为参考的前提下）：

• 可匹配的对象表明，[A, D]可以与Z匹配；但可匹配的特征表明，并不是Z的全部特征都被匹配。
• 不可匹配的对象非空，表明以Z作为参考，并不能匹配所有对象。

匹配的具体实施（～未测试～）

• 用到的方法：

Utils.array.featureMatch(
  items, // 含有特征的对象集合
  reference, // 匹配参考特征集，为空则仅考虑items本身
  featureFunc // 获得item特征的方法对象
)
// 该方法返回如下结果形式：
{
  featuresMatched:[], // 可匹配的特征集合
  featuresUnmatched:[], // 不可匹配的特征集合
  itemsMatched:[], // 可匹配的对象集合
  itemsUnmatched:[], // 不可匹配的对象集合
}

• 假设应用背景中的A、B、C、D、Z均为节点，且特征以节点标签的形式存在，包含特征的标签名为'features'，比如A节点的命名为：A?features=大 红 圆。
• 完成应用案例A的代码如下：

// 自定义获取item特征的方法对象
var featureFunc = (item)=>{
  // 由于item是节点，因此用以下方法获得节点特征
  return Utils.node.getFeatures(item, 'features');
};
// 实施匹配
var results = Utils.array.featureMatch(
  [A, B, D], // 以A、B、D节点作为对象集进行特者匹配
  null, // 没有参考特征集
  featureFunc // 自定义的特征获取方法
);
// 得到的results内容如下：
{
  featuresMatched:['红'], 
  featuresUnmatched:['大', '小', '圆', '方', '长'], 
  itemsMatched:[A, B, D], 
  itemsUnmatched:[], 
}

• 完成应用案例B的代码如下：

// 获得Z的特征作为参考特征集
var referenceFeatures = Utils.node.getFeatures(Z,  'features');
// 自定义获取item特征的方法对象
var featureFunc = (item)=>{
  // 由于item是节点，因此用以下方法获得节点特征
  return Utils.node.getFeatures(item, 'features');
};
// 实施匹配
var results = Utils.array.featureMatch(
  [A, B, D], // 以A、B、D节点作为对象集进行特者匹配
  referenceFeatures, // 使用参考特征集
  featureFunc // 自定义的特征获取方法
);
// 得到的results内容如下：
{
  featuresMatched:['大', '长'], 
  featuresUnmatched:['红', '圆', '小', '方', '绿', '粉'], 
  itemsMatched:[A, D], 
  itemsUnmatched:[B, C], 
}