

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# サーバー SDK (Unreal) for Amazon GameLift Servers -- アクション
<a name="integration-server-sdk-unreal-ref-actions"></a>

サーバー SDK for Unreal リファレンスを使用して、Amazon GameLift Servers でホスティングするマルチプレイヤーゲームを統合します。統合プロセスのガイダンスについては、「[サーバー SDK を使用して、Amazon GameLift Servers をゲームサーバーに追加します。](gamelift-sdk-server-api.md)」を参照してください。

**注記**  
このリファレンスは、サーバー SDK for Amazon GameLift Servers の以前のバージョン用です。最新バージョンについては、「[C\$1\$1 (Unreal) サーバー SDK 5.x for Amazon GameLift Servers -- アクション](integration-server-sdk5-unreal-actions.md)」を参照してください。

この API は、`GameLiftServerSDK.h` と `GameLiftServerSDKModels.h` で定義されます。

Unreal Engine プラグインを設定するには、コードサンプル「[Amazon GameLift Servers を Unreal Engine プロジェクトに統合する](integration-engines-setup-unreal.md)」を参照してください。

# Amazon GameLift Servers データ型用のサーバー SDK (Unreal)
<a name="integration-server-sdk-unreal-ref-datatypes"></a>

マルチプレイヤーゲームを Amazon GameLift Servers でホスティングできるように統合する際は、Amazon GameLift Servers サーバー SDK for Unreal リファレンスを使用します。統合プロセスのガイダンスについては、「[サーバー SDK を使用して、Amazon GameLift Servers をゲームサーバーに追加します。](gamelift-sdk-server-api.md)」を参照してください。

**注記**  
このリファレンスは、サーバー SDK for Amazon GameLift Servers の以前のバージョン用です。最新バージョンについては、「[C\$1\$1 (Unreal)サーバー SDK 5.x for Amazon GameLift Servers -- データ型](integration-server-sdk5-unreal-datatypes.md)」を参照してください。

この API は、`GameLiftServerSDK.h` と `GameLiftServerSDKModels.h` で定義されます。

Unreal Engine プラグインを設定するには、コードサンプル「[Amazon GameLift Servers を Unreal Engine プロジェクトに統合する](integration-engines-setup-unreal.md)」を参照してください。

[サーバー SDK (Unreal) for Amazon GameLift Servers -- アクション](integration-server-sdk-unreal-ref-actions.md)

