文档

支持

Multiplay Hosting

Multiplay Hosting

版本配置工作流程

Follow this workflow to create and manage build configurations using the API.
阅读时间3 分钟最后更新于 15 天前
版本配置工作流程包括获取版本、获取（或创建）版本配置和更新版本配置。 在使用版本工作流程之前，必须具备 CCD API 密钥和具有以下角色的 UGS 服务帐户：
  • Multiplay API 查看者
  • Multiplay API 编辑者
请参阅项目角色和服务帐户身份验证。 下图显示了该工作流程的简化版本：
版本配置工作流程图

版本配置工作流程图

获取版本

可以使用获取版本列表 API 按名称获取版本 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 文档（了解示例响应体）和参数文档。