本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
Amazon GameLift ServersRealtime客户端 API (C#) 参考：数据类型
此 C# Realtime 客户端 API 参考可以帮助您准备多人游戏，以便在Amazon GameLift Servers舰队上Amazon GameLift ServersRealtime部署时使用。
ClientConfiguration
有关如何将游戏客户端连接到 Realtime 服务器的信息。
内容
- ConnectionType
-
要使用的 client/server 连接类型，无论是安全连接还是非安全连接。如果您未指定连接类型，默认值为不安全。
类型：一个
ConnectionType枚举值。必需：否
ConnectionToken
有关请求与Realtime服务器连接的游戏客户端 and/or 玩家的信息。
内容
- playerSessionId
-
创建新玩家会话Amazon GameLift Servers时颁发的唯一 ID。玩家会话 ID 是在
PlayerSession对象中指定的，该对象是在客户端调用 GameLift API 操作时返回的 StartGameSessionPlacement CreateGameSession、 DescribeGameSessionPlacement、或 DescribePlayerSessions。类型：字符串
必需：是
- payload
-
连接时将传递给Realtime服务器的开发人员定义的信息。这包括可能用于自定义登录机制的任何任意数据。例如，在允许客户端连接之前，负载可提供Realtime服务器脚本要处理的身份验证信息。
类型：字节数组
必需：否
RTMessage
消息的内容和传递信息。消息必须指定目标玩家或目标组。
内容
- opCode
-
标识游戏事件或操作（例如，玩家移动或服务器通知）的开发人员定义操作代码。消息的操作代码为所提供的数据负载提供上下文。使用 NewMessage () 创建的消息已经设置了操作代码，但可以随时更改。
类型：整数
必需：是
- targetPlayer
-
标识作为所发送消息预期收件人的玩家的唯一 ID。目标可以是服务器本身（使用服务器 ID）或其他玩家（使用玩家 ID）。
类型：整数
必需：否
- targetGroup
-
标识作为所发送消息预期收件人的组的唯一 ID。群组 IDs 由开发者定义。
类型：整数
必需：否
- deliveryIntent
-
指示使用可靠 TCP 连接还是使用快速 UDP 通道发送消息。使用NewMessage()创建的消息。
类型： DeliveryIntent 枚举
有效值：FAST | RELIABLE
必需：是
- payload
-
消息内容。此信息根据游戏客户端基于随附操作代码处理的需要进行结构化。它可能包含游戏状态数据或者在游戏客户端之间或在游戏客户端与实时服务器之间进行通信所需的其他信息。
类型：字节数组
必需：否
DataReceivedEventArgs
通过OnDataReceived()回调提供的数据。
内容
- sender
-
标识发起消息的实体的唯一 ID（玩家 ID 或服务器 ID）。
类型：整数
必需：是
- opCode
-
标识游戏事件或操作（例如，玩家移动或服务器通知）的开发人员定义操作代码。消息的操作代码为所提供的数据负载提供上下文。
类型：整数
必需：是
- 数据
-
消息内容。此信息根据游戏客户端基于随附操作代码处理的需要进行结构化。它可能包含游戏状态数据或者在游戏客户端之间或在游戏客户端与实时服务器之间进行通信所需的其他信息。
类型：字节数组
必需：否
GroupMembershipEventArgs
通过OnGroupMembershipUpdated()回调提供的数据。
内容
- sender
-
标识请求组成员资格更新的玩家的唯一 ID。
类型：整数
必需：是
- opCode
-
标识游戏事件或操作的开发人员定义操作代码。
类型：整数
必需：是
- groupId
-
标识作为所发送消息预期收件人的组的唯一 ID。群组 IDs 由开发者定义。
类型：整数
必需：是
- playerId
-
当前 IDs 是指定组成员的玩家列表。
类型：整数数组
必需：是
枚举
为客户端 SDK 定义的枚举定义Amazon GameLift ServersRealtime如下：
- ConnectionStatus
-
-
已连接 — 游戏客户端仅通过 TCP 连接连接到Realtime服务器。无论传递意图如何，所有消息都通过 TCP 发送。
-
CONNECTED_SEND_FAST — 游戏客户端通过 TCP 和 UDP 连接连接到Realtime服务器。但是，通过 UDP 接收消息的功能尚未验证；因此，发送到游戏客户端的所有消息均使用 TCP。
-
CONNECTED_SEND_AND_RECEIVE_FAST — 游戏客户端通过 TCP 和 UDP 连接连接到服务器。Realtime游戏客户端可以使用 TCP 或 UDP 发送和接收消息。
-
CONNECTING - 游戏客户端已发送连接请求，Realtime服务器正在进行处理。
-
DISCONNECTED_CLIENT_CALL — 应游戏客户端的请求，已断开游戏客户端与Realtime服务器的连接。Disconnect()
-
已断开连接-由于客户端断开连接呼叫以外的其他原因，游戏客户端与Realtime服务器断开连接。
-
- ConnectionType
-
-
RT_OVER_WSS_D TLS12 TLS_ — 安全连接类型。
-
RT_OVER_WS_UDP_UNSECURED – 非安全连接类型。
-
RT_OVER_WEBSOCKET – 非安全连接类型。此值不再是首选。
-
- DeliveryIntent
-
-
FAST – 使用 UDP 通道传递。
-
RELIABLE – 使用 TCP 连接传递。
-