Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Server SDK (Unreal) untuk Amazon GameLift Servers -- Tipe data
<a name="integration-server-sdk-unreal-ref-datatypes"></a>

Gunakan SDK Amazon GameLift Servers server untuk referensi Unreal untuk mengintegrasikan game multipemain Anda untuk hosting. Amazon GameLift Servers Untuk panduan tentang proses integrasi, lihat[Tambahkan Amazon GameLift Servers ke server game Anda dengan SDK server](gamelift-sdk-server-api.md).

**catatan**  
Referensi ini untuk versi SDK server yang lebih lama untukAmazon GameLift Servers. Untuk versi terbaru, lihat[Server C \$1\$1 (Tidak nyata) SDK 5.x untuk Amazon GameLift Servers -- Tipe data](integration-server-sdk5-unreal-datatypes.md).

API ini didefinisikan dalam `GameLiftServerSDK.h` dan `GameLiftServerSDKModels.h`.

Untuk menyiapkan plugin Unreal Engine dan melihat contoh kode [Integrasikan Amazon GameLift Servers ke dalam proyek Unreal Engine](integration-engines-setup-unreal.md).

[Server SDK (Tidak Nyata) untuk Amazon GameLift Servers -- Tindakan](integration-server-sdk-unreal-ref-actions.md)

