翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
リアルタイムサーバークライアント API (C#) リファレンス: 非同期コールバック
この C# リアルタイムクライアント API リファレンスを使用して、Amazon GameLift フリートにデプロイされているリアルタイムサーバーで使用するためのマルチプレイヤーゲームを準備してください。統合プロセスの詳細については、「リアルタイムサーバーを準備する」を参照してください。
ゲームクライアントは、イベントに応答するためにこれらのコールバックメソッドを実装する必要があります。リアルタイムサーバーはこれらのコールバックを呼び出して、ゲーム関連の情報をゲームクライアントに送信します。同じイベントのコールバックは、リアルタイムサーバースクリプトのカスタムゲームロジックでも実装できます。「リアルタイムサーバーのスクリプトコールバック」を参照してください。
コールバックメソッドは ClientEvents.cs で定義されています。
OnOpen()
サーバープロセスがゲームクライアントの接続リクエストを受け入れて接続を開くと呼び出されます。
構文
public void OnOpen()
パラメータ
このメソッドにはパラメータはありません。
戻り値
このメソッドは何も返しません。
OnClose()
ゲームセッションの終了後など、サーバープロセスがゲームクライアントとの接続を終了したときに呼び出されます。
構文
public void OnClose()
パラメータ
このメソッドにはパラメータはありません。
戻り値
このメソッドは何も返しません。
OnError()
リアルタイムクライアント API リクエストに障害が発生したときに呼び出されます。このコールバックは、さまざまな接続エラーを処理するようにカスタマイズできます。
構文
private void OnError(byte[] args)
パラメータ
このメソッドにはパラメータはありません。
戻り値
このメソッドは何も返しません。
OnDataReceived()
ゲームクライアントがリアルタイムサーバーからメッセージを受信したときに呼び出されます。これは、メッセージと通知がゲームクライアントによって受信される主な方法です。
構文
public void OnDataReceived(DataReceivedEventArgs dataReceivedEventArgs)
パラメータ
- dataReceivedEventArgs
-
メッセージのアクティビティに関連する情報。
必須: はい
戻り値
このメソッドは何も返しません。
OnGroupMembershipUpdated()
プレイヤーが属するグループのメンバーシップが更新されたときに呼び出されます。このコールバックは、クライアントが RequestGroupMembership を呼び出すときにも呼び出されます。
構文
public void OnGroupMembershipUpdated(GroupMembershipEventArgs groupMembershipEventArgs)
パラメータ
- groupMembershipEventArgs
-
グループメンバーシップアクティビティに関連する情報。
必須: はい
戻り値
このメソッドは何も返しません。
