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

# Server SDK (Tidak Nyata) untuk Amazon GameLift Servers -- Tindakan
<a name="integration-server-sdk-unreal-ref-actions"></a>

Gunakan SDK server untuk 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 -- Tindakan Amazon GameLift Servers](integration-server-sdk5-unreal-actions.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 (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

[Server SDK (Unreal) untuk Amazon GameLift Servers -- Tipe data](integration-server-sdk-unreal-ref-datatypes.md)

**Topics**
+ [Server SDK (Unreal) untuk Amazon GameLift Servers -- Tipe data](integration-server-sdk-unreal-ref-datatypes.md)
+ [AcceptPlayerSession()](#integration-server-sdk-unreal-ref-acceptplayersession)
+ [ActivateGameSession()](#integration-server-sdk-unreal-ref-activategamesession)
+ [DescribePlayerSessions()](#integration-server-sdk-unreal-ref-describeplayersessions)
+ [GetGameSessionId()](#integration-server-sdk-unreal-ref-getgamesessionid)
+ [GetInstanceCertificate()](#integration-server-sdk-unreal-ref-getinstancecertificate)
+ [GetSdkVersion()](#integration-server-sdk-unreal-ref-getsdk)
+ [InitSDK()](#integration-server-sdk-unreal-ref-initsdk)
+ [ProcessEnding()](#integration-server-sdk-unreal-ref-processending)
+ [ProcessReady()](#integration-server-sdk-unreal-ref-processready)
+ [RemovePlayerSession()](#integration-server-sdk-unreal-ref-removeplayersession)
+ [StartMatchBackfill()](#integration-server-sdk-unreal-ref-startmatchbackfill)
+ [StopMatchBackfill()](#integration-server-sdk-unreal-ref-stopmatchbackfill)
+ [TerminateGameSession()](#integration-server-sdk-unreal-ref-terminategamesession)
+ [UpdatePlayerSessionCreationPolicy()](#integration-server-sdk-unreal-ref-updateplayersessioncreationpolicy)

## AcceptPlayerSession()
<a name="integration-server-sdk-unreal-ref-acceptplayersession"></a>

Memberitahu Amazon GameLift Servers layanan bahwa pemain dengan ID sesi pemain tertentu telah terhubung ke proses server dan perlu validasi. Amazon GameLift Serversmemverifikasi bahwa ID sesi pemain valid—yaitu, ID pemain telah memesan slot pemain dalam sesi permainan. Setelah divalidasi, Amazon GameLift Servers ubah status slot pemain dari RESERVED ke ACTIVE. 

### Sintaks
<a name="integration-server-sdk-unreal-ref-acceptplayersession-syntax"></a>

```
FGameLiftGenericOutcome AcceptPlayerSession(const FString& playerSessionId)
```

### Parameter
<a name="integration-server-sdk-unreal-ref-acceptplayersession-parameter"></a>

**playerSessionId**  
ID unik yang dikeluarkan oleh Amazon GameLift Servers layanan sebagai respons terhadap panggilan ke tindakan AWS [CreatePlayerSession](https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreatePlayerSession.html)SDK Amazon GameLift Servers API. Client game mereferensi ID ini saat menghubungkan ke proses server.  
Jenis: FString  
Wajib: Ya

### Nilai yang dikembalikan
<a name="integration-server-sdk-unreal-ref-acceptplayersession-return"></a>

Mengembalikan hasil generik yang terdiri dari keberhasilan atau kegagalan dalam sebuah pesan kesalahan. 

## ActivateGameSession()
<a name="integration-server-sdk-unreal-ref-activategamesession"></a>

Memberitahu Amazon GameLift Servers layanan bahwa proses server telah mengaktifkan sesi permainan dan sekarang siap menerima koneksi pemain. Tindakan ini harus dipanggil sebagai bagian dari fungsi callback `onStartGameSession()`, setelah semua inisialisasi sesi game selesai.

### Sintaks
<a name="integration-server-sdk-unreal-ref-activategamesession-syntax"></a>

```
FGameLiftGenericOutcome ActivateGameSession()
```

### Parameter
<a name="integration-server-sdk-unreal-ref-activategamesession-parameter"></a>

Tindakan ini tidak memiliki parameter.

### Nilai yang dikembalikan
<a name="integration-server-sdk-unreal-ref-activategamesession-return"></a>

Mengembalikan hasil generik yang terdiri dari keberhasilan atau kegagalan dalam sebuah pesan kesalahan.

## DescribePlayerSessions()
<a name="integration-server-sdk-unreal-ref-describeplayersessions"></a>

Mengambil data sesi pemain, termasuk pengaturan, metadata sesi, dan data pemain. Gunakan tindakan ini untuk mendapatkan informasi untuk satu sesi pemain, untuk semua sesi pemain dalam sesi game, atau untuk semua sesi pemain yang terkait dengan ID pemain tunggal.

### Sintaks
<a name="integration-server-sdk-unreal-ref-describeplayersessions-syntax"></a>

```
FGameLiftDescribePlayerSessionsOutcome DescribePlayerSessions(const FGameLiftDescribePlayerSessionsRequest &describePlayerSessionsRequest)
```

### Parameter
<a name="integration-server-sdk-unreal-ref-describeplayersessions-parameter"></a>

**describePlayerSessionsPermintaan**  
Sebuah objek [FDescribePlayerSessionsRequest](integration-server-sdk-unreal-ref-datatypes.md#integration-server-sdk-unreal-ref-dataypes-playersessions) yang menjelaskan sesi pemain mana yang diambil.  
Wajib: Ya

### Nilai yang dikembalikan
<a name="integration-server-sdk-unreal-ref-describeplayersessions-return"></a>

Jika berhasil, ini mengembalikan objek [FDescribePlayerSessionsRequest](integration-server-sdk-unreal-ref-datatypes.md#integration-server-sdk-unreal-ref-dataypes-playersessions) yang berisi satu set objek sesi pemain yang sesuai dengan parameter permintaan. Objek sesi pemain memiliki struktur yang identik dengan tipe [PlayerSession](https://docs.aws.amazon.com/gamelift/latest/apireference/API_PlayerSession.html)data AWS SDK Amazon GameLift Servers API.

## GetGameSessionId()
<a name="integration-server-sdk-unreal-ref-getgamesessionid"></a>

Mengambil ID dari sesi game yang saat ini sedang di-host oleh proses server, jika proses server aktif. 

### Sintaks
<a name="integration-server-sdk-unreal-ref-getgamesessionid-syntax"></a>

```
FGameLiftStringOutcome GetGameSessionId()
```

### Parameter
<a name="integration-server-sdk-unreal-ref-getgamesessionid-parameter"></a>

Tindakan ini tidak memiliki parameter.

### Nilai yang dikembalikan
<a name="integration-server-sdk-unreal-ref-getgamesessionid-return"></a>

Jika berhasil, ini mengembalikan ID sesi game sebagai objek `FGameLiftStringOutcome`. Jika tidak berhasil, ini mengembalikan pesan kesalahan.

## GetInstanceCertificate()
<a name="integration-server-sdk-unreal-ref-getinstancecertificate"></a>

Mengambil lokasi file sertifikat TLS yang dikodekan pem-encode yang terkait dengan armada dan instance-nya. AWS Certificate Manager menghasilkan sertifikat ini saat Anda membuat armada baru dengan konfigurasi sertifikat yang disetel ke GENERATED. Gunakan sertifikat ini untuk membuat koneksi yang aman dengan client game dan untuk mengenkripsi komunikasi client/server. 

### Sintaks
<a name="integration-server-sdk-unreal-ref-getinstancecertificate-syntax"></a>

```
FGameLiftGetInstanceCertificateOutcome GetInstanceCertificate()
```

### Parameter
<a name="integration-server-sdk-unreal-ref-getinstancecertificate-parameter"></a>

Tindakan ini tidak memiliki parameter.

### Nilai yang dikembalikan
<a name="integration-server-sdk-unreal-ref-getinstancecertificate-return"></a>

Jika berhasil, mengembalikan `GetInstanceCertificateOutcome` objek yang berisi lokasi file sertifikat TLS armada dan rantai sertifikat, yang disimpan pada instance. File sertifikat root, diekstrak dari rantai sertifikat, juga disimpan pada instance. Jika tidak berhasil, ini mengembalikan pesan kesalahan. 

Untuk informasi selengkapnya tentang sertifikat dan data rantai sertifikat, lihat [Elemen GetCertificate Respons](https://docs.aws.amazon.com/acm/latest/APIReference/API_GetCertificate.html#API_GetCertificate_ResponseElements) di Referensi AWS Certificate Manager API.

## GetSdkVersion()
<a name="integration-server-sdk-unreal-ref-getsdk"></a>

Mengembalikan nomor versi SDK saat ini yang dibangun ke dalam proses server.

### Sintaks
<a name="integration-server-sdk-unreal-ref-getsdk-syntax"></a>

```
FGameLiftStringOutcome GetSdkVersion();
```

### Parameter
<a name="integration-server-sdk-unreal-ref-getsdk-parameter"></a>

Tindakan ini tidak memiliki parameter.

### Nilai yang dikembalikan
<a name="integration-server-sdk-unreal-ref-getsdk-return"></a>

Jika berhasil, ini mengembalikan versi SDK saat ini sebagai objek `FGameLiftStringOutcome`. String yang dikembalikan mencakup nomor versi saja (mis. "3.1.5"). Jika tidak berhasil, ini mengembalikan pesan kesalahan.

### Contoh
<a name="integration-server-sdk-unreal-ref-getsdk-example"></a>

```
Aws::GameLift::AwsStringOutcome SdkVersionOutcome = 
    Aws::GameLift::Server::GetSdkVersion();
```

## InitSDK()
<a name="integration-server-sdk-unreal-ref-initsdk"></a>

Menginisialisasi Amazon GameLift Servers SDK. Metode ini harus dipanggil saat peluncuran, sebelum inisialisasi Amazon GameLift Servers terkait lainnya terjadi.

### Sintaks
<a name="integration-server-sdk-unreal-ref-initsdk-syntax"></a>

```
FGameLiftGenericOutcome InitSDK()
```

### Parameter
<a name="integration-server-sdk-unreal-ref-initsdk-parameter"></a>

Tindakan ini tidak memiliki parameter.

### Nilai yang dikembalikan
<a name="integration-server-sdk-unreal-ref-initsdk-return"></a>

Mengembalikan hasil generik yang terdiri dari keberhasilan atau kegagalan dalam sebuah pesan kesalahan.

## ProcessEnding()
<a name="integration-server-sdk-unreal-ref-processending"></a>

Memberitahu Amazon GameLift Servers layanan bahwa proses server dimatikan. Metode ini harus dipanggil setelah semua tugas pembersihan lainnya, termasuk mematikan semua sesi game aktif. Metode ini harus keluar dengan kode keluar 0; sebuah kode non-nol menghasilkan pesan kejadian bahwa proses tidak keluar dengan bersih.

### Sintaks
<a name="integration-server-sdk-unreal-ref-processending-syntax"></a>

```
FGameLiftGenericOutcome ProcessEnding()
```

### Parameter
<a name="integration-server-sdk-unreal-ref-processending-parameter"></a>

Tindakan ini tidak memiliki parameter.

### Nilai yang dikembalikan
<a name="integration-server-sdk-unreal-ref-processending-return"></a>

Mengembalikan hasil generik yang terdiri dari keberhasilan atau kegagalan dalam sebuah pesan kesalahan.

## ProcessReady()
<a name="integration-server-sdk-unreal-ref-processready"></a>

Memberitahu Amazon GameLift Servers layanan bahwa proses server siap untuk meng-host sesi permainan. Panggil metode ini setelah berhasil meminta [InitSDK()](#integration-server-sdk-unreal-ref-initsdk) dan menyelesaikan tugas penyiapan yang diperlukan sebelum proses server dapat menjadi host sesi game. Metode ini harus dipanggil hanya satu kali per proses.

### Sintaks
<a name="integration-server-sdk-unreal-ref-processready-syntax"></a>

```
FGameLiftGenericOutcome ProcessReady(FProcessParameters &processParameters)
```

### Parameter
<a name="integration-server-sdk-unreal-ref-processready-parameter"></a>

**FProcessParameter**  
Sebuah objek [FProcessParameter](integration-server-sdk-unreal-ref-datatypes.md#integration-server-sdk-unreal-ref-dataypes-process) yang mengomunikasikan informasi berikut tentang proses server:  
+ Nama metode callback, diimplementasikan dalam kode server game, yang dipanggil Amazon GameLift Servers layanan untuk berkomunikasi dengan proses server.
+ Nomor port yang didengarkan oleh proses server.
+ Jalur ke file khusus sesi game apa pun yang Amazon GameLift Servers ingin Anda tangkap dan simpan.
Wajib: Ya

### Nilai yang dikembalikan
<a name="integration-server-sdk-unreal-ref-processready-return"></a>

Mengembalikan hasil generik yang terdiri dari keberhasilan atau kegagalan dalam sebuah pesan kesalahan.

### Contoh
<a name="integration-server-sdk-unreal-ref-processready-example"></a>

Lihat kode sampel di [Menggunakan Plugin Unreal Engine](integration-engines-setup-unreal.md#integration-engines-setup-unreal-code).

## RemovePlayerSession()
<a name="integration-server-sdk-unreal-ref-removeplayersession"></a>

Memberi tahu Amazon GameLift Servers layanan bahwa pemain dengan ID sesi pemain yang ditentukan telah terputus dari proses server. Sebagai tanggapan, Amazon GameLift Servers mengubah slot pemain menjadi tersedia, yang memungkinkannya ditugaskan ke pemain baru. 

### Sintaks
<a name="integration-server-sdk-unreal-ref-removeplayersession-syntax"></a>

```
FGameLiftGenericOutcome RemovePlayerSession(const FString& playerSessionId)
```

### Parameter
<a name="integration-server-sdk-unreal-ref-removeplayersession-parameter"></a>

**playerSessionId**  
ID unik yang dikeluarkan oleh Amazon GameLift Servers layanan sebagai respons terhadap panggilan ke tindakan AWS [CreatePlayerSession](https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreatePlayerSession.html)SDK Amazon GameLift Servers API. Client game mereferensi ID ini saat menghubungkan ke proses server.  
Jenis: FString  
Wajib: Ya

### Nilai yang dikembalikan
<a name="integration-server-sdk-unreal-ref-removeplayersession-return"></a>

Mengembalikan hasil generik yang terdiri dari keberhasilan atau kegagalan dalam sebuah pesan kesalahan.

## StartMatchBackfill()
<a name="integration-server-sdk-unreal-ref-startmatchbackfill"></a>

Mengirim permintaan untuk menemukan pemain baru untuk slot terbuka dalam sesi permainan yang dibuat denganFlexMatch. Lihat juga aksi AWS SDK [StartMatchBackfill().](https://docs.aws.amazon.com/gamelift/latest/apireference/API_StartMatchBackfill.html) Dengan tindakan ini, permintaan backfill match dapat dimulai dengan proses server game yang menjadi host sesi game. Pelajari lebih lanjut tentang [fitur FlexMatch isi ulang](https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-backfill.html).

Tindakan ini asinkron. Jika pemain baru berhasil dicocokkan, Amazon GameLift Servers layanan akan mengirimkan data mak comblang yang diperbarui menggunakan fungsi panggilan balik. `OnUpdateGameSession()`

Proses server hanya dapat melakukan satu permintaan backfill match yang aktif dalam satu waktu. Untuk mengirim permintaan baru, panggil [StopMatchBackfill()](#integration-server-sdk-unreal-ref-stopmatchbackfill) terlebih dahulu untuk membatalkan permintaan asli.

### Sintaks
<a name="integration-server-sdk-unreal-ref-startmatchbackfill-syntax"></a>

```
FGameLiftStringOutcome StartMatchBackfill (FStartMatchBackfillRequest &startBackfillRequest);
```

### Parameter
<a name="integration-server-sdk-unreal-ref-startmatchbackfill-parameter"></a>

**FStartMatchBackfillRequest**  
Sebuah objek [FStartMatchBackfillRequest](integration-server-sdk-unreal-ref-datatypes.md#integration-server-sdk-unreal-ref-dataypes-startmatchbackfillrequest) yang mengkomunikasikan informasi berikut:  
+ ID tiket untuk ditetapkan ke permintaan backfill. Informasi ini opsional; jika tidak ada ID yang diberikan, Amazon GameLift Servers akan dibuat secara otomatis.
+ Matchmaker untuk dikirimi permintaan. ARN konfigurasi penuh diperlukan. Nilai ini dapat diperoleh dari data matchmaker sesi game.
+ ID dari sesi game yang sedang di-backfill.
+ Data matchmaking yang tersedia untuk pemain sesi game saat ini.
Wajib: Ya

### Nilai yang dikembalikan
<a name="integration-server-sdk-unreal-ref-startmatchbackfill-return"></a>

Jika berhasil, mengembalikan tiket backfill match sebagai objek `FGameLiftStringOutcome`. Jika tidak berhasil, ini mengembalikan pesan kesalahan. Status tiket dapat dilacak menggunakan tindakan AWS SDK [DescribeMatchmaking()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeMatchmaking.html).

## StopMatchBackfill()
<a name="integration-server-sdk-unreal-ref-stopmatchbackfill"></a>

Membatalkan permintaan backfill match aktif yang dibuat dengan [StartMatchBackfill()](#integration-server-sdk-unreal-ref-startmatchbackfill). Lihat juga aksi AWS SDK [StopMatchmaking().](https://docs.aws.amazon.com/gamelift/latest/apireference/API_StopMatchmaking.html) Pelajari lebih lanjut tentang [fitur FlexMatch isi ulang](https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-backfill.html).

### Sintaks
<a name="integration-server-sdk-unreal-ref-stopmatchbackfill-syntax"></a>

```
FGameLiftGenericOutcome StopMatchBackfill (FStopMatchBackfillRequest &stopBackfillRequest);
```

### Parameter
<a name="integration-server-sdk-unreal-ref-stopmatchbackfill-parameter"></a>

**StopMatchBackfillRequest**  
Sebuah objek [FStopMatchBackfillRequest](integration-server-sdk-unreal-ref-datatypes.md#integration-server-sdk-unreal-ref-dataypes-stopmatchbackfillrequest) yang mengidentifikasi tiket matchmaking untuk membatalkan:   
+ ID tiket yang ditetapkan ke permintaan backfill yang dibatalkan
+ matchmaker yang dikirimi permintaan backfill
+ sesi game yang terkait dengan permintaan backfill
Wajib: Ya

### Nilai yang dikembalikan
<a name="integration-server-sdk-unreal-ref-stopmatchbackfill-return"></a>

Mengembalikan hasil generik yang terdiri dari keberhasilan atau kegagalan dalam sebuah pesan kesalahan.

## TerminateGameSession()
<a name="integration-server-sdk-unreal-ref-terminategamesession"></a>

**Metode ini tidak lagi digunakan dengan versi 4.0.1. Sebaliknya, proses server harus memanggil [ProcessEnding()](#integration-server-sdk-unreal-ref-processending) setelah sesi permainan berakhir.**

Memberitahu Amazon GameLift Servers layanan bahwa proses server telah mengakhiri sesi permainan saat ini. Tindakan ini dipanggil ketika proses server akan tetap aktif dan siap untuk menjadi host sesi game baru. Ini harus dipanggil hanya setelah prosedur penghentian sesi permainan Anda selesai, karena ini menandakan Amazon GameLift Servers bahwa proses server segera tersedia untuk meng-host sesi permainan baru. 

Tindakan ini tidak dipanggil jika proses server akan dimatikan setelah sesi game berhenti. Sebagai gantinya, panggil [ProcessEnding()](#integration-server-sdk-unreal-ref-processending) untuk memberi tahu bahwa sesi game dan proses server akan berakhir. 

### Sintaks
<a name="integration-server-sdk-unreal-ref-terminategamesession-syntax"></a>

```
FGameLiftGenericOutcome TerminateGameSession()
```

### Parameter
<a name="integration-server-sdk-unreal-ref-terminategamesession-parameter"></a>

Tindakan ini tidak memiliki parameter.

### Nilai yang dikembalikan
<a name="integration-server-sdk-unreal-ref-terminategamesession-return"></a>

Mengembalikan hasil generik yang terdiri dari keberhasilan atau kegagalan dalam sebuah pesan kesalahan.

## UpdatePlayerSessionCreationPolicy()
<a name="integration-server-sdk-unreal-ref-updateplayersessioncreationpolicy"></a>

Memperbarui kemampuan sesi game saat ini untuk menerima sesi pemain baru. Sesi game dapat diatur untuk menerima atau menolak semua sesi pemain baru. (Lihat juga [https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateGameSession.html](https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateGameSession.html)tindakan di *Referensi API Amazon GameLift Servers Layanan*).

### Sintaks
<a name="integration-server-sdk-unreal-ref-updateplayersessioncreationpolicy-syntax"></a>

```
FGameLiftGenericOutcome UpdatePlayerSessionCreationPolicy(EPlayerSessionCreationPolicy policy)
```

### Parameter
<a name="integration-server-sdk-unreal-ref-updateplayersessioncreationpolicy-parameter"></a>

**Kebijakan**  
Nilai yang menunjukkan apakah sesi game menerima pemain baru.   
Jenis: Enum `EPlayerSessionCreationPolicy`. Nilai yang valid meliputi:  
+ **ACCEPT\$1ALL** — Menerima semua sesi pemain baru.
+ **DENY\$1ALL** — Menolak semua sesi pemain baru.
Wajib: Ya

### Nilai yang dikembalikan
<a name="integration-server-sdk-unreal-ref-updateplayersessioncreationpolicy-return"></a>

Mengembalikan hasil generik yang terdiri dari keberhasilan atau kegagalan dalam sebuah pesan kesalahan.