获取云游戏详情

更新时间不可用

获取指定云游戏的详情、礼物列表和弹幕指令等信息。

GET
https://{domain}/v2/projects/{appid}/cloud-bullet-game/api/live-data/games/{gameid}

注意

  • 调用频率限制:单个 APP ID 调用上限为 10 次/秒。

路径参数

gameidstring
必填

游戏编号,调用获取云游戏列表获得。

请求 Header

Authorizationstring
必填

发送 HTTP 请求时,你需要将用于游戏推流使用的 RTC Token 填入 HTTP 请求头部的 Authorization 字段。Token 生成方式请参考使用 Token 鉴权。

Content-Typestring
必填

数据类型,必须包含 application/json。

响应

OK

响应 Body

字段
err_nointeger

请求错误码,0 表示请求成功,非 0 表示请求失败,对应的错误原因和解决方案详见响应状态码。

err_msgstring

err_no 为非 0 时附带的错误提示信息。

logidstring

请求链路 id, 用于出现未知问题时提供给声网技术支持以便定位问题。

game_idstring

游戏 ID。

namestring

游戏名称。

vendorstring

游戏商。

thumbnailstring

游戏缩略图路径。

instructarray<unknown>

游戏支持的弹幕指令。

请求示例

Example Request
curl --request GET \
  --url "https://:domain/v2/projects/:appid/cloud-bullet-game/api/live-data/games/:gameid" \
  --header 'Authorization: <string>' \
  --header 'Content-Type: <string>'

响应示例

{
  "game_id": "pkzb",
  "name": "pwnk争霸",
  "vendor": "pwnk",
  "thumbnail": "/game.png",
  "feature": {
    "like": 1,
    "comment": 1
  },
  "gifts": [
    {
      "id": 10000,
      "name": "礼物 1",
      "price": 100,
      "thumbnail": "/gift.png",
      "game_id": "pkzb"
    }
  ],
  "instruct": []
}