Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Acara penempatan sesi permainan
Amazon GameLift Serversmemancarkan acara untuk setiap permintaan penempatan sesi game saat diproses. Anda dapat memublikasikan peristiwa ini ke topik Amazon SNS, seperti yang dideskripsikan dalam [Atur notifikasi kejadian untuk penempatan sesi game](queue-notification.md). Peristiwa ini juga dipancarkan ke Amazon CloudWatch Events dalam waktu dekat dan dengan upaya terbaik.
Topik ini menjelaskan struktur peristiwa penempatan sesi game dan memberikan contoh untuk setiap jenis peristiwa. Untuk informasi selengkapnya tentang status permintaan penempatan sesi game, lihat [GameSessionPlacement](https://docs.aws.amazon.com/gamelift/latest/apireference/API_GameSessionPlacement.html)di *Referensi Amazon GameLift Servers API*.
## Sintaksis peristiwa penempatan
Peristiwa direpresentasikan sebagai objek JSON. Struktur acara sesuai dengan pola CloudWatch Peristiwa, dengan bidang tingkat atas yang serupa dan detail khusus layanan.
Bidang tingkat atas mencakup hal-hal berikut (lihat [Pola peristiwa](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html) untuk lebih detailnya):
versi
Bidang ini selalu diatur ke 0 (nol).
id
Pengenal pelacakan unik untuk peristiwa tersebut.
jenis-detail
Nilainya selalu `GameLift Queue Placement Event`.
sumber
Nilainya selalu `aws.gamelift`.
akun
AWS Akun yang digunakan untuk mengelolaAmazon GameLift Servers.
Waktu
Stempel waktu peristiwa.
region
AWS Wilayah tempat permintaan penempatan sedang diproses. Ini adalah Wilayah di mana antrean sesi game digunakan berada.
sumber daya
Nilai ARN dari antrean sesi game yang memproses permintaan penempatan.
## PlacementFulfilled
Permintaan penempatan telah berhasil dipenuhi. Sesi game baru telah dimulai dan sesi pemain baru telah dibuat untuk setiap pemain yang tercantum dalam permintaan penempatan sesi game. Informasi koneksi pemain tersedia.
**Detail sintaks:**
placementId
Pengidentifikasi unik yang ditetapkan untuk permintaan penempatan sesi game.
Port
Nomor port untuk sesi game baru.
gameSessionArn
Pengenal ARN untuk sesi game baru.
ipAddress
Alamat IP dari sesi game.
dnsName
Pengenal DNS yang ditetapkan untuk instans yang menjalankan sesi game baru. Format nilai berbeda tergantung pada apakah instans yang menjalankan sesi game diaktifkan TLS. Saat menghubungkan ke sesi game di armada yang mendukung TLS, pemain harus menggunakan nama DNS, bukan alamat IP.
Armada yang mendukung TLS:`..amazongamelift.com`.
Non-TLS-enabled armada:`ec2-.compute.amazonaws.com`.
startTime
Stempel waktu menunjukkan kapan permintaan ini ditempatkan dalam antrean.
endTime
Stempel waktu menunjukkan kapan permintaan ini terpenuhi.
gameSessionRegion
AWS Wilayah asal armada yang menjadi tuan rumah sesi permainan.
gameSessionLocation
Lokasi armada tempat sesi permainan berjalan. Nilai ini mungkin menentukan wilayah asal armada atau lokasi terpencil.
playerGatewayStatus
Keadaan gateway pemain di lokasi armada yang menjalankan sesi permainan ini.
Nilai yang mungkin termasuk:
+ `ENABLED`— Gateway pemain tersedia untuk merutekan koneksi pemain untuk sesi permainan ini.
+ `DISABLED`— Gateway pemain tidak tersedia untuk sesi permainan ini.
CompuTename
Label deskriptif untuk sumber daya komputasi yang menjadi tuan rumah sesi permainan. Untuk armada EC2, ini adalah ID instans EC2. Untuk armada Container, setiap grup kontainer server game pada instance armada diberi nama komputasi. Untuk armada Anywhere, ini adalah nama komputasi khusus.
placedPlayerSessions
Kumpulan sesi pemain yang telah dibuat untuk setiap pemain dalam permintaan penempatan sesi game.
### Contoh
```
{
"version": "0",
"id": "1111aaaa-bb22-cc33-dd44-5555eeee66ff",
"detail-type": "GameLift Queue Placement Event",
"source": "aws.gamelift",
"account": "123456789012",
"time": "2021-03-01T15:50:52Z",
"region": "us-east-1",
"resources": [
"arn:aws:gamelift:us-west-2:123456789012:gamesessionqueue/MegaFrogRace-NA"
],
"detail": {
"type": "PlacementFulfilled",
"placementId": "9999ffff-88ee-77dd-66cc-5555bb44aa",
"port": "6262",
"gameSessionArn": "arn:aws:gamelift:us-west-2::gamesession/fleet-2222bbbb-33cc-44dd-55ee-6666ffff77aa/us-east-1/4444dddd-55ee-66ff-77aa-8888bbbb99cc",
"ipAddress": "98.987.98.987",
"dnsName": "ec2-12-345-67-890.us-west-2.compute.amazonaws.com",
"startTime": "2021-03-01T15:50:49.741Z",
"endTime": "2021-03-01T15:50:52.084Z",
"gameSessionRegion": "us-west-2",
"playerGatewayStatus": "ENABLED",
"gameSessionLocation": "us-east-1",
"computeName": "i-1234567890abcdef0",
"placedPlayerSessions": [
{
"playerId": "player-1"
"playerSessionId": "psess-1232131232324124123123"
}
]
}
}
```
## PlacementCancelled
Permintaan penempatan dibatalkan dengan panggilan ke GameLift layanan [StopGameSessionPlacement](https://docs.aws.amazon.com/gamelift/latest/apireference/API_StopGameSessionPlacement.html).
**Detail:**
placementId
Pengenal unik yang ditetapkan untuk permintaan penempatan sesi game.
startTime
Stempel waktu menunjukkan kapan permintaan ini ditempatkan dalam antrean.
endTime
Stempel waktu menunjukkan kapan permintaan ini dibatalkan.
### Contoh
```
{
"version": "0",
"id": "1111aaaa-bb22-cc33-dd44-5555eeee66ff",
"detail-type": "GameLift Queue Placement Event",
"source": "aws.gamelift",
"account": "123456789012",
"time": "2021-03-01T15:50:52Z",
"region": "us-east-1",
"resources": [
"arn:aws:gamelift:us-west-2:123456789012:gamesessionqueue/MegaFrogRace-NA"
],
"detail": {
"type": "PlacementCancelled",
"placementId": "9999ffff-88ee-77dd-66cc-5555bb44aa",
"startTime": "2021-03-01T15:50:49.741Z",
"endTime": "2021-03-01T15:50:52.084Z"
}
}
```
## PlacementTimedOut
Penempatan sesi game tidak berhasil diselesaikan sebelum batas waktu antrean berakhir. Permintaan penempatan dapat dikirim ulang sesuai kebutuhan.
**Detail:**
placementId
Pengenal unik yang ditetapkan untuk permintaan penempatan sesi game.
startTime
Stempel waktu menunjukkan kapan permintaan ini ditempatkan dalam antrean.
endTime
Stempel waktu menunjukkan kapan permintaan ini dibatalkan.
### Contoh
```
{
"version": "0",
"id": "1111aaaa-bb22-cc33-dd44-5555eeee66ff",
"detail-type": "GameLift Queue Placement Event",
"source": "aws.gamelift",
"account": "123456789012",
"time": "2021-03-01T15:50:52Z",
"region": "us-east-1",
"resources": [
"arn:aws:gamelift:us-west-2:123456789012:gamesessionqueue/MegaFrogRace-NA"
],
"detail": {
"type": "PlacementTimedOut",
"placementId": "9999ffff-88ee-77dd-66cc-5555bb44aa",
"startTime": "2021-03-01T15:50:49.741Z",
"endTime": "2021-03-01T15:50:52.084Z"
}
}
```
## PlacementFailed
Amazon GameLift Serverstidak dapat memenuhi permintaan sesi permainan. Hal ini umumnya disebabkan oleh kesalahan internal yang tidak terduga. Permintaan penempatan dapat dikirim ulang sesuai kebutuhan.
**Detail:**
placementId
Pengenal unik yang ditetapkan untuk permintaan penempatan sesi game.
startTime
Stempel waktu menunjukkan kapan permintaan ini ditempatkan dalam antrean.
endTime
Stempel waktu menunjukkan ketika permintaan ini gagal.
### Contoh
```
{
"version": "0",
"id": "39c978f3-ba46-3f7c-e787-55bfcca1bd31",
"detail-type": "GameLift Queue Placement Event",
"source": "aws.gamelift",
"account": "252386620677",
"time": "2021-03-01T15:50:52Z",
"region": "us-east-1",
"resources": [
"arn:aws:gamelift:us-west-2:252386620677:gamesessionqueue/MegaFrogRace-NA"
],
"detail": {
"type": "PlacementFailed",
"placementId": "e4a1119a-39af-45cf-a990-ef150fe0d453",
"startTime": "2021-03-01T15:50:49.741Z",
"endTime": "2021-03-01T15:50:52.084Z"
}
}
```