

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# FlexMatchMatchmaking-Ereignisse
<a name="match-events"></a>

Amazon GameLift ServersFlexMatchsendet Ereignisse für jedes Matchmaking-Ticket aus, während es verarbeitet wird. Sie können diese Ereignisse in einem Amazon SNS SNS-Thema veröffentlichen, wie unter beschrieben[FlexMatchEvent-Benachrichtigungen einrichten](match-notification.md). Diese Ereignisse werden auch nahezu in Echtzeit und nach bestem Wissen und Gewissen an Amazon CloudWatch Events gesendet.

Dieses Thema beschreibt die Struktur von FlexMatch Ereignissen und bietet ein Beispiel für jeden Ereignistyp. Weitere Informationen zum Status von Matchmaking-Tickets finden Sie [MatchmakingTicket](https://docs.aws.amazon.com/gamelift/latest/apireference/API_MatchmakingTicket.html)in der *Amazon GameLift ServersAPI-Referenz*.

**Topics**
+ [MatchmakingSearching](match-events-matchmakingsearching.md)
+ [PotentialMatchCreated](match-events-potentialmatchcreated.md)
+ [AcceptMatch](match-events-acceptmatch.md)
+ [AcceptMatchCompleted](match-events-acceptmatchcompleted.md)
+ [MatchmakingSucceeded](match-events-matchmakingsucceeded.md)
+ [MatchmakingTimedOut](match-events-matchmakingtimedout.md)
+ [MatchmakingCancelled](match-events-matchmakingcancelled.md)
+ [MatchmakingFailed](match-events-matchmakingfailed.md)

# MatchmakingSearching
<a name="match-events-matchmakingsearching"></a>

Das Ticket wurde in Matchmaking eingegeben. Dies umfasst neue Anforderungen und Anforderungen, die Teil eines fehlgeschlagenen vorgeschlagenen Match sind.

**Ressource:** ConfigurationArn

**Detail:** Typ, Tickets estimatedWaitMillis, gameSessionInfo

## Beispiel
<a name="match-events-matchmakingsearching-example"></a>

```
{
  "version": "0",
  "id": "cc3d3ebe-1d90-48f8-b268-c96655b8f013",
  "detail-type": "GameLift Matchmaking Event",
  "source": "aws.gamelift",
  "account": "123456789012",
  "time": "2017-08-08T21:15:36.421Z",
  "region": "us-west-2",
  "resources": [
    "arn:aws:gamelift:us-west-2:123456789012:matchmakingconfiguration/SampleConfiguration"
  ],
  "detail": {
    "tickets": [
      {
        "ticketId": "ticket-1",
        "startTime": "2017-08-08T21:15:35.676Z",
        "players": [
          {
            "playerId": "player-1"
          }
        ]
      }
    ],
    "estimatedWaitMillis": "NOT_AVAILABLE",
    "type": "MatchmakingSearching",
    "gameSessionInfo": {
      "players": [
        {
          "playerId": "player-1"
        }
      ]
    }
  }
}
```

# PotentialMatchCreated
<a name="match-events-potentialmatchcreated"></a>

Ein potenzielles Match wurde erstellt. Dies wird für alle neuen potenziellen Übereinstimmungen ausgegeben, unabhängig davon, ob die Annahme erforderlich ist.

**Ressource:** ConfigurationArn

**Detail:** Typ, Tickets, AcceptanceTimeout, AcceptanceRequired,,, MatchID ruleEvaluationMetrics gameSessionInfo

## Beispiel
<a name="match-events-potentialmatchcreated-example"></a>

```
{
  "version": "0",
  "id": "fce8633f-aea3-45bc-aeba-99d639cad2d4",
  "detail-type": "GameLift Matchmaking Event",
  "source": "aws.gamelift",
  "account": "123456789012",
  "time": "2017-08-08T21:17:41.178Z",
  "region": "us-west-2",
  "resources": [
    "arn:aws:gamelift:us-west-2:123456789012:matchmakingconfiguration/SampleConfiguration"
  ],
  "detail": {
    "tickets": [
      {
        "ticketId": "ticket-1",
        "startTime": "2017-08-08T21:15:35.676Z",
        "players": [
          {
            "playerId": "player-1",
            "team": "red"
          }
        ]
      },
      {
        "ticketId": "ticket-2",
        "startTime": "2017-08-08T21:17:40.657Z",
        "players": [
          {
            "playerId": "player-2",
            "team": "blue"
          }
        ]
      }
    ],
    "acceptanceTimeout": 600,
    "ruleEvaluationMetrics": [
      {
        "ruleName": "EvenSkill",
        "passedCount": 3,
        "failedCount": 0
      },
      {
        "ruleName": "EvenTeams",
        "passedCount": 3,
        "failedCount": 0
      },
      {
        "ruleName": "FastConnection",
        "passedCount": 3,
        "failedCount": 0
      },
      {
        "ruleName": "NoobSegregation",
        "passedCount": 3,
        "failedCount": 0
      }
    ],
    "acceptanceRequired": true,
    "type": "PotentialMatchCreated",
    "gameSessionInfo": {
      "players": [
        {
          "playerId": "player-1",
          "team": "red"
        },
        {
          "playerId": "player-2",
          "team": "blue"
        }
      ]
    },
    "matchId": "3faf26ac-f06e-43e5-8d86-08feff26f692"
  }
}
```

# AcceptMatch
<a name="match-events-acceptmatch"></a>

Spieler haben ein potenzielles Match akzeptiert. Dieses Ereignis enthält den aktuellen Akzeptanzstatus jedes Spielers im Match. Fehlende Daten bedeuten, dass sie für diesen Spieler nicht aufgerufen wurden. AcceptMatch 

**Ressource:** ConfigurationArn

**Detail:** Typ, Tickets, MatchID, gameSessionInfo

## Beispiel
<a name="match-events-acceptmatch-example"></a>

```
{
  "version": "0",
  "id": "b3f76d66-c8e5-416a-aa4c-aa1278153edc",
  "detail-type": "GameLift Matchmaking Event",
  "source": "aws.gamelift",
  "account": "123456789012",
  "time": "2017-08-09T20:04:42.660Z",
  "region": "us-west-2",
  "resources": [
    "arn:aws:gamelift:us-west-2:123456789012:matchmakingconfiguration/SampleConfiguration"
  ],
  "detail": {
    "tickets": [
      {
        "ticketId": "ticket-1",
        "startTime": "2017-08-09T20:01:35.305Z",
        "players": [
          {
            "playerId": "player-1",
            "team": "red"
          }
        ]
      },
      {
        "ticketId": "ticket-2",
        "startTime": "2017-08-09T20:04:16.637Z",
        "players": [
          {
            "playerId": "player-2",
            "team": "blue",
            "accepted": false
          }
        ]
      }
    ],
    "type": "AcceptMatch",
    "gameSessionInfo": {
      "players": [
        {
          "playerId": "player-1",
          "team": "red"
        },
        {
          "playerId": "player-2",
          "team": "blue",
          "accepted": false
        }
      ]
    },
    "matchId": "848b5f1f-0460-488e-8631-2960934d13e5"
  }
}
```

# AcceptMatchCompleted
<a name="match-events-acceptmatchcompleted"></a>

Die Match-Akzeptanz ist durch Spieler-Akzeptanz, Spieler-Ablehnung oder Akzeptanz-Timeout erfolgt.

**Ressource:** ConfigurationArn

**Detail:** Typ, Tickets, Akzeptanz, MatchID, gameSessionInfo

## Beispiel
<a name="match-events-acceptmatchcompleted-example"></a>

```
{
  "version": "0",
  "id": "b1990d3d-f737-4d6c-b150-af5ace8c35d3",
  "detail-type": "GameLift Matchmaking Event",
  "source": "aws.gamelift",
  "account": "123456789012",
  "time": "2017-08-08T20:43:14.621Z",
  "region": "us-west-2",
  "resources": [
    "arn:aws:gamelift:us-west-2:123456789012:matchmakingconfiguration/SampleConfiguration"
  ],
  "detail": {
    "tickets": [
      {
        "ticketId": "ticket-1",
        "startTime": "2017-08-08T20:30:40.972Z",
        "players": [
          {
            "playerId": "player-1",
            "team": "red"
          }
        ]
      },
      {
        "ticketId": "ticket-2",
        "startTime": "2017-08-08T20:33:14.111Z",
        "players": [
          {
            "playerId": "player-2",
            "team": "blue"
          }
        ]
      }
    ],
    "acceptance": "TimedOut",
    "type": "AcceptMatchCompleted",
    "gameSessionInfo": {
      "players": [
        {
          "playerId": "player-1",
          "team": "red"
        },
        {
          "playerId": "player-2",
          "team": "blue"
        }
      ]
    },
    "matchId": "a0d9bd24-4695-4f12-876f-ea6386dd6dce"
  }
}
```

# MatchmakingSucceeded
<a name="match-events-matchmakingsucceeded"></a>

Das Matchmaking wurde erfolgreich abgeschlossen und eine Spielsitzung wurde erstellt.

**Ressource:** ConfigurationArn

**Detail:** Typ, Tickets, MatchID, gameSessionInfo

## Beispiel
<a name="match-events-matchmakingsucceeded-example"></a>

```
{
  "version": "0",
  "id": "5ccb6523-0566-412d-b63c-1569e00d023d",
  "detail-type": "GameLift Matchmaking Event",
  "source": "aws.gamelift",
  "account": "123456789012",
  "time": "2017-08-09T19:59:09.159Z",
  "region": "us-west-2",
  "resources": [
    "arn:aws:gamelift:us-west-2:123456789012:matchmakingconfiguration/SampleConfiguration"
  ],
  "detail": {
    "tickets": [
      {
        "ticketId": "ticket-1",
        "startTime": "2017-08-09T19:58:59.277Z",
        "players": [
          {
            "playerId": "player-1",
            "playerSessionId": "psess-6e7c13cf-10d6-4756-a53f-db7de782ed67",
            "team": "red"
          }
        ]
      },
      {
        "ticketId": "ticket-2",
        "startTime": "2017-08-09T19:59:08.663Z",
        "players": [
          {
            "playerId": "player-2",
            "playerSessionId": "psess-786b342f-9c94-44eb-bb9e-c1de46c472ce",
            "team": "blue"
          }
        ]
      }
    ],
    "type": "MatchmakingSucceeded",
    "gameSessionInfo": {
      "gameSessionArn": "arn:aws:gamelift:us-west-2:123456789012:gamesession/836cf48d-bcb0-4a2c-bec1-9c456541352a",
      "ipAddress": "192.168.1.1",
      "port": 10777,
      "playerGatewayStatus": "ENABLED",
      "computeName": "i-1234567890abcdef0",
      "gameSessionLocation": "us-west-2",
      "players": [
        {
          "playerId": "player-1",
          "playerSessionId": "psess-6e7c13cf-10d6-4756-a53f-db7de782ed67",
          "team": "red"
        },
        {
          "playerId": "player-2",
          "playerSessionId": "psess-786b342f-9c94-44eb-bb9e-c1de46c472ce",
          "team": "blue"
        }
      ]
    },
    "matchId": "c0ec1a54-7fec-4b55-8583-76d67adb7754"
  }
}
```

# MatchmakingTimedOut
<a name="match-events-matchmakingtimedout"></a>

Das Matchmaking-Ticket ist aufgrund einer Zeitüberschreitung fehlgeschlagen.

**Ressource:** ConfigurationArn

**Detail:** Typ, Tickets, Nachricht ruleEvaluationMetrics, MatchID, gameSessionInfo

## Beispiel
<a name="match-events-matchmakingtimedout-example"></a>

```
{
  "version": "0",
  "id": "fe528a7d-46ad-4bdc-96cb-b094b5f6bf56",
  "detail-type": "GameLift Matchmaking Event",
  "source": "aws.gamelift",
  "account": "123456789012",
  "time": "2017-08-09T20:11:35.598Z",
  "region": "us-west-2",
  "resources": [
    "arn:aws:gamelift:us-west-2:123456789012:matchmakingconfiguration/SampleConfiguration"
  ],
  "detail": {
    "reason": "TimedOut",
    "tickets": [
      {
        "ticketId": "ticket-1",
        "startTime": "2017-08-09T20:01:35.305Z",
        "players": [
          {
            "playerId": "player-1",
            "team": "red"
          }
        ]
      }
    ],
    "ruleEvaluationMetrics": [
      {
        "ruleName": "EvenSkill",
        "passedCount": 3,
        "failedCount": 0
      },
      {
        "ruleName": "EvenTeams",
        "passedCount": 3,
        "failedCount": 0
      },
      {
        "ruleName": "FastConnection",
        "passedCount": 3,
        "failedCount": 0
      },
      {
        "ruleName": "NoobSegregation",
        "passedCount": 3,
        "failedCount": 0
      }
    ],
    "type": "MatchmakingTimedOut",
    "message": "Removed from matchmaking due to timing out.",
    "gameSessionInfo": {
      "players": [
        {
          "playerId": "player-1",
          "team": "red"
        }
      ]
    }
  }
}
```

# MatchmakingCancelled
<a name="match-events-matchmakingcancelled"></a>

Das Matchmaking-Ticket wurde aufgrund eines StopMatchmaking API-Aufrufs storniert.

**Ressource:** ConfigurationArn

**Detail:** Typ, Tickets, Nachricht ruleEvaluationMetrics, MatchID, gameSessionInfo

## Beispiel
<a name="match-events-matchmakingcancelled-example"></a>

```
{
  "version": "0",
  "id": "8d6f84da-5e15-4741-8d5c-5ac99091c27f",
  "detail-type": "GameLift Matchmaking Event",
  "source": "aws.gamelift",
  "account": "123456789012",
  "time": "2017-08-09T20:00:07.843Z",
  "region": "us-west-2",
  "resources": [
    "arn:aws:gamelift:us-west-2:123456789012:matchmakingconfiguration/SampleConfiguration"
  ],
  "detail": {
    "reason": "Cancelled",
    "tickets": [
      {
        "ticketId": "ticket-1",
        "startTime": "2017-08-09T19:59:26.118Z",
        "players": [
          {
            "playerId": "player-1"
          }
        ]
      }
    ],
    "ruleEvaluationMetrics": [
      {
        "ruleName": "EvenSkill",
        "passedCount": 0,
        "failedCount": 0
      },
      {
        "ruleName": "EvenTeams",
        "passedCount": 0,
        "failedCount": 0
      },
      {
        "ruleName": "FastConnection",
        "passedCount": 0,
        "failedCount": 0
      },
      {
        "ruleName": "NoobSegregation",
        "passedCount": 0,
        "failedCount": 0
      }
    ],
    "type": "MatchmakingCancelled",
    "message": "Cancelled by request.",
    "gameSessionInfo": {
      "players": [
        {
          "playerId": "player-1"
        }
      ]
    }
  }
}
```

# MatchmakingFailed
<a name="match-events-matchmakingfailed"></a>

Für das Matchmaking-Ticket ist ein Fehler aufgetreten. Der Grund kann sein, dass die Spielsitzungswarteschlange nicht verfügbar ist, oder dass ein interner Fehler aufgetreten ist.

**Ressource:** ConfigurationArn

**Detail:** Typ, Tickets, Nachricht ruleEvaluationMetrics, MatchID, gameSessionInfo

## Beispiel
<a name="match-events-matchmakingfailed-example"></a>

```
{
  "version": "0",
  "id": "025b55a4-41ac-4cf4-89d1-f2b3c6fd8f9d",
  "detail-type": "GameLift Matchmaking Event",
  "source": "aws.gamelift",
  "account": "123456789012",
  "time": "2017-08-16T18:41:09.970Z",
  "region": "us-west-2",
  "resources": [
    "arn:aws:gamelift:us-west-2:123456789012:matchmakingconfiguration/SampleConfiguration"
  ],
  "detail": {
    "tickets": [
      {
        "ticketId": "ticket-1",
        "startTime": "2017-08-16T18:41:02.631Z",
        "players": [
          {
            "playerId": "player-1",
            "team": "red"
          }
        ]
      }
    ],
    "customEventData": "foo",
    "type": "MatchmakingFailed",
    "reason": "UNEXPECTED_ERROR",
    "message": "An unexpected error was encountered during match placing.",
    "gameSessionInfo": {
      "players": [
        {
          "playerId": "player-1",
          "team": "red"
        }
      ]
    },
    "matchId": "3ea83c13-218b-43a3-936e-135cc570cba7"
  }
}
```