AWS::GameLift::MatchmakingRuleSet - AWS CloudFormation
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS::GameLift::MatchmakingRuleSet

AWS::GameLift::MatchmakingRuleSet 资源为 FlexMatch 对战创建新的规则集。规则集描述要创建的匹配的类型,例如团队的数量和规模。它还为可接受的玩家匹配设置参数,例如最低技能级别或角色类型。规则集由对战配置使用。

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

{ "Type" : "AWS::GameLift::MatchmakingRuleSet", "Properties" : { "Name" : String, "RuleSetBody" : String } }

YAML

Type: AWS::GameLift::MatchmakingRuleSet Properties: Name: String RuleSetBody: String

属性

Name

对战规则集的唯一标识符。对战配置通过该名称值标识它使用的规则集。请注意,规则集名称与规则集正文中的可选 name 字段不同。

必需:是

类型:字符串

最高128

模式[a-zA-Z0-9-\.]*

Update requires: Replacement

RuleSetBody

一组对战规则,采用 JSON 字符串格式。不允许在 JSON 中使用注释,但大多数元素支持描述字段。

必需:是

类型:字符串

最低1

最高65535

Update requires: Replacement

返回值

Ref

在将此资源的逻辑 ID 传递给内部 Ref 函数时,Ref 返回规则集名称,它在每个区域中是唯一的。

For more information about using the Ref function, see Ref.

Fn::GetAtt

Fn::GetAtt 内部函数返回此类型的一个指定属性的值。以下为可用属性和示例返回值。

有关使用 Fn::GetAtt 内部函数的更多信息,请参阅 Fn::GetAtt

Arn

分配给规则集的唯一 Amazon 资源名称 (ARN)。

Name

规则集的唯一名称。

示例

创建对战规则集

以下示例为名为 MyRuleSet 的 GameLift FlexMatch 创建对战规则集。简单规则集为一个包含 1 至 20 名玩家的团队定义匹配。在 YAML 示例中,由于 RuleSetBody 必须采用 JSON 格式,因此,使用 !Sub 命令指定采用 YAML 格式的 JSON 内容。

JSON

{ "Resources": { "MatchmakingRuleSet": { "Type": "AWS::GameLift::MatchmakingRuleSet", "Properties": { "Name": "MyRuleSet", "RuleSetBody": { "Fn::Sub": "{\"name\": \"MyMatchmakingRuleSet\",\"ruleLanguageVersion\": \"1.0\", \"teams\": [{\"name\": \"MyTeam\",\"minPlayers\": 1,\"maxPlayers\": 20}]}" } } } } }

YAML

Resources: MatchmakingRuleSet: Type: "AWS::GameLift::MatchmakingRuleSet" Properties: Name: "MyRuleSet" RuleSetBody: !Sub | { "name": "MyMatchmakingRuleSet", "ruleLanguageVersion": "1.0", "teams": [{ "name": "MyTeam", "minPlayers": 1, "maxPlayers": 20 }] }

另请参阅