UDP API 允许您将二进制文件上传到 UDP 控制台。这让您可以使用 CI 系统来构建您的应用并将输出直接推送到 UDP。请参阅在 UDP 控制台上管理和发布您的游戏。
支持以下文件类型:
API 结构如下所示: https://distribute.dashboard.unity.com/developer/api/upload/:orgId/:clientId?token=xxxxxx[&obbType=xxxx]
下表描述了 API 的参数。
参数 | 描述 |
---|---|
orgId |
要为其上传二进制文件的游戏的组织 ID。 |
clientId |
要为其上传二进制文件的游戏的客户端 ID。 |
token |
在 UDP 控制台中生成的授权令牌,位于“开发者 API”页面上。 |
obbType |
您要上传的 OBB 文件类型。以下值有效: - mainObb - patchObb 您只需要在上传 OBB 文件时指定该查询参数。 |
在将构建上传到 UDP 时,您可以在 POST 方法中使用表单键来指定值。这些值对应于“游戏信息”选项卡的“二进制文件”部分。
下表描述了表单键。
表单键 | 描述 | 必需/可选 |
---|---|---|
uploadFile |
指定要上传的文件的路径。 | 必需 |
whatsNew |
在 UDP 控制台中设置新增功能字段的值。 | 可选 |
useGoogleService |
在 UDP 控制台中设置您的游戏是否使用 Google Play 服务?字段的值。 | 可选 |
如果您不指定可选键,UDP 将使用您游戏的最新版本的值。
如果您提供无效的身份验证令牌,您将收到状态代码为 401 的错误消息。
{"errorCode":"NotAuthenticated","message":"not authenticated error","target":"","details":null}
如果您提供无效的组织 ID 或无效的客户端 ID,您将收到状态代码为 400 的错误消息。
{"errorCode":"InvalidParameter","message":"The given parameter is missing or invalid","target":"Invalid OrgId or ClientId","details":null}
如果您提供无效的文件类型,您将收到状态代码为 400 的错误消息。
{"errorCode":"InvalidParameter","message":"The given parameter is missing or invalid: please provide the right binary file(APK, AAB or OBB)","target":"file type","details":null}
如果您提供无效的 OBB 类型,您将收到状态代码为 400 的错误消息。
{"errorCode":"InvalidParameter","message":"The given parameter is missing or invalid","target":"obbType","details":null}
如果您提供无效的内容类型,您将收到状态代码为 400 的错误消息。
{"errorCode":"InvalidParameter","message":"The given parameter is missing or invalid","target":"content type","details":null}