版本配置工作流程

警告:此内容是该文档的预览版。完整的文档以及代码示例仍在制作中。若有任何反馈,请通过本页底部的反馈机制来提供。

版本配置工作流程包括获取版本获取(或创建)版本配置更新版本配置

在使用版本工作流程之前,必须具备 CCD API 密钥和具有以下角色的 UGS 服务帐户:

  • Multiplay API 查看者
  • Multiplay API 编辑者

请参阅项目角色服务帐户身份验证

注意:在这整个工作流程中,您都需要使用您的 Unity Project ID 和环境 ID。您可以在项目设置页面上找到 Project ID 并在环境页面上找到环境 ID。

下图显示了该工作流程的简化版本:

版本配置工作流程图

获取版本

可以使用获取版本列表 API 按名称获取版本 ID。请参阅版本上传工作流程

注意:请确保保存版本 ID。如果您已有版本 ID,则请继续获取版本配置

获取版本配置

获取版本配置的过程取决于您要使用现有版本配置还是创建新版本配置。如果您选择使用现有版本配置但要对其进行更新,请参阅更新版本配置

按名称获取现有版本配置

可以使用列出版本配置 API 按名称获取版本配置 ID。如果要更新现有版本配置,请参阅更新版本配置

以下代码示例显示了如何使用 curl 获取现有版本

curl -X GET -H "Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS>"https://services.api.unity.com/multiplay/build-configurations/v1/projects/{projectId}/environments/{environmentId}/build-configurations

请参阅列出版本配置 API 文档(了解示例响应体)和参数文档。

创建新版本配置

可以使用创建版本配置 API 来创建版本配置。

以下代码示例显示了如何使用 curl 获取现有版本

curl -X POST -H "Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS>" -H "Content-Type: application/json" \
    -d '{"binaryPath": "/path/to/bin", "buildID": <BUILD_ID>, "commandLine": "--init game.init", "configuration": [{}], "cores": 2,"memory": 4000, "name": "Foo name", "queryType": "sqp", "speed": 400}' \
    https://services.api.unity.com/multiplay/build-configurations/v1/projects/{projectId}/environments/{environmentId}/build-configurations

请参阅创建版本配置 API 文档(了解示例响应体)和参数文档。

更新版本配置

可以使用更新版本配置 API 来更新版本配置。

注意:仅更新您正在使用的现有版本配置。如果您要创建新版本配置,则无需使用更新工作流程。

以下代码示例显示了如何使用 curl 获取现有版本

curl -X PUT -H "Authorization: Basic <SERVICE_ACCOUNT_CREDENTIALS>" \
    -d '{"binaryPath": "/path/to/bin", "buildID": <BUILD_ID>,  "commandLine": "--init game.init", "configuration": [{"id": 5, "key": "game_mode", "value": "death_match"}], "cores": 2,  "memory": 4000, "name": "Foo name", "queryType": "sqp", "speed": 400}' \
    https://services.api.unity.com/multiplay/build-configurations/v1/projects/{projectId}/environments/{environmentId}/build-configurations/{buildConfigurationId}

请参阅更新版本配置 API 文档(了解示例响应体)和参数文档。