

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

# Server C \$1\$1 (Tidak nyata) SDK 5.x untuk -- Tindakan Amazon GameLift Servers
<a name="integration-server-sdk5-unreal-actions"></a>

Gunakan referensi Amazon GameLift Servers Unreal server SDK 5.x untuk membantu Anda mempersiapkan game multipemain untuk digunakan. Amazon GameLift Servers Untuk detail tentang proses integrasi, lihat[Tambahkan Amazon GameLift Servers ke server game Anda dengan SDK server](gamelift-sdk-server-api.md). Jika Anda menggunakan Amazon GameLift Servers plugin untuk Unreal, lihat juga[Amazon GameLift Serversplugin untuk Unreal Engine](unreal-plugin.md).

**catatan**  
Topik ini menjelaskan Amazon GameLift Servers C\$1\$1 API yang dapat Anda gunakan saat membuat Unreal Engine. Secara khusus, dokumentasi ini berlaku untuk kode yang Anda kompilasi dengan `-DBUILD_FOR_UNREAL=1` opsi. 

# Server C \$1\$1 (Tidak nyata) SDK 5.x untuk Amazon GameLift Servers -- Tipe data
<a name="integration-server-sdk5-unreal-datatypes"></a>

Gunakan referensi Amazon GameLift Servers Unreal server SDK 5.x untuk membantu Anda mempersiapkan game multipemain untuk digunakan. Amazon GameLift Servers Untuk detail tentang proses integrasi, lihat[Tambahkan Amazon GameLift Servers ke server game Anda dengan SDK server](gamelift-sdk-server-api.md). Jika Anda menggunakan Amazon GameLift Servers plugin untuk Unreal, lihat juga[Amazon GameLift Serversplugin untuk Unreal Engine](unreal-plugin.md).

**catatan**  
Topik ini menjelaskan Amazon GameLift Servers C\$1\$1 API yang dapat Anda gunakan saat membuat Unreal Engine. Secara khusus, dokumentasi ini berlaku untuk kode yang Anda kompilasi dengan `-DBUILD_FOR_UNREAL=1` opsi. 

[Server C \$1\$1 (Tidak nyata) SDK 5.x untuk -- Tindakan Amazon GameLift Servers](integration-server-sdk5-unreal-actions.md)