**Topics**
+ [

## FDescribePlayerSessionsRequest
](#integration-server-sdk-unreal-ref-dataypes-playersessions)
+ [

## FProcessParameters
](#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>

このデータ型は、取得するプレイヤーセッションを指定するのに使用されます。このデータ型は次のように使用できます。
+ 特定のプレーヤーセッションをリクエストする PlayerSessionId を提供します。
+ 指定したゲームセッションのすべてのプレイヤーセッションをリクエストする GameSessionId を提供します。
+ 指定したプレイヤーのすべてのプレイヤーセッションをリクエストする PlayerId を提供します。

プレイヤーセッション数が多い場合は、ページ分割パラメータを使用して結果を順次ブロックとして取得します。

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

**GameSessionId**  
一意のゲームセッション識別子。このパラメータを使用して、指定したゲームセッションのすべてのプレイヤーセッションをリクエストします。ゲームセッション ID の形式は、`arn:aws:gamelift:<region>::gamesession/fleet-<fleet ID>/<ID string>` です。<ID string> の値は、カスタム ID 文字列または (ゲームセッション作成時に指定した場合) 生成された文字列のいずれかです。  
型: String  
必須: いいえ

**制限**  
返される結果の最大数。このパラメータを *NextToken* とともに使用して、結果を一連の順次ページとして取得します。プレイヤーセッション ID を指定した場合、このパラメータは無視されます。  
型: Integer  
必須: いいえ

**NextToken**  
結果において次の順次ページの開始を示すトークン。このアクションの以前の呼び出しで返されたトークンを使用します。結果セットの先頭を指定するには、値を指定しないでください。プレイヤーセッション ID を指定した場合、このパラメータは無視されます。  
型: string  
必須: いいえ

**PlayerId**  
プレイヤーを表す一意の識別子。プレイヤー ID は開発者によって定義されます。「[プレイヤー ID を生成する](player-sessions-player-identifiers.md)」を参照してください。  
型: string  
必須: いいえ

**PlayerSessionId**  
プレイヤーセッションを表す一意の識別子。  
型: string  
必須: いいえ

**PlayerSessionStatusFilter**  
結果をフィルタリングするプレイヤーセッションステータス。可能なプレイヤーセッションステータスとして以下のステータスがあります。  
+ RESERVED - プレイヤーセッションリクエストは受領されましたが、プレイヤーのサーバープロセスへの接続や検証はまだ行われていません。
+ ACTIVE - プレイヤーはサーバープロセスによって検証され、現時点で接続されています。
+ COMPLETED - プレイヤー接続は削除されました。
+ TIMEDOUT - プレイヤーセッションリクエストは受領されましたが、タイムアウト制限 (60 秒) 内でのプレイヤーの接続や検証は行われていません。
型: string  
必須: いいえ

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

このデータ型には、[ProcessReady()](integration-server-sdk-unreal-ref-actions.md#integration-server-sdk-unreal-ref-processready) 呼び出しで Amazon GameLift Servers サービスに送られたパラメータセットが含まれます。

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

**port**  
サーバープロセスが新しいプレイヤーの接続をリスニングするポート番号。値は、このゲームサーバービルドをデプロイするすべてのフリートで設定されているポート番号の範囲に含まれる必要があります。このポート番号は、ゲームセッションオブジェクトとプレイヤーセッションオブジェクトに含まれ、ゲームセッションがサーバープロセスに接続するときに使用します。  
型: Integer   
必須: はい

**logParameters**  
ゲームセッションログファイルへのディレクトリパスのリストを含むオブジェクト。  
型: TArray<FString>  
必須: いいえ

**onStartGameSession**  
Amazon GameLift Servers サービスが新しいゲームセッションを有効化するために呼び出す コールバック関数の名前です。Amazon GameLift Servers は、クライアントリクエスト [CreateGameSession](https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreateGameSession.html) に応答して、この関数を呼び出します。コールバック関数は [GameSession](https://docs.aws.amazon.com/gamelift/latest/apireference/API_GameSession.html) オブジェクト (*Amazon GameLift Servers* サービス API リファレンスで定義) を取得します。  
型: FOnStartGameSession   
必須: はい

**onProcessTerminate**  
Amazon GameLift Servers サービスがサーバープロセスを強制シャットダウンするために呼び出すコールバック関数の名前。この関数を呼び出すと、Amazon GameLift Servers はサーバープロセスがシャットダウンするために 5 分間待ち、サーバープロセスをシャットダウンする前に [ProcessEnding()](integration-server-sdk-unreal-ref-actions.md#integration-server-sdk-unreal-ref-processending) 呼び出しで応答します。  
型: FSimpleDelegate  
必須: いいえ

**onHealthCheck**  
Amazon GameLift Servers サービスがサーバープロセスにヘルスステータスレポートをリクエストするために呼び出すコールバック関数の名前です。Amazon GameLift Servers は、この関数を 60 秒ごとに呼び出します。この関数を呼び出した後、Amazon GameLift Servers はレスポンスを 60 秒ほど待ちます。レスポンスがなければ、サーバープロセスを異常と記録します。  
型: FOnHealthCheck  
必須: いいえ

**onUpdateGameSession**  
Amazon GameLift Servers サービスが更新されたゲームセッションオブジェクトをサーバープロセスに渡すために呼び出すコールバック関数の名前です。Amazon GameLift Servers は、[マッチバックフィル](https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-backfill.html)リクエストが処理され、更新されたマッチメーカーデータを提供できる状態になると、この関数を呼び出します。[GameSession](https://docs.aws.amazon.com/gamelift/latest/apireference/API_GameSession.html) オブジェクト、ステータス更新 (`updateReason`)、およびマッチバックフィルチケット ID が渡されます。  
型: FOnUpdateGameSession   
必須: いいえ

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

このデータ型はマッチメーキングバックフィルリクエストの送信に使用します。この情報は、[StartMatchBackfill()](integration-server-sdk-unreal-ref-actions.md#integration-server-sdk-unreal-ref-startmatchbackfill) 呼び出しで Amazon GameLift Servers サービスに伝えられます。

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

**GameSessionArn**  
 一意のゲームセッション識別子。API アクション [GetGameSessionId()](integration-server-sdk-unreal-ref-actions.md#integration-server-sdk-unreal-ref-getgamesessionid) は ARN 形式の識別子を返します。  
型: FString  
必須: はい

**MatchmakingConfigurationArn**  
このリクエストに使用されるマッチメーカーの ARN 形式の一意な識別子。元のゲームセッションの作成に使用されたマッチメーカーを見つけるには、ゲームセッションオブジェクトのマッチメーカーデータプロパティを確認します。マッチメーカーデータの詳細については「[マッチメーカーデータの処理](https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-server.html#match-server-data)」を参照してください。  
型: FString  
必須: はい

**プレイヤー**  
現在ゲームセッションに参加しているすべてのプレイヤーを表すデータのセット。マッチメーカーはこの情報を使用して、現在のプレイヤーとマッチする新しいプレイヤーを検索します。プレイヤーオブジェクトの形式の説明については、*Amazon GameLift Servers API リファレンスガイド*を参照してください。プレイヤー属性、ID、チームの割り当てを見つけるには、マッチメーカーデータプロパティのゲームセッションオブジェクトを参照してください。マッチメーカーでレイテンシーが使用されている場合は、現在のリージョンの更新されたレイテンシーを収集し、それを各プレイヤーのデータに含めます。  
型: TArray[<FPlayer>](https://docs.aws.amazon.com/gamelift/latest/apireference/API_Player.html)  
必須: はい

**TicketId**  
マッチメーキングまたはバックフィルリクエストチケットの一意の識別子。ここで値を指定しない場合、Amazon GameLift Serversによって UUID 形式で自動的に生成されます。この識別子を使用してマッチバックフィルチケットのステータスを追跡したり、必要に応じてリクエストをキャンセルしたりします。  
型: FString  
必須: いいえ

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

このデータ型はマッチメーキングバックフィルリクエストのキャンセルに使用します。この情報は、[StopMatchBackfill()](integration-server-sdk-unreal-ref-actions.md#integration-server-sdk-unreal-ref-stopmatchbackfill) 呼び出しで Amazon GameLift Servers サービスに伝えられます。

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

**GameSessionArn**  
キャンセルされるリクエストに関連付けられた一意のゲームセッション識別子。  
型: FString  
必須: はい

**MatchmakingConfigurationArn**  
このリクエストが送信されたマッチメーカーの一意の識別子。  
型: FString  
必須: はい

**TicketId**  
キャンセルされるバックフィルリクエストチケットの一意の識別子。  
型: FString  
必須: はい

[Amazon GameLift Servers データ型用のサーバー SDK (Unreal)](integration-server-sdk-unreal-ref-datatypes.md)

**Topics**
+ [

# Amazon GameLift Servers データ型用のサーバー SDK (Unreal)
](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>

指定されたプレイヤーセッション ID を持つプレイヤーがサーバープロセスに接続し、検証が必要であることを Amazon GameLift Servers サービスに通知します。Amazon GameLift Servers は、プレイヤーセッション ID が有効であること、つまりプレイヤー ID がゲームセッションでプレイヤースロットを予約していることを確認します。検証できたら、Amazon GameLift Servers はプレーヤースロットの状態を RESERVED から ACTIVE に変更します。

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

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

### パラメータ
<a name="integration-server-sdk-unreal-ref-acceptplayersession-parameter"></a>

**playerSessionId**  
 AWS SDK Amazon GameLift Servers API アクション [CreatePlayerSession](https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreatePlayerSession.html) の呼び出しに応答してAmazon GameLift Serversサービスによって発行された一意の ID。ゲームクライアントは、サーバープロセスに接続するときにこの ID をリファレンスします。  
型: FString  
必須: はい

### 戻り値
<a name="integration-server-sdk-unreal-ref-acceptplayersession-return"></a>

正常またはエラーメッセージを伴うエラーの、一般的な結果を返します。

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

サーバープロセスがゲームセッションをアクティブにし、プレイヤーの接続を受ける準備ができていることを Amazon GameLift Servers サービスに通知します。このアクションは、すべてのゲームセッションの初期化が完了した後、`onStartGameSession()` コールバック関数の一部として呼び出されます。

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

```
FGameLiftGenericOutcome ActivateGameSession()
```

### パラメータ
<a name="integration-server-sdk-unreal-ref-activategamesession-parameter"></a>

このアクションにはパラメータがありません。

### 戻り値
<a name="integration-server-sdk-unreal-ref-activategamesession-return"></a>

正常またはエラーメッセージを伴うエラーの、一般的な結果を返します。

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

設定、セッションメタデータ、プレイヤーデータを含む、プレイヤーセッションデータを取得します。このアクションを使用して、単一のプレイヤーセッション、ゲームセッション内のすべてのプレイヤーセッション、または単一のプレイヤー ID に関連付けられたすべてのプレイヤーセッションに関する情報を取得します。

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

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

### パラメータ
<a name="integration-server-sdk-unreal-ref-describeplayersessions-parameter"></a>

**describePlayerSessionsRequest**  
取得するプレイヤーセッションを記述する [FDescribePlayerSessionsRequest](integration-server-sdk-unreal-ref-datatypes.md#integration-server-sdk-unreal-ref-dataypes-playersessions) オブジェクト。  
必須: はい

### 戻り値
<a name="integration-server-sdk-unreal-ref-describeplayersessions-return"></a>

成功した場合は、リクエストのパラメータに適合したプレイヤーセッションオブジェクトのセットを含む [FDescribePlayerSessionsRequest](integration-server-sdk-unreal-ref-datatypes.md#integration-server-sdk-unreal-ref-dataypes-playersessions) オブジェクトを返します。プレイヤーセッションオブジェクトの構造は AWS SDK Amazon GameLift Servers API [PlayerSession](https://docs.aws.amazon.com/gamelift/latest/apireference/API_PlayerSession.html) データ型と同じです。

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

サーバープロセスがアクティブな場合、サーバープロセスが現在ホストしているゲームセッションの ID を取得します。

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

```
FGameLiftStringOutcome GetGameSessionId()
```

### パラメータ
<a name="integration-server-sdk-unreal-ref-getgamesessionid-parameter"></a>

このアクションにはパラメータがありません。

### 戻り値
<a name="integration-server-sdk-unreal-ref-getgamesessionid-return"></a>

成功した場合、ゲームセッション ID を `FGameLiftStringOutcome` オブジェクトとして返します。成功しなかった場合、エラーメッセージを返します。

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

フリートとそのインスタンスに関連付けられている pem エンコードされた TLS 証明書のファイルの場所を取得します。証明書設定を GENERATED に設定して新しいフリートを作成すると、この証明書 AWS Certificate Manager が生成されます。この証明書を使用して、ゲームクライアントとのセキュリティ保護ありの接続を確立し、クライアント/サーバー通信を暗号化します。

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

```
FGameLiftGetInstanceCertificateOutcome GetInstanceCertificate()
```

### パラメータ
<a name="integration-server-sdk-unreal-ref-getinstancecertificate-parameter"></a>

このアクションにはパラメータがありません。

### 戻り値
<a name="integration-server-sdk-unreal-ref-getinstancecertificate-return"></a>

成功すると、インスタンスに保存されているフリートの TLS 証明書ファイルの場所と証明書チェーンを含む `GetInstanceCertificateOutcome` オブジェクトを返します。証明書チェーンから抽出されたルート証明書ファイルもインスタンスに保存されます。成功しなかった場合、エラーメッセージを返します。

証明書と証明書チェーンデータの詳細については、 AWS Certificate Manager API リファレンスの[GetCertificate Response Elements](https://docs.aws.amazon.com/acm/latest/APIReference/API_GetCertificate.html#API_GetCertificate_ResponseElements)」を参照してください。

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

サーバープロセスに組み込まれた SDK の現在のバージョン番号を返します。

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

```
FGameLiftStringOutcome GetSdkVersion();
```

### パラメータ
<a name="integration-server-sdk-unreal-ref-getsdk-parameter"></a>

このアクションにはパラメータがありません。

### 戻り値
<a name="integration-server-sdk-unreal-ref-getsdk-return"></a>

成功した場合、`FGameLiftStringOutcome` オブジェクトとして現在の SDK バージョンを返します。返される文字列は、バージョン番号のみを含みます(例: 3.1.5)。成功しなかった場合、エラーメッセージを返します。

### 例
<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>

Amazon GameLift Servers SDK を初期化します。このメソッドは起動時に他の Amazon GameLift Servers 関連の初期化が実行される前に呼び出す必要があります。

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

```
FGameLiftGenericOutcome InitSDK()
```

### パラメータ
<a name="integration-server-sdk-unreal-ref-initsdk-parameter"></a>

このアクションにはパラメータがありません。

### 戻り値
<a name="integration-server-sdk-unreal-ref-initsdk-return"></a>

正常またはエラーメッセージを伴うエラーの、一般的な結果を返します。

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

サーバープロセスがシャットダウンしていることを Amazon GameLift Servers サービスに通知します。このメソッドは、すべてのアクティブゲームセッションのシャットダウンを含む他のすべてのクリーンアップタスクの後に呼び出されます。このメソッドは、終了コード 0 で終了します。0 以外の終了コードでは、処理が問題なく終了しなかったというイベントメッセージが発生します。

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

```
FGameLiftGenericOutcome ProcessEnding()
```

### パラメータ
<a name="integration-server-sdk-unreal-ref-processending-parameter"></a>

このアクションにはパラメータがありません。

### 戻り値
<a name="integration-server-sdk-unreal-ref-processending-return"></a>

正常またはエラーメッセージを伴うエラーの、一般的な結果を返します。

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

サーバープロセスがゲームセッションをホストする準備ができたことを Amazon GameLift Servers サービスに通知します。このメソッドは、[InitSDK()](#integration-server-sdk-unreal-ref-initsdk) の呼び出しが成功して必要な設定タスクが完了した後、サーバープロセスがゲームセッションをホストできるようになる前に呼び出す必要があります。このメソッドは、プロセスごとに 1 回だけ呼び出す必要があります。

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

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

### パラメータ
<a name="integration-server-sdk-unreal-ref-processready-parameter"></a>

**FProcessParameters**  
サーバープロセスに関する以下の情報を伝える [FProcessParameters](integration-server-sdk-unreal-ref-datatypes.md#integration-server-sdk-unreal-ref-dataypes-process) オブジェクト。  
+ サーバープロセスと通信するために Amazon GameLift Servers サービスが呼び出す、ゲームサーバーコードで実装されたコールバックメソッドの名前。
+ サーバープロセスがリッスンするポートの番号。
+ Amazon GameLift Servers でキャプチャして保存するゲームセッション固有のファイルへのパス。
必須: はい

### 戻り値
<a name="integration-server-sdk-unreal-ref-processready-return"></a>

正常またはエラーメッセージを伴うエラーの、一般的な結果を返します。

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

[Using the Unreal Engine Plugin](integration-engines-setup-unreal.md#integration-engines-setup-unreal-code) にあるサンプルコードを参照してください。

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

指定されたプレイヤーセッション ID のプレイヤーがサーバープロセスから切断されたことを Amazon GameLift Servers サービスに通知します。それに応じて、Amazon GameLift Servers はプレイヤースロットを新しいプレイヤーに割り当てられるよう利用可能に変更します。

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

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

### パラメータ
<a name="integration-server-sdk-unreal-ref-removeplayersession-parameter"></a>

**playerSessionId**  
 AWS SDK Amazon GameLift Servers API アクション [CreatePlayerSession](https://docs.aws.amazon.com/gamelift/latest/apireference/API_CreatePlayerSession.html) の呼び出しに応答してAmazon GameLift Serversサービスによって発行された一意の ID。ゲームクライアントは、サーバープロセスに接続するときにこの ID をリファレンスします。  
型: FString  
必須: はい

### 戻り値
<a name="integration-server-sdk-unreal-ref-removeplayersession-return"></a>

正常またはエラーメッセージを伴うエラーの、一般的な結果を返します。

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

FlexMatch で作成されたゲームセッションの空きスロット用に新規プレイヤーを検索するリクエストを送信します。 AWS SDK アクション [StartMatchBackfill()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_StartMatchBackfill.html) も参照してください。このアクションを使用すると、ゲームセッションをホストするゲームサーバーのプロセスによってマッチバックフィルリクエストを開始できます。[FlexMatch のバックフィル機能](https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-backfill.html)について。

このアクションは非同期です。新規プレイヤーが正常にマッチングされると、Amazon GameLift Servers サービスはコールバック関数 `OnUpdateGameSession()` を使用して更新済みマッチメーカーデータを送信します。

サーバープロセスではアクティブなマッチバックフィルリクエストは一度に 1 つだけです。新しいリクエストを送信するには、まず [StopMatchBackfill()](#integration-server-sdk-unreal-ref-stopmatchbackfill) を呼び出して元のリクエストをキャンセルする必要があります。

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

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

### パラメータ
<a name="integration-server-sdk-unreal-ref-startmatchbackfill-parameter"></a>

**FStartMatchBackfillRequest**  
次の情報を通信する [FStartMatchBackfillRequest](integration-server-sdk-unreal-ref-datatypes.md#integration-server-sdk-unreal-ref-dataypes-startmatchbackfillrequest) オブジェクト。  
+ バックフィルリクエストに割り当てるチケット ID。この情報はオプションです。ID が指定されていない場合は Amazon GameLift Servers が ID を 1 つ自動生成します。
+ リクエストを送信するマッチメーカー。完全な設定 ARN が必要です。この値は、ゲームセッションのマッチメーカーデータから取得できます。
+ バックフィルされるゲームセッションの ID。
+ ゲームセッションの現在のプレイヤーに利用可能なマッチメーキングデータ。
必須: はい

### 戻り値
<a name="integration-server-sdk-unreal-ref-startmatchbackfill-return"></a>

成功した場合、マッチバックフィルチケットを `FGameLiftStringOutcome` オブジェクトとして返します。成功しなかった場合、エラーメッセージを返します。チケットのステータスは、 AWS SDK アクション [DescribeMatchmaking() ](https://docs.aws.amazon.com/gamelift/latest/apireference/API_DescribeMatchmaking.html)を使用して追跡できます。

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

[StartMatchBackfill()](#integration-server-sdk-unreal-ref-startmatchbackfill) とともに作成されたアクティブなマッチバックフィルリクエストをキャンセルします。 AWS SDK アクション [StopMatchmaking()](https://docs.aws.amazon.com/gamelift/latest/apireference/API_StopMatchmaking.html) も参照してください。[FlexMatch のバックフィル機能](https://docs.aws.amazon.com/gamelift/latest/flexmatchguide/match-backfill.html)について。

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

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

### パラメータ
<a name="integration-server-sdk-unreal-ref-stopmatchbackfill-parameter"></a>

**StopMatchBackfillRequest**  
キャンセルするマッチメーキングチケットを識別する [FStopMatchBackfillRequest](integration-server-sdk-unreal-ref-datatypes.md#integration-server-sdk-unreal-ref-dataypes-stopmatchbackfillrequest) オブジェクト:   
+ キャンセルされるバックフィルリクエストに割り当てられたチケット ID
+ バックフィルリクエストが送信されるマッチメーカー
+ バックフィルリクエストに関連付けられたゲームセッション
必須: はい

### 戻り値
<a name="integration-server-sdk-unreal-ref-stopmatchbackfill-return"></a>

正常またはエラーメッセージを伴うエラーの、一般的な結果を返します。

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

**このメソッドは、バージョン 4.0.1 で非推奨となりました。代わりに、サーバープロセスはゲームセッションが終了した後に [ProcessEnding()](#integration-server-sdk-unreal-ref-processending) を呼び出す必要があります。**

サーバープロセスがゲームセッションをシャットダウンしたことを Amazon GameLift Servers サービスに通知します。このアクションは、サーバープロセスがアクティブなままになり、新しいゲームセッションをホストするための準備ができたときに呼び出されます。これは、新しいゲームセッションをホストするためにサーバープロセスがすぐに利用可能であることを Amazon GameLift Servers に通知するため、ゲームセッション終了手順が完了した後にのみ呼び出す必要があります。

ゲームセッションが停止した後にサーバープロセスがシャットダウンされる場合は、このアクションは呼び出されません。代わりに、[ProcessEnding()](#integration-server-sdk-unreal-ref-processending) を呼び出し、ゲームセッションとサーバープロセスの両方が終了していることを通知します。

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

```
FGameLiftGenericOutcome TerminateGameSession()
```

### パラメータ
<a name="integration-server-sdk-unreal-ref-terminategamesession-parameter"></a>

このアクションにはパラメータがありません。

### 戻り値
<a name="integration-server-sdk-unreal-ref-terminategamesession-return"></a>

正常またはエラーメッセージを伴うエラーの、一般的な結果を返します。

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

現在のゲームセッションの機能を更新し、新しいプレイヤーセッションを承諾します。ゲームセッションは、新しいプレイヤーセッションをすべて受け入れるか拒否するかを設定できます。(*Amazon GameLift Servers サービス API リファレンス*の [https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateGameSession.html](https://docs.aws.amazon.com/gamelift/latest/apireference/API_UpdateGameSession.html) アクションも参照してください)。

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

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

### パラメータ
<a name="integration-server-sdk-unreal-ref-updateplayersessioncreationpolicy-parameter"></a>

**ポリシー**  
ゲームセッションで新しいプレイヤーを承諾するかどうかを示す値。  
型: `EPlayerSessionCreationPolicy` enum。有効な値を次に示します。  
+ **ACCEPT\$1ALL** - すべての新しいプレイヤーセッションを承諾します。
+ **DENY\$1ALL** - すべての新しいプレイヤーセッションを拒否します。
必須: はい

### 戻り値
<a name="integration-server-sdk-unreal-ref-updateplayersessioncreationpolicy-return"></a>

正常またはエラーメッセージを伴うエラーの、一般的な結果を返します。