本文记录火山引擎云游戏服务端 OpenAPI 功能变更和相关文档的动态。
说明
OpenAPI 文档对白名单用户开放,如有需要请联系技术支持。
接口名称 | 变更说明 |
---|---|
GetDailyMaxQueueLength | (手游)新增接口:在游戏排队场景下,查询指定业务某个资源套餐下每日的最大队列长度。支持查询当前时间前 180 天至前 1 天的数据。 |
接口名称 | 变更说明 |
---|---|
CreateFrameworkApp | (端游)新增接口:在云游戏平台上新增伴随程序。 |
UpdateFrameworkApp | (端游)新增接口:通过指定伴随程序 ID,更新已创建伴随程序的名称和启动时机。 |
DeleteFrameworkApp | (端游)新增接口:删除指定伴随程序。 |
ManageGameFrameworkApp | (端游)新增接口:伴随程序上架完成后,需要将其与目标业务下的游戏 ID 相绑定。调用本接口为指定游戏配置伴随程序。 |
ListFrameworkApp | (端游)新增接口:查询当前账号下已创建的伴随程序信息。 |
ListGameFrameworkApp | (端游)新增接口:查询指定游戏已配置的伴随程序。 |
CreateGame | (端游)接口变更:预付费套餐类型新增入门型(PCX86_Entry ),适用于超小型游戏。 |
GetProductCapacity | |
GetGameCapacity | |
PreAllocateResource | |
CreateDeployStrategy | |
GetDailyMaxQueueLength |
接口名称 | 变更说明 |
---|---|
ListGameReservedID | (端游)新增接口:返回指定游戏 ID 下有效的资源预锁定 ID 列表 |
接口名称 | 变更说明 |
---|---|
GameRestart | (端游)新增接口:重启云端游戏进程 |
BatchStopGame | 新增接口:批量停止指定 ReservedId 的云游戏服务 |
接口名称 | 变更说明 |
---|---|
Preupload | (端游)新增接口:上传游戏文件到火山引擎对象存储 TOS 前,获取上传游戏文件所需的必要信息 |
CreateGame | (端游)新增接口:在指定业务下注册游戏 |
CheckGame | (端游)新增接口:检查游戏包名称或游戏版本号的唯一性 |
CreateGameVersion | (端游)新增接口:创建游戏版本,全量更新或增量更新游戏 |
ListGame | (端游)接口变更:在返回参数中,增加”游戏包 ID“字段(game_package_id )、”游戏包版本 ID“字段(game_version_id )、”升级中游戏包版本 ID“字段(gray_game_version_id ) |
接口名称 | 变更说明 |
---|---|
ExitUserQueue | (手游)在请求参数中,新增(DeviceId )可选参数,支持用户指定设备退出游戏排队 |
ExitUserQueue | (端游)新增接口:用户主动退出游戏排队 |
GetDailyMaxQueueLength | (端游)新增接口:在游戏排队场景下,查询指定业务某个资源套餐前一日的最大队列长度 |
接口名称 | 变更说明 |
---|---|
CreateProduct | (手游)在当前账号下,创建云游戏业务 |
DeleteProduct | (手游)删除已创建的云游戏业务 |
CreatePrePaidOrder | (手游)订购预付费实例资源 |
CreatePostPaidOrder | (手游)订购后付费实例资源 |
CreateProduct | (端游)在当前账号下,创建云游戏业务 |
DeleteProduct | (端游)删除已创建的云游戏业务 |
CreatePrePaidOrder | (端游)订购预付费实例资源 |
CreatePostPaidOrder | (端游)订购后付费实例资源 |
UpdateAppliedResource | (端游)修改已订购后付费资源套餐的实例数量 |
接口名称 | 变更说明 |
---|---|
GetCgUsedNum | 查询指定时间内业务维度或游戏维度累计使用资源总量 |
接口名称 | 变更说明 |
---|---|
GamePreStart | 启动云端游戏服务,但不进行推流 |
GetGameSessionStatus | 查询云端游戏服务状态 |
接口名称 | 变更说明 |
---|---|
DetailParseTask | 在返回结果中,增加“上传文件类型”字段(file_type )和“游戏数据包信息”(data_package )相关说明 |
CreateGame | 在“游戏版本信息”(game_version )请求体中,增加“上传文件类型”(file_type )、“obb数据包解压路径”(data_storage )、“游戏数据包信息”(data_package )可选参数 |
接口名称 | 变更说明 |
---|---|
CaptureScreen | 对当前云端游戏发起截图请求(异步任务)。 |
接口名称 | 变更说明 |
---|---|
CancelFrameworkAppVersion | (新增接口)取消版本程序版本发布 |
ListGame | 在返回结果中,增加“默认伴随程序列表”字段(inner_fw_id_list ) |
ListFrameworkApp | 在返回结果中,增加“伴随程序当前版本ID”字段(current_version ) |
ListGameFrameworkApp | 在返回结果中,增加“伴随程序的上传来源”字段(fw_source ),标识伴随程序是由客户上传或默认上传 |
可订购的实例资源套餐 ID(configuration_code
参数)增加 ARMSoC_Standard
(基础型)。
本次发布包含以下新增接口:
接口名称 | 接口功能 |
---|---|
HotUpdateGame | 对指定游戏进行热更操作。 |
HotUpdateGameStatus | 查询游戏热更任务执行的结果。 |
本次发布包含以下接口变更:
接口名称 | 接口功能 |
---|---|
ListGame | 在返回结果中,增加游戏默认键位映射配置字段(default_key_mapping_list ) |
DetailGame | 在返回结果中,增加游戏默认键位映射配置字段(default_key_mapping_list ) |
CreateDeployStrategy | 在请求参数中增加通过指定部署策略列表(strategy_list ),支持按优先级为游戏配置多个实例套餐资源(通过 configuration_code 参数配置一个实例套餐资源的功能将被逐步废弃) |
UpdateDeployStrategy | 在请求参数中增加通过指定部署策略列表(strategy_list ),支持按优先级为游戏配置多个实例套餐资源(通过 configuration_code 参数配置一个实例套餐资源的功能将被逐步废弃) |
ListDeployStrategy | 更新返回结果说明和返回示例 |
PreAllocateResource | 在返回结果中,增加预锁定的实例资源套餐 ID 字段(configuration_code ) |
本次发布包含以下新增功能和变更:
game_status
新增游戏上架状态值 “5”(表示游戏新版本发布取消)。本次发布包含以下新增功能和变更:
device_id
(客户端用户设备 ID)。详细信息,参考 PreAllocateResource。client_user_id
(自定义客户端用户 ID)。详细信息,参考 PreAllocateResource。本次发布包含以下新增功能和变更:
custom_game_id
)。在调用以下接口时,可选择指定 game_id
或 custom_game_id
进行相关操作:
发布第一版 OpenAPI 文档。