**Topics**
+ [FProcessParameter](#integration-server-sdk5-unreal-dataypes-process)
+ [UpdateGameSession](#integration-server-sdk5-unreal-dataypes-updategamesession)
+ [GameSession](#integration-server-sdk5-unreal-dataypes-gamesession)
+ [FServerParameter](#integration-server-sdk5-unreal-dataypes-serverparameters)
+ [FStartMatchBackfillRequest](#integration-server-sdk5-unreal-dataypes-startmatchbackfillrequest)
+ [FPlayer](#integration-server-sdk5-unreal-dataypes-player)
+ [FGameLiftDescribePlayerSessionsRequest](#integration-server-sdk5-unreal-dataypes-playersessions)
+ [FStopMatchBackfillRequest](#integration-server-sdk5-unreal-dataypes-stopmatchbackfillrequest)
+ [FAttributeNilai](#integration-server-sdk5-unreal-dataypes-attributevalue)
+ [FGameLiftGetFleetRoleCredentialsRequest](#integration-server-sdk5-unreal-dataypes-getfleetrolecredentialsrequest)
+ [FGameLiftLongOutcome](#integration-server-sdk5-unreal-dataypes-awslongoutcome)
+ [FGameLiftStringOutcome](#integration-server-sdk5-unreal-dataypes-awsstringoutcome)
+ [FGameLiftDescribePlayerSessionsOutcome](#integration-server-sdk5-unreal-dataypes-describeplayersessionsoutcome)
+ [FGameLiftDescribePlayerSessionsResult](#integration-server-sdk5-unreal-dataypes-describeplayersessionresult)
+ [FGenericHasil](#integration-server-sdk5-unreal-dataypes-genericoutcome)
+ [FGameLiftPlayerSession](#integration-server-sdk5-unreal-dataypes-playersession)
+ [FGameLiftGetComputeCertificateOutcome](#integration-server-sdk5-unreal-dataypes-getcomputecertificateoutcome)
+ [FGameLiftGetComputeCertificateResult](#integration-server-sdk5-unreal-dataypes-getcomputecertificateresult)
+ [FGameLiftGetFleetRoleCredentialsOutcome](#integration-server-sdk5-unreal-dataypes-getfleetrolecredentialsoutcome)
+ [FGetFleetRoleCredentialsResult](#integration-server-sdk5-unreal-dataypes-getfleetrolecredentialsresult)
+ [FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror)
+ [Enum](#integration-server-sdk5-unreal-dataypes-enums)

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

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


|  |  | 
| --- |--- |
|  **Sifat-sifat**  | Deskripsi | 
| LogParameters | Objek dengan jalur direktori ke file yang dihasilkan selama sesi permainan. Amazon GameLift Serversmenyalin dan menyimpan file untuk akses future.**Jenis**: `TArray<FString>`**Wajib**: Tidak | 
| OnHealthCheck | Fungsi callback yang Amazon GameLift Servers memanggil untuk meminta laporan status kesehatan dari proses server. Amazon GameLift Serversmemanggil fungsi ini setiap 60 detik dan menunggu 60 detik untuk respons. Proses server kembali TRUE jika sehat, FALSE jika tidak sehat. Jika tidak ada respons yang dikembalikan, Amazon GameLift Servers mencatat proses server sebagai tidak sehat. Properti ini adalah fungsi delegasi yang didefinisikan sebagai`DECLARE_DELEGATE_RetVal(bool, FOnHealthCheck)`;   **Jenis**: `FOnHealthCheck`**Wajib**: Tidak | 
| OnProcessTerminate | Fungsi callback yang Amazon GameLift Servers memanggil untuk memaksa proses server dimatikan. Setelah memanggil fungsi ini, Amazon GameLift Servers tunggu 5 menit hingga proses server dimatikan dan merespons dengan [ProcessEnding()](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-processending) panggilan sebelum mematikan proses server.**Jenis**: `FSimpleDelegate`**Wajib**: Ya | 
| OnStartGameSession | Fungsi callback yang Amazon GameLift Servers memanggil untuk mengaktifkan sesi permainan baru. Amazon GameLift Serversmemanggil fungsi ini sebagai tanggapan atas permintaan klien [CreateGameSession](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_CreateGameSession.html). Fungsi callback melewati [GameSession](#integration-server-sdk5-unreal-dataypes-gamesession) objek. Properti ini adalah fungsi delegasi didefinisikan sebagai `DECLARE_DELEGATE_OneParam(FOnStartGameSession, Aws::GameLift::Server::Model::GameSession);`  **Jenis**: `FOnStartGameSession`**Wajib**: Ya | 
| OnUpdateGameSession | Fungsi callback yang Amazon GameLift Servers memanggil untuk meneruskan objek sesi game yang diperbarui ke proses server. Amazon GameLift Serversmemanggil fungsi ini ketika permintaan pengisian ulang kecocokan telah diproses untuk menyediakan data mak comblang yang diperbarui. Ini melewati [GameSession](#integration-server-sdk5-unreal-dataypes-gamesession) objek, pembaruan status (updateReason), dan ID tiket isi ulang pertandingan. Properti ini adalah fungsi delegasi didefinisikan sebagai `DECLARE_DELEGATE_OneParam(FOnUpdateGameSession, Aws::GameLift::Server::Model::UpdateGameSession);` **Jenis**: `FOnUpdateGameSession`**Wajib**: Tidak | 
| Port | Nomor port yang didengarkan oleh 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**: `int`**Wajib**: Ya | 

## UpdateGameSession
<a name="integration-server-sdk5-unreal-dataypes-updategamesession"></a>

Jenis data ini diperbarui ke objek sesi permainan, yang mencakup alasan bahwa sesi permainan diperbarui dan ID tiket isi ulang terkait jika pengisian ulang digunakan untuk mengisi sesi pemain dalam sesi permainan.


| Sifat-sifat | **Deskripsi** | 
| --- | --- | 
| GameSession | Sebuah objek [GameSession](#integration-server-sdk5-unreal-dataypes-gamesession). GameSessionObjek berisi properti yang menggambarkan sesi permainan. **Jenis**: `Aws::GameLift::Server::GameSession`**Wajib**: Tidak | 
| UpdateReason | Alasan bahwa sesi permainan sedang diperbarui. **Jenis**: `enum class UpdateReason`  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/gameliftservers/latest/developerguide/integration-server-sdk5-unreal-datatypes.html) **Wajib**: Tidak   | 
| BackfillTicketId | ID tiket isi ulang yang mencoba memperbarui sesi permainan.**Jenis**: `char[]`**Wajib**: Tidak | 

## GameSession
<a name="integration-server-sdk5-unreal-dataypes-gamesession"></a>

Tipe data ini memberikan detail sesi permainan. 


| Sifat-sifat | **Deskripsi** | 
| --- | --- | 
| GameSessionId |  Pengenal unik untuk sesi permainan. Sesi permainan ARN memiliki format berikut:. `arn:aws:gamelift:<region>::gamesession/<fleet ID>/<custom ID string or idempotency token>` **Jenis**: `char[]` **Wajib**: Tidak  | 
| Nama |  Label deskriptif dari sesi permainan.  **Jenis**: `char[]` **Wajib**: Tidak  | 
| FleetId |  Pengenal unik untuk armada tempat sesi permainan berjalan. **Jenis**: `char[]` **Wajib**: Tidak  | 
| MaximumPlayerSessionCount |  Jumlah maksimum koneksi pemain ke sesi permainan. **Jenis**: `int` **Wajib**: Tidak  | 
| Port |  Nomor port untuk sesi permainan. Untuk terhubung ke server Amazon GameLift Servers game, aplikasi memerlukan alamat IP dan nomor port. **Jenis**: `int` **Wajib**: Tidak  | 
| IpAddress |  Alamat IP dari sesi game. Untuk terhubung ke server Amazon GameLift Servers game, aplikasi memerlukan alamat IP dan nomor port. **Jenis**: `char[]` **Wajib**: Tidak  | 
| GameSessionData |  Set properti sesi game khusus, diformat sebagai nilai string tunggal.  **Jenis**: `char[]` **Wajib**: Tidak  | 
| MatchmakerData |  Informasi tentang proses perjodohan yang digunakan untuk membuat sesi permainan, dalam sintaks JSON, diformat sebagai string. Selain konfigurasi perjodohan yang digunakan, ini berisi data tentang semua pemain yang ditugaskan untuk pertandingan, termasuk atribut pemain dan tugas tim. **Jenis**: `char[]` **Wajib**: Tidak  | 
| GameProperties |  Satu set properti kustom untuk sesi permainan, diformat sebagai pasangan key:value. Properti ini diteruskan dengan permintaan untuk memulai sesi permainan baru. **Jenis**: `GameProperty[]` **Wajib**: Tidak  | 
| DnsName |  Pengenal DNS yang ditetapkan ke instance yang menjalankan sesi permainan. Nilai memiliki format berikut: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/gameliftservers/latest/developerguide/integration-server-sdk5-unreal-datatypes.html) Saat menghubungkan ke sesi permainan yang berjalan pada armada yang mendukung TLS, Anda harus menggunakan nama DNS, bukan alamat IP. **Jenis**: `char[]` **Wajib**: Tidak  | 

## FServerParameter
<a name="integration-server-sdk5-unreal-dataypes-serverparameters"></a>

Informasi yang digunakan untuk menjaga koneksi antara server Amazon GameLift Servers Anywhere dan Amazon GameLift Servers layanan. Informasi ini digunakan saat meluncurkan proses server baru dengan[InitSDK()](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-initsdk). Untuk server yang Amazon GameLift Servers dihosting pada instans EC2 terkelola, gunakan objek kosong.


| Sifat-sifat | **Deskripsi** | 
| --- | --- | 
| webSocketUrl |  `GameLiftServerSdkEndpoint`Amazon GameLift ServersPengembalian ketika Anda [https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html)untuk sumber daya komputasi Amazon GameLift Servers Anywhere. **Jenis**: `char[]` **Wajib**: Ya   | 
| ProsesSid |  Pengenal unik yang terdaftar pada proses server yang menghosting game Anda. **Jenis**: `char[]` **Wajib**: Ya  | 
| hostId | HostIDIni adalah yang ComputeName digunakan saat Anda mendaftarkan komputasi Anda. Untuk informasi selengkapnya, lihat [RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html).**Jenis**: `char[]`**Wajib**: Ya | 
| FleeTID | Pengidentifikasi unik armada tempat komputasi terdaftar. Untuk informasi selengkapnya, lihat [RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html).**Jenis**: `char[]`**Wajib**: Ya | 
| AuthToken | Token otentikasi yang dihasilkan oleh Amazon GameLift Servers itu mengotentikasi server Anda ke. Amazon GameLift Servers Untuk informasi selengkapnya, lihat [GetComputeAuthToken](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_GetComputeAuthToken.html).**Jenis**: `char[]`**Wajib**: Ya | 

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

Informasi yang digunakan untuk membuat permintaan pengisian ulang perjodohan. Server game mengkomunikasikan informasi ini ke Amazon GameLift Servers dalam [StartMatchBackfill()](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-startmatchbackfill) panggilan.


| Sifat-sifat | **Deskripsi** | 
| --- | --- | 
| GameSessionArn |  Pengidentifikasi sesi permainan yang unik. Operasi API `[GetGameSessionId](https://docs.aws.amazon.com/gameliftservers/latest/developerguide/integration-server-sdk5-unreal-actions.html#integration-server-sdk5-unreal-getgamesessionid)` mengembalikan pengenal dalam format ARN. **Jenis**: `char[]` **Wajib**: Ya  | 
| MatchmakingConfigurationArn |  Pengidentifikasi unik, dalam bentuk ARN, untuk digunakan mak comblang untuk permintaan ini. ARN mak comblang untuk sesi permainan asli ada di objek sesi permainan di properti data mak comblang. Pelajari selengkapnya tentang data matchmaker di [ Bekerja dengan data matchmaker](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-server.html#match-server-data.html). **Jenis**: `char[]` **Wajib**: Ya  | 
| Pemain |  Satu set data yang mewakili semua pemain yang berada di sesi permainan. Matchmaker menggunakan informasi ini untuk mencari pemain baru yang cocok untuk pemain saat ini. **Jenis**: `TArray<FPlayer>` **Wajib**: Ya  | 
| TicketId |  Pengenal unik untuk tiket permintaan pencocokan atau pencocokan isi ulang. Jika Anda tidak memberikan nilai, Amazon GameLift Servers hasilkan satu. Gunakan pengidentifikasi ini untuk melacak status tiket backfill match atau membatalkan permintaan jika diperlukan.  **Jenis**: `char[]` **Wajib**: Tidak  | 

## FPlayer
<a name="integration-server-sdk5-unreal-dataypes-player"></a>

Tipe data ini mewakili pemain dalam perjodohan. Saat memulai permintaan perjodohan, pemain memiliki ID pemain, atribut, dan mungkin data latensi. Amazon GameLift Serversmenambahkan informasi tim setelah pertandingan dibuat.


| Sifat-sifat | **Deskripsi** | 
| --- | --- | 
| LatencyInMS |  Satu set nilai yang dinyatakan dalam milidetik yang menunjukkan jumlah latensi yang dialami pemain saat terhubung ke suatu lokasi.  Jika properti ini digunakan, pemain hanya cocok untuk lokasi yang terdaftar. Jika mak comblang memiliki aturan yang mengevaluasi latensi pemain, pemain harus melaporkan latensi untuk dicocokkan. **Jenis**: `TMap>FString, int32<` **Wajib**: Tidak  | 
| PlayerAttributes |  Kumpulan pasangan kunci:nilai yang berisi informasi pemain untuk digunakan dalam perjodohan. Kunci atribut pemain harus cocok dengan yang PlayerAttributes digunakan dalam set aturan perjodohan. Untuk informasi selengkapnya tentang atribut pemain, lihat [AttributeValue](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_AttributeValue.html). **Jenis**: `TMap>FString, FAttributeValue<` **Wajib**: Tidak  | 
| PlayerId |  Pengenal unik untuk pemain. **Jenis**: `std::string` **Wajib**: Tidak  | 
| Tim |  Nama tim yang ditugaskan pemain dalam pertandingan. Anda menentukan nama tim dalam set aturan perjodohan. **Jenis**: `FString` **Wajib**: Tidak  | 

## FGameLiftDescribePlayerSessionsRequest
<a name="integration-server-sdk5-unreal-dataypes-playersessions"></a>

Objek yang menentukan sesi pemain mana yang akan diambil. Proses server menyediakan informasi ini dengan [DescribePlayerSessions()](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-describeplayersessions) panggilan keAmazon GameLift Servers.


| Sifat-sifat | **Deskripsi** | 
| --- | --- | 
| GameSessionId |  Pengidentifikasi sesi permainan yang unik. Gunakan parameter ini untuk meminta semua sesi pemain untuk sesi game yang ditentukan.  Format ID sesi game adalah`FString`. `GameSessionID`Ini adalah string ID kustom atau **Jenis**: `std::string` **Wajib**: Tidak  | 
| PlayerSessionId |  Pengenal unik untuk sesi pemain. Gunakan parameter ini untuk meminta satu sesi pemain tertentu. **Jenis**: `FString` **Wajib**: Tidak  | 
| PlayerId |  Pengenal unik untuk pemain. Gunakan parameter ini untuk meminta semua sesi pemain untuk pemain tertentu. Lihat [Hasilkan pemain IDs](player-sessions-player-identifiers.md). **Jenis**: `FString` **Wajib**: Tidak  | 
| PlayerSessionStatusFilter |  Status sesi pemain untuk memfilter hasil. Status sesi pemain yang mungkin meliputi: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/gameliftservers/latest/developerguide/integration-server-sdk5-unreal-datatypes.html) **Jenis**: `FString` **Wajib**: Tidak  | 
| NextToken |  Token yang menunjukkan awal halaman hasil berikutnya. Untuk menentukan awal kumpulan hasil, jangan berikan nilai. Jika Anda memberikan ID sesi pemain, parameter ini diabaikan. **Jenis**: `FString` **Wajib**: Tidak  | 
| Kuota |  Jumlah hasil maksimum yang akan dikembalikan. Jika Anda memberikan ID sesi pemain, parameter ini diabaikan. **Jenis**: `int` **Wajib**: Tidak  | 

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

Informasi yang digunakan untuk membatalkan permintaan pengisian ulang perjodohan. Server game mengkomunikasikan informasi ini ke Amazon GameLift Servers layanan dalam [StopMatchBackfill()](integration-server-sdk5-unreal-actions.md#integration-server-sdk5-unreal-stopmatchbackfill) panggilan.


| Sifat-sifat | **Deskripsi** | 
| --- | --- | 
| GameSessionArn |  Pengidentifikasi sesi permainan unik dari permintaan yang dibatalkan. **Jenis**: `FString` **Wajib**: Ya  | 
| MatchmakingConfigurationArn |  Pengidentifikasi unik dari mak comblang permintaan ini dikirim ke. **Jenis**: `FString` **Wajib**: Ya  | 
| TicketId |  Pengenal unik dari tiket permintaan isi ulang yang akan dibatalkan. **Jenis**: `FString` **Wajib**: Ya  | 

## FAttributeNilai
<a name="integration-server-sdk5-unreal-dataypes-attributevalue"></a>

Gunakan nilai-nilai ini dalam [FPlayer](#integration-server-sdk5-unreal-dataypes-player) atribut pasangan kunci-nilai. Objek ini memungkinkan Anda menentukan nilai atribut menggunakan salah satu tipe data yang valid: string, nomor, array string, atau peta data. Setiap `AttributeValue` objek hanya dapat menggunakan salah satu properti yang tersedia.


| Sifat-sifat | Deskripsi | 
| --- | --- | 
| ATTRType |  Menentukan jenis nilai atribut. **Jenis:** Nilai `FAttributeType` [enum](#integration-server-sdk5-unreal-dataypes-enums).  **Wajib**: Tidak  | 
| D |  Merupakan nilai atribut string. **Jenis**: `FString` **Wajib**: Tidak  | 
| T |  Merupakan nilai atribut numerik. **Jenis**: `double` **Wajib**: Tidak  | 
| SL |  Merupakan array nilai atribut string. **Jenis**: `TArray<FString>` **Wajib**: Tidak  | 
| SDM |  Merupakan kamus kunci string dan nilai ganda. **Jenis**: `TMap<FString, double>` **Wajib**: Tidak  | 

## FGameLiftGetFleetRoleCredentialsRequest
<a name="integration-server-sdk5-unreal-dataypes-getfleetrolecredentialsrequest"></a>

Tipe data ini menyediakan kredensi peran yang memperluas akses terbatas ke AWS sumber daya Anda ke server game. Untuk informasi selengkapnya, lihat [Menyiapkan peran layanan IAM untuk Amazon GameLift Servers](setting-up-role.md).


| Sifat-sifat | **Deskripsi** | 
| --- | --- | 
| RoleArn | Nama Sumber Daya Amazon (ARN) dari peran layanan yang memperluas akses terbatas ke sumber daya Anda. AWS **Jenis**: `FString`**Wajib**: Tidak | 
| RoleSessionName | Nama sesi yang menjelaskan penggunaan kredensi peran.**Jenis**: `FString`**Wajib**: Tidak | 

## FGameLiftLongOutcome
<a name="integration-server-sdk5-unreal-dataypes-awslongoutcome"></a>

Tipe data ini dihasilkan dari tindakan dan menghasilkan objek dengan properti berikut:


| Sifat-sifat | Deskripsi | 
| --- | --- | 
| Hasil |  Hasil dari tindakan. **Jenis**: `long` **Wajib**: Tidak  | 
| ResultWithOwnership |   Hasil dari tindakan, dilemparkan sebagai rvalue, sehingga kode panggilan dapat mengambil kepemilikan objek.  **Jenis**: `long&&` **Wajib**: Tidak  | 
| Berhasil |  Apakah tindakan itu berhasil atau tidak. **Jenis**: `bool` **Wajib**: Ya  | 
| Kesalahan |  Kesalahan yang terjadi jika tindakan tidak berhasil. **Jenis**: [FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror) **Wajib**: Tidak  | 

## FGameLiftStringOutcome
<a name="integration-server-sdk5-unreal-dataypes-awsstringoutcome"></a>

Tipe data ini dihasilkan dari tindakan dan menghasilkan objek dengan properti berikut:


| Sifat-sifat | Deskripsi | 
| --- | --- | 
| Hasil |  Hasil dari tindakan. **Jenis**: `FString` **Wajib**: Tidak  | 
| ResultWithOwnership |   Hasil dari tindakan, dilemparkan sebagai rvalue, sehingga kode panggilan dapat mengambil kepemilikan objek.  **Jenis**: `FString&&` **Wajib**: Tidak  | 
| Berhasil |  Apakah tindakan itu berhasil atau tidak. **Jenis**: `bool` **Wajib**: Ya  | 
| Kesalahan |  Kesalahan yang terjadi jika tindakan tidak berhasil. **Jenis**: [FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror) **Wajib**: Tidak  | 

## FGameLiftDescribePlayerSessionsOutcome
<a name="integration-server-sdk5-unreal-dataypes-describeplayersessionsoutcome"></a>

Tipe data ini dihasilkan dari tindakan dan menghasilkan objek dengan properti berikut:


| Sifat-sifat | Deskripsi | 
| --- | --- | 
| Hasil |  Hasil dari tindakan. **Jenis**: [FGameLiftDescribePlayerSessionsResult](#integration-server-sdk5-unreal-dataypes-describeplayersessionresult) **Wajib**: Tidak   | 
| ResultWithOwnership |   Hasil dari tindakan, dilemparkan sebagai rvalue, sehingga kode panggilan dapat mengambil kepemilikan objek.  **Jenis**: `FGameLiftDescribePlayerSessionsResult&&` **Wajib**: Tidak  | 
| Berhasil |  Apakah tindakan itu berhasil atau tidak. **Jenis**: `bool` **Wajib**: Ya  | 
| Kesalahan |  Kesalahan yang terjadi jika tindakan tidak berhasil. **Jenis**: [FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror) **Wajib**: Tidak  | 

## FGameLiftDescribePlayerSessionsResult
<a name="integration-server-sdk5-unreal-dataypes-describeplayersessionresult"></a>


| Sifat-sifat | Deskripsi | 
| --- | --- | 
| PlayerSessions |   **Jenis**: `TArray<FGameLiftPlayerSession>` **Wajib**: Ya  | 
| NextToken |  Token yang menunjukkan awal halaman hasil berikutnya. Untuk menentukan awal kumpulan hasil, jangan berikan nilai. Jika Anda memberikan ID sesi pemain, parameter ini diabaikan. **Jenis**: `FString` **Wajib**: Tidak  | 
| Berhasil |  Apakah tindakan itu berhasil atau tidak. **Jenis**: `bool` **Wajib**: Ya  | 
| Kesalahan |  Kesalahan yang terjadi jika tindakan tidak berhasil. **Jenis**: [FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror) **Wajib**: Tidak  | 

## FGenericHasil
<a name="integration-server-sdk5-unreal-dataypes-genericoutcome"></a>

Tipe data ini dihasilkan dari tindakan dan menghasilkan objek dengan properti berikut:


| Sifat-sifat | Deskripsi | 
| --- | --- | 
| Berhasil |  Apakah tindakan itu berhasil atau tidak. **Jenis**: `bool` **Wajib**: Ya  | 
| Kesalahan |  Kesalahan yang terjadi jika tindakan tidak berhasil. **Jenis**: [FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror) **Wajib**: Tidak  | 

## FGameLiftPlayerSession
<a name="integration-server-sdk5-unreal-dataypes-playersession"></a>


| Sifat-sifat | Deskripsi | 
| --- | --- | 
| CreationTime |  **Jenis**: `long` **Wajib**: Ya  | 
| FleetId |  **Jenis**: `FString` **Wajib**: Ya  | 
| GameSessionId |  **Jenis**: `FString` **Wajib**: Ya  | 
| IpAddress |  **Jenis**: `FString` **Wajib**: Ya  | 
| PlayerData |  **Jenis**: `FString` **Wajib**: Ya  | 
| PlayerId |  **Jenis**: `FString` **Wajib**: Ya  | 
| PlayerSessionId |  **Jenis**: `FString` **Wajib**: Ya  | 
| Port |  **Jenis**: `int` **Wajib**: Ya  | 
| Status |  **Jenis:** A `PlayerSessionStatus` [enum](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-dataypes-enums). **Wajib**: Ya  | 
| TerminationTime |  **Jenis**: `long` **Wajib**: Ya  | 
| DnsName |  **Jenis**: `FString` **Wajib**: Ya  | 

## FGameLiftGetComputeCertificateOutcome
<a name="integration-server-sdk5-unreal-dataypes-getcomputecertificateoutcome"></a>

Tipe data ini dihasilkan dari tindakan dan menghasilkan objek dengan properti berikut:


| Sifat-sifat | Deskripsi | 
| --- | --- | 
| Hasil |  Hasil dari tindakan. **Jenis**: [FGameLiftGetComputeCertificateResult](#integration-server-sdk5-unreal-dataypes-getcomputecertificateresult) **Wajib**: Tidak   | 
| ResultWithOwnership |   Hasil dari tindakan, dilemparkan sebagai rvalue, sehingga kode panggilan dapat mengambil kepemilikan objek.  **Jenis**: `FGameLiftGetComputeCertificateResult&&` **Wajib**: Tidak  | 
| Berhasil |  Apakah tindakan itu berhasil atau tidak. **Jenis**: `bool` **Wajib**: Ya  | 
| Kesalahan |  Kesalahan yang terjadi jika tindakan tidak berhasil. **Jenis**: [FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror) **Wajib**: Tidak  | 

## FGameLiftGetComputeCertificateResult
<a name="integration-server-sdk5-unreal-dataypes-getcomputecertificateresult"></a>

Jalur ke sertifikat TLS pada komputasi Anda dan nama host komputasi.


| Sifat-sifat | Deskripsi | 
| --- | --- | 
| CertificatePath |  **Jenis**: `FString` **Wajib**: Ya  | 
| ComputeName |  **Jenis**: `FString` **Wajib**: Ya  | 

## FGameLiftGetFleetRoleCredentialsOutcome
<a name="integration-server-sdk5-unreal-dataypes-getfleetrolecredentialsoutcome"></a>

Tipe data ini dihasilkan dari tindakan dan menghasilkan objek dengan properti berikut:


| Sifat-sifat | Deskripsi | 
| --- | --- | 
| Hasil |  Hasil dari tindakan. **Jenis**: [FGetFleetRoleCredentialsResult](#integration-server-sdk5-unreal-dataypes-getfleetrolecredentialsresult) **Wajib**: Tidak   | 
| ResultWithOwnership |   Hasil dari tindakan, dilemparkan sebagai rvalue, sehingga kode panggilan dapat mengambil kepemilikan objek.  **Jenis**: `FGameLiftGetFleetRoleCredentialsResult&&` **Wajib**: Tidak  | 
| Berhasil |  Apakah tindakan itu berhasil atau tidak. **Jenis**: `bool` **Wajib**: Ya  | 
| Kesalahan |  Kesalahan yang terjadi jika tindakan tidak berhasil. **Jenis**: [FGameLiftError](#integration-server-sdk5-unreal-dataypes-gamelifterror) **Wajib**: Tidak  | 

## FGetFleetRoleCredentialsResult
<a name="integration-server-sdk5-unreal-dataypes-getfleetrolecredentialsresult"></a>


| Sifat-sifat | Deskripsi | 
| --- | --- | 
| AccessKeyId |  ID kunci akses untuk mengautentikasi dan menyediakan akses ke AWS sumber daya Anda. **Jenis**: `FString` **Wajib**: Tidak  | 
| AssumedRoleId |  ID pengguna yang menjadi milik peran layanan. **Jenis**: `FString` **Wajib**: Tidak  | 
| AssumedRoleUserArn |  Nama Sumber Daya Amazon (ARN) pengguna yang menjadi milik peran layanan. **Jenis**: `FString` **Wajib**: Tidak  | 
| Kedaluwarsa |  Jumlah waktu hingga kredensi sesi Anda kedaluwarsa. **Jenis**: `FDateTime` **Wajib**: Tidak  | 
| SecretAccessKey |  ID kunci akses rahasia untuk otentikasi. **Jenis**: `FString` **Wajib**: Tidak  | 
| SessionToken |  Token untuk mengidentifikasi sesi aktif saat ini yang berinteraksi dengan AWS sumber daya Anda. **Jenis**: `FString` **Wajib**: Tidak  | 
| Berhasil |  Apakah tindakan itu berhasil atau tidak. **Jenis**: `bool` **Wajib**: Ya  | 
| Kesalahan |  Kesalahan yang terjadi jika tindakan tidak berhasil. **Jenis**: [GameLiftError](integration-server-sdk5-csharp-datatypes.md#integration-server-sdk5-csharp-datatypes-gamelifterror) **Wajib**: Tidak  | 

## FGameLiftError
<a name="integration-server-sdk5-unreal-dataypes-gamelifterror"></a>


| Sifat-sifat | Deskripsi | 
| --- | --- | 
| ErrorType |  Jenis kesalahan. **Jenis:** A `GameLiftErrorType` [enum](integration-server-sdk5-cpp-datatypes.md#integration-server-sdk5-cpp-dataypes-enums). **Wajib**: Tidak   | 
| ErrorName |  Nama kesalahannya.  **Jenis**: `std::string`  **Wajib**: Tidak   | 
| ErrorMessage |  Pesan kesalahan.  **Jenis**: `std::string`  **Wajib**: Tidak   | 

## Enum
<a name="integration-server-sdk5-unreal-dataypes-enums"></a>

Enum yang didefinisikan untuk SDK server untuk Amazon GameLift Servers (Unreal) didefinisikan sebagai berikut:

**FAttributeJenis**  
+ **TIDAK ADA**
+ **STRING**
+ **GANDA**
+ **STRING\$1LIST**
+ **STRING\$1DOUBLE\$1PETA**

**GameLiftErrorType**  
Nilai string yang menunjukkan jenis kesalahan. Nilai yang valid meliputi:  
+ **SERVICE\$1CALL\$1FAILED - Panggilan ke layanan telah gagal**. AWS 
+ **LOCAL\$1CONNECTION\$1FAILED — Koneksi lokal gagal**. Amazon GameLift Servers 
+ **NETWORK\$1NOT\$1INITIALIZED — Jaringan belum diinisialisasi**. 
+ **GAMESESSION\$1ID\$1NOT\$1SET — ID sesi permainan belum ditetapkan**. 
+ **BAD\$1REQUEST\$1EXCEPTION** 
+ **INTERNAL\$1SERVICE\$1EXCEPTION** 
+ **ALREADY\$1INITIALIZED** — Amazon GameLift Servers Server atau Klien telah diinisialisasi dengan Initialize (). 
+ **FLEET\$1MISMATCH** — Armada target tidak cocok dengan armada GameSession atau PlayerSession. 
+ **GAMELIFT\$1CLIENT\$1NOT\$1INITIALIZED — Klien belum diinisialisasi**. Amazon GameLift Servers 
+ **GAMELIFT\$1SERVER\$1NOT\$1INITIALIZED — Server belum diinisialisasi**. Amazon GameLift Servers 
+ **GAME\$1SESSION\$1ENDED\$1FAILED** — SDK server untuk tidak Amazon GameLift Servers dapat menghubungi layanan untuk melaporkan sesi permainan berakhir. 
+ **GAME\$1SESSION\$1NOT\$1READY — Sesi Game Server** tidak diaktifkan. Amazon GameLift Servers 
+ **GAME\$1SESSION\$1READY\$1FAILED** — SDK server untuk tidak Amazon GameLift Servers dapat menghubungi layanan untuk melaporkan sesi permainan sudah siap. 
+ **INITIALIZATION\$1MISMATCH** — Metode klien dipanggil setelah Server: :Initialize (), atau sebaliknya. 
+ **NOT\$1INITIALIZED** — Amazon GameLift Servers Server atau Klien belum diinisialisasi dengan Initialize (). 
+ **NO\$1TARGET\$1ALIASID\$1SET — AliaID target belum ditetapkan**. 
+ **NO\$1TARGET\$1FLEET\$1SET — Armada target belum ditetapkan**. 
+ **PROCESS\$1ENDING\$1FAILED** — SDK server untuk tidak Amazon GameLift Servers dapat menghubungi layanan untuk melaporkan proses berakhir. 
+ **PROCESS\$1NOT\$1ACTIVE** — Proses server belum aktif, tidak terikat pada GameSession, dan tidak dapat menerima atau memproses. PlayerSessions 
+ **PROCESS\$1NOT\$1READY** — Proses server belum siap untuk diaktifkan. 
+ **PROCESS\$1READY\$1FAILED** — SDK server untuk tidak Amazon GameLift Servers dapat menghubungi layanan untuk melaporkan proses siap. 
+ **SDK\$1VERSION\$1DETECTION\$1FAILED — Deteksi versi** SDK gagal. 
+ **STX\$1CALL\$1FAILED — Panggilan ke komponen backend XStx server telah gagal**. 
+ **STX\$1INITIALIZATION\$1FAILED — Komponen backend server gagal** XStx menginisialisasi. 
+ **UNEXPECTED\$1PLAYER\$1SESSION — Sesi** pemain yang tidak terdaftar ditemui oleh server. 
+ **WEBSOCKET\$1CONNECT\$1FAILURE** 
+ **WEBSOCKET\$1CONNECT\$1FALURE\$1FORBIDDEN** 
+ **WEBSOCKET\$1CONNECT\$1FAILURE\$1INVALID\$1URL** 
+ **WEBSOCKET\$1CONNECT\$1FAILURE\$1TIMEOUT** 
+ **WEBSOCKET\$1RETRIABLE\$1SEND\$1MESSAGE\$1FAILURE - Kegagalan yang dapat diambil untuk mengirim pesan ke Layanan**. GameLift WebSocket 
+ **WEBSOCKET\$1SEND\$1MESSAGE\$1FAILURE — Kegagalan untuk mengirim pesan** ke Layanan. GameLift WebSocket 
+ **MATCH\$1BACKFILL\$1REQUEST\$1VALIDATION — Validasi permintaan gagal**. 
+ **PLAYER\$1SESSION\$1REQUEST\$1VALIDATION — Validasi permintaan gagal**. 

**EPlayerSessionCreationPolicy**  
Nilai string yang menunjukkan apakah sesi game menerima pemain baru. Nilai yang valid meliputi:   
+ **ACCEPT\$1ALL** — Menerima semua sesi pemain baru. 
+ **DENY\$1ALL** — Menolak semua sesi pemain baru. 
+ **NOT\$1SET** — Sesi permainan tidak diatur untuk menerima atau menolak sesi pemain baru. 

**EPlayerSessionStatus**  
+ **AKTIF**
+ **SELESAI**
+ **NOT\$1SET**
+ **DIPESAN**
+ **TIMEDOUT**

[Server C \$1\$1 (Tidak nyata) SDK 5.x untuk Amazon GameLift Servers -- Tipe data](integration-server-sdk5-unreal-datatypes.md)

**Topics**
+ [Server C \$1\$1 (Tidak nyata) SDK 5.x untuk Amazon GameLift Servers -- Tipe data](integration-server-sdk5-unreal-datatypes.md)
+ [GetSdkVersion()](#integration-server-sdk5-unreal-getsdkversion)
+ [InitSDK()](#integration-server-sdk5-unreal-initsdk)
+ [InitSDK()](#integration-server-sdk5-unreal-initsdk-anywhere)
+ [ProcessReady()](#integration-server-sdk5-unreal-processready)
+ [ProcessEnding()](#integration-server-sdk5-unreal-processending)
+ [ActivateGameSession()](#integration-server-sdk5-unreal-activategamesession)
+ [UpdatePlayerSessionCreationPolicy()](#integration-server-sdk5-unreal-updateplayersessioncreationpolicy)
+ [GetGameSessionId()](#integration-server-sdk5-unreal-getgamesessionid)
+ [GetTerminationTime()](#integration-server-sdk5-unreal-getterm)
+ [AcceptPlayerSession()](#integration-server-sdk5-unreal-acceptplayersession)
+ [RemovePlayerSession()](#integration-server-sdk5-unreal-removeplayersession)
+ [DescribePlayerSessions()](#integration-server-sdk5-unreal-describeplayersessions)
+ [StartMatchBackfill()](#integration-server-sdk5-unreal-startmatchbackfill)
+ [StopMatchBackfill()](#integration-server-sdk5-unreal-stopmatchbackfill)
+ [GetComputeCertificate()](#integration-server-sdk5-unreal-getcomputecertificate)
+ [GetFleetRoleCredentials()](#integration-server-sdk5-unreal-getfleetrolecredentials)
+ [Hancurkan ()](#integration-server-sdk5-unreal-ref-destroy)

## GetSdkVersion()
<a name="integration-server-sdk5-unreal-getsdkversion"></a>

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

### Sintaks
<a name="integration-server-sdk5-unreal-getsdkversion-syntax"></a>

```
FGameLiftStringOutcome GetSdkVersion();
```

### Nilai yang ditampilkan
<a name="integration-server-sdk5-unreal-getsdkversion-return"></a>

Jika berhasil, ini mengembalikan versi SDK saat ini sebagai objek [FGameLiftStringOutcome](integration-server-sdk5-unreal-datatypes.md#integration-server-sdk5-unreal-dataypes-awsstringoutcome). Objek yang dikembalikan menyertakan nomor versi (contoh`5.0.0`). Jika tidak berhasil, ini mengembalikan pesan kesalahan.

### Contoh
<a name="integration-server-sdk5-unreal-getsdkversion-example"></a>

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

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

Menginisialisasi Amazon GameLift Servers SDK untuk armada EC2 terkelola. Panggil metode ini saat peluncuran, sebelum inisialisasi lain yang terkait dengan Amazon GameLift Servers terjadi. Metode ini membaca parameter server dari lingkungan host untuk mengatur komunikasi antara server dan Amazon GameLift Servers layanan. Ini menggunakan token idempotensi, jadi Anda mencoba kembali panggilan ini dengan aman ketika gagal.

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

```
FGameLiftGenericOutcome InitSDK()
```

### Nilai yang ditampilkan
<a name="integration-server-sdk5-unreal-initsdk-return"></a>

Jika berhasil, mengembalikan `InitSdkOutcome` objek yang menunjukkan bahwa proses server siap untuk memanggil[ProcessReady()](#integration-server-sdk5-unreal-processready). 

### Contoh
<a name="integration-server-sdk5-unreal-initsdk-example"></a>

```
//Call InitSDK to establish a local connection with the Amazon GameLift Servers Agent to enable further communication.
FGameLiftGenericOutcome initSdkOutcome = GameLiftSdkModule->InitSDK();
```

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

Menginisialisasi Amazon GameLift Servers SDK untuk armada Anywhere atau armada kontainer terkelola. Panggil metode ini saat peluncuran, sebelum inisialisasi lain yang terkait dengan Amazon GameLift Servers terjadi. Metode ini memerlukan parameter server eksplisit untuk mengatur komunikasi antara server dan Amazon GameLift Servers layanan. Ini menggunakan token idempotensi, jadi Anda mencoba kembali panggilan ini dengan aman ketika gagal.

### Sintaks
<a name="integration-server-sdk5-unreal-initsdk-anywhere-syntax"></a>

```
FGameLiftGenericOutcome InitSDK(serverParameters)
```

### Parameter
<a name="integration-server-sdk5-unreal-initsdk-anywhere-parameter"></a>

[FServerParameter](integration-server-sdk5-unreal-datatypes.md#integration-server-sdk5-unreal-dataypes-serverparameters)  
Untuk menginisialisasi server game pada armada Amazon GameLift Servers Anywhere, buat `ServerParameters` objek dengan informasi berikut:  
+ URL yang WebSocket digunakan untuk terhubung ke server game Anda. 
+ ID dari proses yang digunakan untuk meng-host server game Anda. 
+ ID komputasi yang menghosting proses server game Anda. 
+ ID Amazon GameLift Servers armada yang berisi komputasi Amazon GameLift Servers Anywhere Anda.
+ Token otorisasi yang dihasilkan oleh Amazon GameLift Servers operasi. 

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

Jika berhasil, mengembalikan `InitSdkOutcome` objek yang menunjukkan bahwa proses server siap untuk memanggil[ProcessReady()](#integration-server-sdk5-unreal-processready). 

**catatan**  
Jika panggilan gagal untuk build game yang diterapkan ke `InitSDK()` armada Anywhere, periksa `ServerSdkVersion` parameter yang digunakan saat membuat sumber daya build. Anda harus secara eksplisit menetapkan nilai ini ke versi SDK server yang digunakan. Nilai default untuk parameter ini adalah 4.x, yang tidak kompatibel. Untuk mengatasi masalah ini, buat build baru dan terapkan ke armada baru.

### Contoh
<a name="integration-server-sdk5-unreal-initsdk-anywhere-example"></a>

```
//Define the server parameters
FServerParameters serverParameters;
parameters.m_authToken = "1111aaaa-22bb-33cc-44dd-5555eeee66ff"; 
parameters.m_fleetId = "arn:aws:gamelift:us-west-1:111122223333:fleet/fleet-9999ffff-88ee-77dd-66cc-5555bbbb44aa";
parameters.m_hostId = "HardwareAnywhere"; 
parameters.m_processId = "PID1234";
parameters.m_webSocketUrl = "wss://us-west-1.api.amazongamelift.com"; 

//Call InitSDK to establish a local connection with the Amazon GameLift Servers Agent to enable further communication.
FGameLiftGenericOutcome initSdkOutcome = GameLiftSdkModule->InitSDK(serverParameters);
```

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

Memberitahu Amazon GameLift Servers bahwa proses server siap untuk meng-host sesi permainan. Panggil metode ini setelah memanggil[InitSDK()](#integration-server-sdk5-unreal-initsdk). Metode ini harus dipanggil hanya satu kali per proses.

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

`GenericOutcome ProcessReady(const Aws::GameLift::Server::ProcessParameters &processParameters);`

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

**processParameters**  
[FProcessParameter](integration-server-sdk5-unreal-datatypes.md#integration-server-sdk5-unreal-dataypes-process)Objek yang mengkomunikasikan informasi berikut tentang proses server:  
+ Nama metode callback yang 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.

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

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

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

Contoh ini menggambarkan panggilan [ProcessReady()](#integration-server-sdk5-unreal-processready) dan mendelegasi implementasi fungsi.

```
//Calling ProcessReady tells Amazon GameLift Servers this game server is ready to receive incoming game sessions!
UE_LOG(GameServerLog, Log, TEXT("Calling Process Ready"));
FGameLiftGenericOutcome processReadyOutcome = GameLiftSdkModule->ProcessReady(*params);
```

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

Memberitahu Amazon GameLift Servers bahwa proses server berakhir. Panggil metode ini setelah semua tugas pembersihan lainnya (termasuk mematikan sesi permainan aktif) dan sebelum mengakhiri proses. Tergantung pada hasil`ProcessEnding()`, proses keluar dengan sukses (0) atau kesalahan (-1) dan menghasilkan peristiwa armada. Jika proses berakhir dengan kesalahan, peristiwa armada yang dihasilkan adalah`SERVER_PROCESS_TERMINATED_UNHEALTHY`).

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

```
FGameLiftGenericOutcome ProcessEnding()
```

### Nilai yang ditampilkan
<a name="integration-server-sdk5-unreal-processending-return"></a>

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

### Contoh
<a name="integration-server-sdk5-unreal-processending-example"></a>

```
//OnProcessTerminate callback. Amazon GameLift Servers will invoke this callback before shutting down an instance hosting this game server.
//It gives this game server a chance to save its state, communicate with services, etc., before being shut down.
//In this case, we simply tell Amazon GameLift Servers we are indeed going to shutdown.
params->OnTerminate.BindLambda([=]() {
  UE_LOG(GameServerLog, Log, TEXT("Game Server Process is terminating"));
  GameLiftSdkModule->ProcessEnding();
});
```

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

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

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

```
FGameLiftGenericOutcome ActivateGameSession()
```

### Nilai yang ditampilkan
<a name="integration-server-sdk5-unreal-activategamesession-return"></a>

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

### Contoh
<a name="integration-server-sdk5-unreal-activategamesession-example"></a>

Contoh ini menunjukkan `ActivateGameSession()` dipanggil sebagai bagian dari fungsi `onStartGameSession()` delegasi. 

```
//When a game session is created, Amazon GameLift Servers sends an activation request to the game server and passes along the game session object containing game properties and other settings.
//Here is where a game server should take action based on the game session object.
//Once the game server is ready to receive incoming player connections, it should invoke GameLiftServerAPI.ActivateGameSession()
auto onGameSession = [=](Aws::GameLift::Server::Model::GameSession gameSession)
{
  FString gameSessionId = FString(gameSession.GetGameSessionId());
  UE_LOG(GameServerLog, Log, TEXT("GameSession Initializing: %s"), *gameSessionId);
  GameLiftSdkModule->ActivateGameSession();
};
```

## UpdatePlayerSessionCreationPolicy()
<a name="integration-server-sdk5-unreal-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.

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

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

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

**playerCreationSessionKebijakan**  
Nilai string yang menunjukkan apakah sesi game menerima pemain baru.   
Nilai yang valid meliputi:  
+ **ACCEPT\$1ALL** — Menerima semua sesi pemain baru.
+ **DENY\$1ALL** — Menolak semua sesi pemain baru.

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

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

### Contoh
<a name="integration-server-sdk5-unreal-updateplayersessioncreationpolicy-example"></a>

Contoh ini menetapkan kebijakan bergabung sesi game saat ini untuk menerima semua pemain.

```
FGameLiftGenericOutcome outcome = GameLiftSdkModule->UpdatePlayerSessionCreationPolicy(Aws::GameLift::Model::EPlayerSessionCreationPolicy::ACCEPT_ALL);
```

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

Mengambil ID sesi permainan yang dihosting oleh proses server aktif. 

Untuk proses idle yang tidak diaktifkan dengan sesi game, panggilan akan menampilkan file. [FGameLiftError](integration-server-sdk5-unreal-datatypes.md#integration-server-sdk5-unreal-dataypes-gamelifterror)

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

```
FGameLiftStringOutcome GetGameSessionId()
```

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

Tindakan ini tidak memiliki parameter.

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

Jika berhasil, ini mengembalikan ID sesi game sebagai objek [FGameLiftStringOutcome](integration-server-sdk5-unreal-datatypes.md#integration-server-sdk5-unreal-dataypes-awsstringoutcome). Jika tidak berhasil, mengembalikan pesan kesalahan.

Untuk proses idle yang tidak diaktifkan dengan sesi game, panggilan mengembalikan `Success` = `True` dan `GameSessionId` =`""`.

### Contoh
<a name="integration-server-sdk5-unreal-getgamesessionid-example"></a>

```
//When a game session is created, Amazon GameLift Servers sends an activation request to the game server and passes along the game session object containing game properties and other settings.
//Here is where a game server should take action based on the game session object.
//Once the game server is ready to receive incoming player connections, it should invoke GameLiftServerAPI.ActivateGameSession()
auto onGameSession = [=](Aws::GameLift::Server::Model::GameSession gameSession)
{
  FString gameSessionId = FString(gameSession.GetGameSessionId());
  UE_LOG(GameServerLog, Log, TEXT("GameSession Initializing: %s"), *gameSessionId);
  GameLiftSdkModule->ActivateGameSession();
};
```

## GetTerminationTime()
<a name="integration-server-sdk5-unreal-getterm"></a>

Mengembalikan waktu yang merupakan jadwal proses server akan ditutup, jika waktu penghentian tersedia. Proses server mengambil tindakan setelah menerima `onProcessTerminate()` panggilan balik dariAmazon GameLift Servers. Amazon GameLift Serverspanggilan `onProcessTerminate()` untuk alasan berikut: 
+ Ketika proses server telah melaporkan kesehatan yang buruk atau belum Amazon GameLift Servers merespons.
+ Saat mengakhiri instance selama acara scale-down.
+ Ketika sebuah instance dihentikan karena gangguan [spot-instance](spot-tasks.md).

### Sintaks
<a name="integration-server-sdk5-unreal-getterm-syntax"></a>

```
AwsDateTimeOutcome GetTerminationTime()
```

### Nilai yang ditampilkan
<a name="integration-server-sdk5-unreal-getterm-return"></a>

Jika berhasil, ini mengembalikan waktu penghentian sebagai objek `AwsDateTimeOutcome`. Nilainya adalah waktu penghentian, dinyatakan dalam kutu yang telah berlalu sejak. `0001 00:00:00` Misalnya, nilai waktu tanggal `2020-09-13 12:26:40 -000Z` sama dengan `637355968000000000` kutu. Jika tidak ada waktu penghentian tersedia, pesan kesalahan ditampilkan.

Jika proses belum menerima ` ProcessParameters.OnProcessTerminate()` panggilan balik, pesan kesalahan akan dikembalikan. Untuk informasi selengkapnya tentang mematikan proses server, lihat[Menanggapi notifikasi shutdown proses server](gamelift-sdk-server-api.md#gamelift-sdk-server-terminate).

### Contoh
<a name="integration-server-sdk5-unreal-getterm-example"></a>

```
AwsDateTimeOutcome TermTimeOutcome = GameLiftSdkModule->GetTerminationTime();
```

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

Memberitahu Amazon GameLift Servers bahwa pemain dengan ID sesi pemain tertentu telah terhubung ke proses server dan membutuhkan validasi. Amazon GameLift Serversmemverifikasi bahwa ID sesi pemain valid. Setelah sesi pemain divalidasi, Amazon GameLift Servers mengubah status slot pemain dari RESERVED menjadi AKTIF. 

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

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

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

playerSessionId  
ID unik yang dikeluarkan oleh Amazon GameLift Servers saat sesi pemain baru dibuat.

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

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

### Contoh
<a name="integration-server-sdk5-unreal-acceptplayersession-example"></a>

Contoh ini menangani permintaan koneksi yang mencakup memvalidasi dan menolak sesi pemain yang tidak valid. IDs

```
bool GameLiftManager::AcceptPlayerSession(const FString& playerSessionId, const FString& playerId)
{
  #if WITH_GAMELIFT
  UE_LOG(GameServerLog, Log, TEXT("Accepting GameLift PlayerSession: %s . PlayerId: %s"), *playerSessionId, *playerId);
  FString gsId = GetCurrentGameSessionId();
  if (gsId.IsEmpty()) {
    UE_LOG(GameServerLog, Log, TEXT("No GameLift GameSessionId. Returning early!"));
    return false;
  }
  
  if (!GameLiftSdkModule->AcceptPlayerSession(playerSessionId).IsSuccess()) {
    UE_LOG(GameServerLog, Log, TEXT("PlayerSession not Accepted."));
    return false;
  }

  // Add PlayerSession from internal data structures keeping track of connected players
  connectedPlayerSessionIds.Add(playerSessionId);
  idToPlayerSessionMap.Add(playerSessionId, PlayerSession{ playerId, playerSessionId });
  return true;
  #else
  return false;
  #endif
}
```

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

Memberitahu Amazon GameLift Servers bahwa pemain telah terputus dari proses server. Sebagai tanggapan, Amazon GameLift Servers ubah slot pemain menjadi tersedia. 

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

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

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

**`playerSessionId`**  
ID unik yang dikeluarkan oleh Amazon GameLift Servers saat sesi pemain baru dibuat.

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

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

### Contoh
<a name="integration-server-sdk5-unreal-removeplayersession-example"></a>

```
bool GameLiftManager::RemovePlayerSession(const FString& playerSessionId)
{
  #if WITH_GAMELIFT
  UE_LOG(GameServerLog, Log, TEXT("Removing GameLift PlayerSession: %s"), *playerSessionId);

  if (!GameLiftSdkModule->RemovePlayerSession(playerSessionId).IsSuccess()) {
    UE_LOG(GameServerLog, Log, TEXT("PlayerSession Removal Failed"));
    return false;
  }

  // Remove PlayerSession from internal data structures that are keeping track of connected players
  connectedPlayerSessionIds.Remove(playerSessionId);
  idToPlayerSessionMap.Remove(playerSessionId);

  // end the session if there are no more players connected
  if (connectedPlayerSessionIds.Num() == 0) {
    EndSession();
  }

  return true;
  #else
  return false;
  #endif
}
```

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

Mengambil data sesi pemain yang mencakup pengaturan, metadata sesi, dan data pemain. Gunakan metode ini untuk mendapatkan informasi tentang hal-hal berikut:
+ Sesi pemain tunggal
+ Semua sesi pemain dalam sesi permainan
+ Semua sesi pemain yang terkait dengan ID pemain tunggal

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

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

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

**[FGameLiftDescribePlayerSessionsRequest](integration-server-sdk5-unreal-datatypes.md#integration-server-sdk5-unreal-dataypes-playersessions)**  
[FGameLiftDescribePlayerSessionsRequest](integration-server-sdk5-unreal-datatypes.md#integration-server-sdk5-unreal-dataypes-playersessions)Objek yang menggambarkan sesi pemain mana yang akan diambil.

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

Jika berhasil, ini mengembalikan objek [FGameLiftDescribePlayerSessionsOutcome](integration-server-sdk5-unreal-datatypes.md#integration-server-sdk5-unreal-dataypes-describeplayersessionsoutcome) yang berisi satu set objek sesi pemain yang sesuai dengan parameter permintaan.

### Contoh
<a name="integration-server-sdk5-unreal-describeplayersessions-example"></a>

Contoh ini meminta semua sesi pemain yang terhubung secara aktif ke sesi permainan tertentu. Dengan menghilangkan *NextToken*dan mengatur nilai *Batas* ke 10, Amazon GameLift Servers mengembalikan catatan sesi 10 pemain pertama yang cocok dengan permintaan.

```
void GameLiftManager::DescribePlayerSessions()
{
  #if WITH_GAMELIFT
  FString localPlayerSessions;
  for (auto& psId : connectedPlayerSessionIds)
  {
    PlayerSession ps = idToPlayerSessionMap[psId];
    localPlayerSessions += FString::Printf(TEXT("%s : %s  ; "), *(ps.playerSessionId), *(ps.playerId));
  }
  UE_LOG(GameServerLog, Log, TEXT("LocalPlayerSessions: %s"), *localPlayerSessions);

  UE_LOG(GameServerLog, Log, TEXT("Describing PlayerSessions in this GameSession"));
  FGameLiftDescribePlayerSessionsRequest request;
  request.m_gameSessionId = GetCurrentGameSessionId();

  FGameLiftDescribePlayerSessionsOutcome outcome = GameLiftSdkModule->DescribePlayerSessions(request);
  LogDescribePlayerSessionsOutcome(outcome);
  #endif
}
```

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

Mengirim permintaan untuk menemukan pemain baru untuk slot terbuka dalam sesi permainan yang dibuat denganFlexMatch. Untuk informasi selengkapnya, lihat [fitur FlexMatch isi ulang](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-backfill.html).

Tindakan ini asinkron. Jika pemain baru dicocokkan, kirimkan data Amazon GameLift Servers 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-sdk5-unreal-stopmatchbackfill) terlebih dahulu untuk membatalkan permintaan asli.

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

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

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

**[FStartMatchBackfillRequest](integration-server-sdk5-unreal-datatypes.md#integration-server-sdk5-unreal-dataypes-startmatchbackfillrequest)**  
 StartMatchBackfillRequest Objek yang mengkomunikasikan informasi berikut:  
+ ID tiket untuk ditetapkan ke permintaan backfill. Informasi ini opsional; jika tidak ada ID yang diberikan, Amazon GameLift Servers akan menghasilkan satu.
+ Matchmaker untuk dikirimi permintaan. ARN konfigurasi penuh diperlukan. Nilai ini ada dalam data mak comblang sesi permainan.
+ ID sesi permainan untuk mengisi ulang.
+ Data perjodohan yang tersedia untuk pemain sesi permainan saat ini.

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

Mengembalikan `StartMatchBackfillOutcome` objek dengan ID tiket isi ulang kecocokan, atau kegagalan dengan pesan kesalahan. 

### Contoh
<a name="integration-server-sdk5-unreal-startmatchbackfill-example"></a>

```
FGameLiftStringOutcome FGameLiftServerSDKModule::StartMatchBackfill(const FStartMatchBackfillRequest& request) 
{
  #if WITH_GAMELIFT
  Aws::GameLift::Server::Model::StartMatchBackfillRequest sdkRequest;
  sdkRequest.SetTicketId(TCHAR_TO_UTF8(*request.m_ticketId));
  sdkRequest.SetGameSessionArn(TCHAR_TO_UTF8(*request.m_gameSessionArn));
  sdkRequest.SetMatchmakingConfigurationArn(TCHAR_TO_UTF8(*request.m_matchmakingConfigurationArn));
  for (auto player : request.m_players) {
    Aws::GameLift::Server::Model::Player sdkPlayer;
    sdkPlayer.SetPlayerId(TCHAR_TO_UTF8(*player.m_playerId));
    sdkPlayer.SetTeam(TCHAR_TO_UTF8(*player.m_team));
    for (auto entry : player.m_latencyInMs) {
      sdkPlayer.WithLatencyMs(TCHAR_TO_UTF8(*entry.Key), entry.Value);
    }

    std::map<std::string, Aws::GameLift::Server::Model::AttributeValue> sdkAttributeMap;
    for (auto attributeEntry : player.m_playerAttributes) {
      FAttributeValue value = attributeEntry.Value;
      Aws::GameLift::Server::Model::AttributeValue attribute;
      switch (value.m_type) {
        case FAttributeType::STRING:
          attribute = Aws::GameLift::Server::Model::AttributeValue(TCHAR_TO_UTF8(*value.m_S));
        break;
        case FAttributeType::DOUBLE:
          attribute = Aws::GameLift::Server::Model::AttributeValue(value.m_N);
        break;
        case FAttributeType::STRING_LIST:
          attribute = Aws::GameLift::Server::Model::AttributeValue::ConstructStringList();
          for (auto sl : value.m_SL) {
            attribute.AddString(TCHAR_TO_UTF8(*sl));
          };
        break;
        case FAttributeType::STRING_DOUBLE_MAP:
          attribute = Aws::GameLift::Server::Model::AttributeValue::ConstructStringDoubleMap();
          for (auto sdm : value.m_SDM) {
            attribute.AddStringAndDouble(TCHAR_TO_UTF8(*sdm.Key), sdm.Value);
          };
        break;
      }
      sdkPlayer.WithPlayerAttribute((TCHAR_TO_UTF8(*attributeEntry.Key)), attribute);
    }
    sdkRequest.AddPlayer(sdkPlayer);
  }
  auto outcome = Aws::GameLift::Server::StartMatchBackfill(sdkRequest);
  if (outcome.IsSuccess()) {
    return FGameLiftStringOutcome(outcome.GetResult().GetTicketId());
  }
  else {
    return FGameLiftStringOutcome(FGameLiftError(outcome.GetError()));
  }
  #else
  return FGameLiftStringOutcome("");
  #endif
}
```

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

Membatalkan permintaan pengisian ulang pertandingan yang aktif. Untuk informasi selengkapnya, lihat [fitur FlexMatch isi ulang](https://docs.aws.amazon.com/gameliftservers/latest/flexmatchguide/match-backfill.html).

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

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

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

**[FStopMatchBackfillRequest](integration-server-sdk5-unreal-datatypes.md#integration-server-sdk5-unreal-dataypes-stopmatchbackfillrequest)**  
 StopMatchBackfillRequest Objek yang mengidentifikasi tiket perjodohan untuk dibatalkan:   
+ ID tiket yang ditetapkan untuk permintaan pengisian ulang.
+ Mak comblang permintaan isi ulang dikirim ke.
+ Sesi permainan yang terkait dengan permintaan isi ulang.

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

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

### Contoh
<a name="integration-server-sdk5-unreal-stopmatchbackfill-example"></a>

```
FGameLiftGenericOutcome FGameLiftServerSDKModule::StopMatchBackfill(const FStopMatchBackfillRequest& request)
{
  #if WITH_GAMELIFT
  Aws::GameLift::Server::Model::StopMatchBackfillRequest sdkRequest;
  sdkRequest.SetTicketId(TCHAR_TO_UTF8(*request.m_ticketId));
  sdkRequest.SetGameSessionArn(TCHAR_TO_UTF8(*request.m_gameSessionArn));
  sdkRequest.SetMatchmakingConfigurationArn(TCHAR_TO_UTF8(*request.m_matchmakingConfigurationArn));
  auto outcome = Aws::GameLift::Server::StopMatchBackfill(sdkRequest);
  if (outcome.IsSuccess()) {
    return FGameLiftGenericOutcome(nullptr);
  }
  else {
    return FGameLiftGenericOutcome(FGameLiftError(outcome.GetError()));
  }
  #else
  return FGameLiftGenericOutcome(nullptr);
  #endif
}
```

## GetComputeCertificate()
<a name="integration-server-sdk5-unreal-getcomputecertificate"></a>

Mengambil jalur ke sertifikat TLS yang digunakan untuk mengenkripsi koneksi jaringan antara sumber daya komputasi Amazon GameLift Servers Anywhere Anda dan. Amazon GameLift Servers Anda dapat menggunakan jalur sertifikat saat mendaftarkan perangkat komputasi ke armada Amazon GameLift Servers Anywhere. Untuk informasi selengkapnya, lihat [RegisterCompute](https://docs.aws.amazon.com/gameliftservers/latest/apireference/API_RegisterCompute.html).

### Sintaks
<a name="integration-server-sdk5-unreal-getcomputecertificate-syntax"></a>

```
FGameLiftGetComputeCertificateOutcome FGameLiftServerSDKModule::GetComputeCertificate()
```

### Nilai yang ditampilkan
<a name="integration-server-sdk5-unreal-getcomputecertificate-return"></a>

Mengembalikan `GetComputeCertificateResponse` objek yang berisi berikut: 
+ CertificatePath: Jalur ke sertifikat TLS pada sumber daya komputasi Anda. 
+ HostName: Nama host sumber daya komputasi Anda.

### Contoh
<a name="integration-server-sdk5-unreal-getcomputecertificate-example"></a>

```
FGameLiftGetComputeCertificateOutcome FGameLiftServerSDKModule::GetComputeCertificate()
{
  #if WITH_GAMELIFT
  auto outcome = Aws::GameLift::Server::GetComputeCertificate();
  if (outcome.IsSuccess()) {
    auto& outres = outcome.GetResult();
    FGameLiftGetComputeCertificateResult result;
    result.m_certificate_path = UTF8_TO_TCHAR(outres.GetCertificatePath());
    result.m_computeName = UTF8_TO_TCHAR(outres.GetComputeName());
    return FGameLiftGetComputeCertificateOutcome(result);
  }
  else {
    return FGameLiftGetComputeCertificateOutcome(FGameLiftError(outcome.GetError()));
  }
  #else
  return FGameLiftGetComputeCertificateOutcome(FGameLiftGetComputeCertificateResult());
  #endif
}
```

## GetFleetRoleCredentials()
<a name="integration-server-sdk5-unreal-getfleetrolecredentials"></a>

Mengambil kredensyal peran IAM yang memberi wewenang Amazon GameLift Servers untuk berinteraksi dengan orang lain. Layanan AWS Untuk informasi selengkapnya, lihat [Hubungkan server game yang Amazon GameLift Servers di-host ke AWS sumber daya lain](gamelift-sdk-server-resources.md).

### Sintaks
<a name="integration-server-sdk5-unreal-getfleetrolecredentials-syntax"></a>

```
FGameLiftGetFleetRoleCredentialsOutcome FGameLiftServerSDKModule::GetFleetRoleCredentials(const FGameLiftGetFleetRoleCredentialsRequest &request)
```

### Parameter
<a name="integration-server-sdk5-unreal-getfleetrolecredentials-parameters"></a>

[FGameLiftGetFleetRoleCredentialsRequest](integration-server-sdk5-unreal-datatypes.md#integration-server-sdk5-unreal-dataypes-getfleetrolecredentialsrequest)

### Nilai yang dikembalikan
<a name="integration-server-sdk5-unreal-getfleetrolecredentials-return"></a>

Mengembalikan objek [FGameLiftGetFleetRoleCredentialsOutcome](integration-server-sdk5-unreal-datatypes.md#integration-server-sdk5-unreal-dataypes-getfleetrolecredentialsoutcome).

### Contoh
<a name="integration-server-sdk5-unreal-getfleetrolecredentials-example"></a>

```
FGameLiftGetFleetRoleCredentialsOutcome FGameLiftServerSDKModule::GetFleetRoleCredentials(const FGameLiftGetFleetRoleCredentialsRequest &request)
{
  #if WITH_GAMELIFT
  Aws::GameLift::Server::Model::GetFleetRoleCredentialsRequest sdkRequest;
  sdkRequest.SetRoleArn(TCHAR_TO_UTF8(*request.m_roleArn));
  sdkRequest.SetRoleSessionName(TCHAR_TO_UTF8(*request.m_roleSessionName));

  auto outcome = Aws::GameLift::Server::GetFleetRoleCredentials(sdkRequest);

  if (outcome.IsSuccess()) {
    auto& outres = outcome.GetResult();
    FGameLiftGetFleetRoleCredentialsResult result;
    result.m_assumedUserRoleArn = UTF8_TO_TCHAR(outres.GetAssumedUserRoleArn());
    result.m_assumedRoleId = UTF8_TO_TCHAR(outres.GetAssumedRoleId());
    result.m_accessKeyId = UTF8_TO_TCHAR(outres.GetAccessKeyId());
    result.m_secretAccessKey = UTF8_TO_TCHAR(outres.GetSecretAccessKey());
    result.m_sessionToken = UTF8_TO_TCHAR(outres.GetSessionToken());
    result.m_expiration = FDateTime::FromUnixTimestamp(outres.GetExpiration());
    return FGameLiftGetFleetRoleCredentialsOutcome(result);
  }
  else {
    return FGameLiftGetFleetRoleCredentialsOutcome(FGameLiftError(outcome.GetError()));
  }
  #else
  return FGameLiftGetFleetRoleCredentialsOutcome(FGameLiftGetFleetRoleCredentialsResult());
  #endif
}
```

## Hancurkan ()
<a name="integration-server-sdk5-unreal-ref-destroy"></a>

Membebaskan SDK server Amazon GameLift Servers game dari memori. Sebagai praktik terbaik, hubungi metode ini setelah `ProcessEnding()` dan sebelum mengakhiri proses. Jika Anda menggunakan armada Anywhere dan Anda tidak menghentikan proses server setelah setiap sesi game, panggil `Destroy()` dan kemudian `InitSDK()` untuk menginisialisasi ulang sebelum memberi tahu Amazon GameLift Servers bahwa proses tersebut siap untuk menjadi tuan rumah sesi game. `ProcessReady()`

### Sintaks
<a name="integration-server-sdk5-unreal-ref-destroy-syntax"></a>

```
FGameLiftGenericOutcome Destroy();
```

### Parameter
<a name="integration-server-sdk5-unreal-ref-destroy-parameter"></a>

Tidak ada parameter.

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

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

### Contoh
<a name="integration-server-sdk5-unreal-ref-destroy-example"></a>

```
// First call ProcessEnding()
FGameLiftGenericOutcome processEndingOutcome = GameLiftSdkModule->ProcessEnding();
  
// Then call Destroy() to free the SDK from memory
FGameLiftGenericOutcome destroyOutcome = GameLiftSdkModule->Destroy();
  
// Exit the process with success or failure
if (processEndingOutcome.IsSuccess() && destroyOutcome.IsSuccess()) 
    {
    UE_LOG(GameServerLog, Log, TEXT("Server process ending successfully"));
}
else {
    if (!processEndingOutcome.IsSuccess()) {
        const FGameLiftError& error = processEndingOutcome.GetError();
        UE_LOG(GameServerLog, Error, TEXT("ProcessEnding() failed. Error: %s"),
        error.m_errorMessage.IsEmpty() ? TEXT("Unknown error") : *error.m_errorMessage);
    }
    if (!destroyOutcome.IsSuccess()) {
        const FGameLiftError& error = destroyOutcome.GetError();
        UE_LOG(GameServerLog, Error, TEXT("Destroy() failed. Error: %s"),
        error.m_errorMessage.IsEmpty() ? TEXT("Unknown error") : *error.m_errorMessage);
    }
}
```