EOS 大厅集成

本指南将向您展示如何在 Unreal 游戏项目中将 Edgegap 与 EOS 大厅集成在一起工作。某些步骤需要您使用令牌向我们的 API 发送请求， curl 下面提供的命令将允许您预览每个响应，以便确定如何在代码中处理它们。在请求中使用令牌时，请确保保管好 令牌 关键字。

您还需要在我们的平台上为项目设置一个应用版本。在这种情况下，我们建议使用 Edgegap Unreal 插件以加快测试过程。有关该插件的更多信息，您可以阅读我们的文档 这里.

作为一项安全措施，不建议在生产环境中由 EOS 大厅所有者直接将请求发送到 Edgegap API，因为客户端会获取到 API 令牌。您应改为使用单独的服务来管理这些请求。

1. 获取并存储玩家的公网 IP

首先，每位加入大厅的玩家——包括大厅所有者——都需要获取他们的公网 IP 并将其存储为 大厅成员属性.

curl --location --request GET 'https://api.edgegap.com/v1/ip' \
--header 'Authorization: [EDGEGAP_API_TOKEN]'

2. 创建部署

一旦大厅所有者决定比赛准备就绪，需要发送请求在 Edgegap 上创建一个新的部署，使用先前存储的公网 IP 列表。

curl --location --request POST 'https://api.edgegap.com/v1/deploy' \
--header 'Content-Type: application/json' \
--header 'Authorization: [EDGEGAP_API_TOKEN]' \
--data-raw '{
    "app_name": "[EDGEGAP_APP_NAME]",
    "version_name": "[EDGEGAP_APP_VERSION]",
    "ip_list": [
        "[LOBBY_MEMBER_IP]"
    ]
}'

之后，大厅所有者需要使用部署创建请求响应中提供的 request_id 不断轮询该部署。一旦回复中部署的 current_status 设置为 READY，大厅所有者需要将部署的 IP 和端口值设置为 EOS 大厅属性.

curl --location --request GET 'https://api.edgegap.com/v1/status/[REQUEST_ID]' \
--header 'Authorization: [EDGEGAP_API_TOKEN]'

3. 连接到部署

当玩家收到已分配 IP 和端口值的通知后，他们可以将其与客户端缓存进行比较，然后使用这些值连接到服务器以进行比赛。

4. 结束比赛与部署

比赛结束后，大厅所有者将从 EOS 大厅属性中取消设置 IP 和端口值，这会通知其他所有人从服务器优雅断开连接。如果应用配置为注入环境变量，则可以在此时使用这些变量从应用内部终止部署。

要从服务器外部终止部署，可以改为使用如下所示的 curl 命令。

curl --location --request DELETE 'https://api.edgegap.com/v1/stop/[REQUEST_ID]' \
--header 'Authorization: [EDGEGAP_API_TOKEN]'

如果玩家仍然留在大厅，大厅所有者可以从请求新部署开始重复这些步骤，以便与相同的人发起重赛。