**Topics**
+ [FDescribePlayerSessionsRequest](#integration-server-sdk-unreal-ref-dataypes-playersessions)
+ [FProcessParameter](#integration-server-sdk-unreal-ref-dataypes-process)
+ [FStartMatchBackfillRequest](#integration-server-sdk-unreal-ref-dataypes-startmatchbackfillrequest)
+ [FStopMatchBackfillRequest](#integration-server-sdk-unreal-ref-dataypes-stopmatchbackfillrequest)

## FDescribePlayerSessionsRequest
<a name="integration-server-sdk-unreal-ref-dataypes-playersessions"></a>

Jenis data ini digunakan untuk menentukan sesi pemain untuk diambil. Anda bisa menggunakannya sebagai berikut: 
+ Menyediakan PlayerSessionId untuk meminta sesi pemain tertentu.
+ Berikan permintaan GameSessionId untuk semua sesi pemain dalam sesi permainan yang ditentukan.
+ Berikan permintaan PlayerId untuk semua sesi pemain untuk pemain yang ditentukan.

Untuk koleksi sesi pemain yang besar, gunakan parameter pemberian nomor halaman untuk mengambil hasil dalam blok berurutan.

### Daftar Isi
<a name="integration-server-sdk-unreal-ref-dataypes-playersessions-contents"></a>

**GameSessionId**  
Pengidentifikasi sesi game yang unik. Gunakan parameter ini untuk meminta semua sesi pemain untuk sesi game yang ditentukan. Format ID sesi game adalah sebagai berikut: `arn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>`. Nilai <ID string> adalah string ID kustom atau (jika salah satu ditentukan saat sesi game dibuat) string yang dihasilkan.   
Tipe: String  
Wajib: Tidak

**Kuota**  
Jumlah hasil maksimum yang akan dikembalikan. Gunakan parameter ini dengan *NextToken*untuk mendapatkan hasil sebagai satu set halaman berurutan. Jika ID sesi pemain ditentukan, parameter ini diabaikan.  
Jenis: Integer  
Wajib: Tidak

**NextToken**  
Token yang menunjukkan awal dari halaman berurutan berikutnya dari hasil. Gunakan token yang dikembalikan dengan panggilan sebelumnya untuk tindakan ini. Untuk menentukan awal set hasil, jangan menentukan nilai. Jika ID sesi pemain ditentukan, parameter ini diabaikan.  
Tipe: String  
Wajib: Tidak

**PlayerId**  
Pengidentifikasi unik untuk pemain. Pemain IDs ditentukan oleh pengembang. Lihat [Hasilkan pemain IDs](player-sessions-player-identifiers.md).  
Tipe: String  
Wajib: Tidak

**PlayerSessionId**  
Pengidentifikasi unik untuk sesi pemain.  
Tipe: String  
Wajib: Tidak

**PlayerSessionStatusFilter**  
Status sesi pemain untuk mem-filter hasil. Kemungkinan status sesi pemain meliputi:  
+ RESERVED — Permintaan sesi pemain telah diterima, tetapi pemain belum terhubung ke proses server and/or telah divalidasi.
+ ACTIVE — Pemain telah divalidasi oleh proses server dan saat ini terhubung.
+ COMPLETED — Sambungan pemain telah terputus.
+ TIMEDOUT — Permintaan sesi pemain diterima, tetapi pemain tidak terhubung tidak and/or divalidasi dalam batas waktu habis (60 detik).
Tipe: String  
Wajib: Tidak

## FProcessParameter
<a name="integration-server-sdk-unreal-ref-dataypes-process"></a>

Tipe data ini berisi kumpulan parameter yang dikirim ke Amazon GameLift Servers layanan dalam [ProcessReady()](integration-server-sdk-unreal-ref-actions.md#integration-server-sdk-unreal-ref-processready) panggilan.

### Daftar Isi
<a name="integration-server-sdk-unreal-ref-dataypes-process-contents"></a>

**port**  
Nomor port yang akan didengarkan proses server untuk koneksi pemain baru. Nilai harus masuk ke dalam kisaran port yang dikonfigurasi untuk setiap armada yang men-deploy build server game ini. Nomor port ini termasuk dalam sesi game dan objek sesi pemain, yang digunakan sesi game saat menghubungkan ke proses server.   
Jenis: Integer   
Wajib: Ya

**logParameters**  
Obyek dengan daftar jalur direktori untuk file log sesi game.   
Jenis: TArray < FString >  
Wajib: Tidak

**onStartGameSesi**  
Nama fungsi callback yang dipanggil Amazon GameLift Servers layanan untuk mengaktifkan sesi permainan baru. Amazon GameLift Serversmemanggil fungsi ini sebagai tanggapan atas permintaan klien [CreateGameSession](https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreateGameSession.html). Fungsi callback mengambil [GameSession](https://docs.aws.amazon.com/gamelift/latest/apireference/API_GameSession.html)objek (didefinisikan dalam *Referensi API Amazon GameLift Servers Layanan*).   
Jenis: FOn StartGameSession   
Wajib: Ya

**onProcessTerminate**  
Nama fungsi callback yang dipanggil Amazon GameLift Servers layanan untuk memaksa proses server dimatikan. Setelah memanggil fungsi ini, Amazon GameLift Servers tunggu lima menit hingga proses server dimatikan dan merespons dengan [ProcessEnding()](integration-server-sdk-unreal-ref-actions.md#integration-server-sdk-unreal-ref-processending) panggilan sebelum mematikan proses server.  
Jenis: FSimple Delegasi  
Wajib: Tidak

**onHealthCheck**  
Nama fungsi callback yang dipanggil Amazon GameLift Servers layanan untuk meminta laporan status kesehatan dari proses server. Amazon GameLift Serversmemanggil fungsi ini setiap 60 detik. Setelah memanggil fungsi ini Amazon GameLift Servers menunggu 60 detik untuk respons, dan jika tidak ada yang diterima. mencatat proses server sebagai tidak sehat.  
Jenis: FOn HealthCheck  
Wajib: Tidak

**onUpdateGameSesi**  
Nama fungsi callback yang dipanggil Amazon GameLift Servers layanan untuk meneruskan objek sesi game yang diperbarui ke proses server. Amazon GameLift Serversmemanggil fungsi ini ketika permintaan [pengisian ulang kecocokan](https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-backfill.html) telah diproses untuk memberikan data mak comblang yang diperbarui. Ini melewati [GameSession](https://docs.aws.amazon.com/gamelift/latest/apireference/API_GameSession.html)objek, pembaruan status (`updateReason`), dan ID tiket isi ulang pertandingan.   
Jenis: FOn UpdateGameSession   
Wajib: Tidak

## FStartMatchBackfillRequest
<a name="integration-server-sdk-unreal-ref-dataypes-startmatchbackfillrequest"></a>

Jenis data ini digunakan untuk mengirim permintaan backfill matchmaking. Informasi dikomunikasikan ke Amazon GameLift Servers layanan dalam [StartMatchBackfill()](integration-server-sdk-unreal-ref-actions.md#integration-server-sdk-unreal-ref-startmatchbackfill) panggilan.

### Daftar Isi
<a name="integration-server-sdk-unreal-ref-dataypes-startbackfill-contents"></a>

**GameSessionArn**  
 Pengidentifikasi sesi game yang unik. Tindakan API [GetGameSessionId()](integration-server-sdk-unreal-ref-actions.md#integration-server-sdk-unreal-ref-getgamesessionid) mengembalikan pengidentifikasi dalam format ARN.  
Jenis: FString  
Wajib: Ya

**MatchmakingConfigurationArn**  
Pengidentifikasi unik, dalam bentuk ARN, yang akan digunakan matchmaker untuk permintaan ini. Untuk menemukan matchmaker yang digunakan untuk membuat sesi game asli, lihat di objek sesi game, di properti data matchmaker. Pelajari selengkapnya tentang data matchmaker di [ Bekerja dengan data matchmaker](https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-server.html#match-server-data).   
Jenis: FString  
Wajib: Ya

**Pemain**  
Satu set data yang mewakili semua pemain yang saat ini dalam sesi game. Matchmaker menggunakan informasi ini untuk mencari pemain baru yang cocok untuk pemain saat ini. Lihat *Panduan Referensi Amazon GameLift Servers API* untuk deskripsi format objek Player. Untuk menemukan atribut pemain IDs, dan tugas tim, lihat objek sesi permainan, di properti data mak comblang. Jika latensi digunakan oleh matchmaker, kumpulkan latensi yang diperbarui untuk wilayah saat ini dan sertakan dalam data masing-masing pemain.   
Jenis: TArray [< FPlayer >](https://docs.aws.amazon.com/gamelift/latest/apireference/API_Player.html)  
Wajib: Ya

**TicketId**  
Pengidentifikasi unik untuk tiket permintaan matchmaking atau backfill match. Jika tidak ada nilai yang diberikan di sini, Amazon GameLift Servers akan menghasilkan satu dalam bentuk UUID. Gunakan pengidentifikasi ini untuk melacak status tiket backfill match atau membatalkan permintaan jika diperlukan.   
Jenis: FString  
Wajib: Tidak

## FStopMatchBackfillRequest
<a name="integration-server-sdk-unreal-ref-dataypes-stopmatchbackfillrequest"></a>

Jenis data ini digunakan untuk membatalkan permintaan backfill matchmaking. Informasi dikomunikasikan ke Amazon GameLift Servers layanan dalam [StopMatchBackfill()](integration-server-sdk-unreal-ref-actions.md#integration-server-sdk-unreal-ref-stopmatchbackfill) panggilan.

### Daftar Isi
<a name="integration-server-sdk-unreal-ref-dataypes-stopbackfill-contents"></a>

**GameSessionArn**  
Pengidentifikasi sesi game unik yang terkait dengan permintaan yang dibatalkan.   
Jenis: FString  
Wajib: Ya

**MatchmakingConfigurationArn**  
Pengidentifikasi unik dari matchmaker sebagai tujuan pengiriman permintaan ini.   
Jenis: FString  
Wajib: Ya

**TicketId**  
Pengidentifikasi unik dari tiket backfill match yang akan dibatalkan.  
Jenis: FString  
Wajib: Ya