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.
Top-level bidang termasuk yang berikut (lihat [pola acara](https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/CloudWatchEventsandEventPatterns.html) untuk detail lebih lanjut):
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 acara dalam format ISO 8601.
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.
permainan SessionArn
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 instance yang menjalankan sesi game TLS-enabled. Saat menghubungkan ke sesi permainan di TLS-enabled armada, pemain harus menggunakan nama DNS, bukan alamat IP.
TLS-enabled armada:`..amazongamelift.com`.
Non-TLS-enabled armada:`ec2-.compute.amazonaws.com`.
startTime
Cap waktu yang menunjukkan kapan permintaan ini ditempatkan dalam antrian, dalam format ISO 8601.
endTime
Cap waktu yang menunjukkan kapan permintaan ini dipenuhi, dalam format ISO 8601.
permainan SessionRegion
AWS Wilayah asal armada yang menjadi tuan rumah sesi permainan.
permainan SessionLocation
Lokasi armada tempat sesi permainan berjalan. Nilai ini mungkin menentukan wilayah asal armada atau lokasi terpencil.
pemain GatewayStatus
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.
ditempatkan PlayerSessions
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
Cap waktu yang menunjukkan kapan permintaan ini ditempatkan dalam antrian, dalam format ISO 8601.
endTime
Cap waktu yang menunjukkan kapan permintaan ini dibatalkan, dalam format ISO 8601.
### 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
Cap waktu yang menunjukkan kapan permintaan ini ditempatkan dalam antrian, dalam format ISO 8601.
endTime
Cap waktu yang menunjukkan kapan permintaan ini dibatalkan, dalam format ISO 8601.
### 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
Cap waktu yang menunjukkan kapan permintaan ini ditempatkan dalam antrian, dalam format ISO 8601.
endTime
Cap waktu yang menunjukkan kapan permintaan ini gagal, dalam format ISO 8601.
### 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"
}
}
```