

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 範例：建立使用玩家封鎖清單的規則
<a name="match-examples-11"></a>

此範例說明規則集，可讓玩家避免與其他特定玩家配對。玩家可以建立封鎖清單，配對建構器會在玩家選擇配對期間評估該清單。如需新增封鎖清單或避免清單功能的更多指引，請參閱[AWS 遊戲部落格的](https://aws.amazon.com/blogs/gametech/category/game-development/amazon-gamelift/) 。

此範例會列出下列指示：
+ 建立兩個隊伍，只有五個玩家。
+ 傳入玩家的封鎖清單，這是玩家 IDs的清單 （最多 100 個）。
+ 將所有玩家與每個玩家的封鎖清單進行比較，如果找到任何封鎖的玩家 IDs，則會拒絕提議的配對。

使用此規則集的注意事項：
+ 評估新玩家以新增至提議配對 （或回填現有配對中的位置） 時，玩家可能會因為下列其中一個原因遭到拒絕：
  + 如果新玩家位於已為配對選取的任何玩家的封鎖清單上。
  + 如果任何已為配對選取的玩家，都在新玩家的封鎖清單中。
+ 如圖所示，此規則集可防止將玩家與區塊清單上的任何玩家配對。您可以新增規則擴展並增加`maxCount`值，將此需求變更為偏好設定 （也稱為「避免」清單）。

```
{
    "name": "Player Block List",
    "ruleLanguageVersion": "1.0",
    "teams": [{
        "maxPlayers": 5,
        "minPlayers": 5,
        "name": "red"
    }, {
        "maxPlayers": 5,
        "minPlayers": 5,
        "name": "blue"
    }],
    "playerAttributes": [{
        "name": "BlockList",
        "type": "string_list",
        "default": []
    }],
    "rules": [{
        "name": "PlayerIdNotInBlockList",
        "type": "collection",
        "operation": "reference_intersection_count",
        "measurements": "flatten(teams[*].players.attributes[BlockList])",
        "referenceValue": "flatten(teams[*].players[playerId])",
        "maxCount": 0
    }]
}
```