# 互动玩法

# 应用场景

主播开启“互动玩法”后,可在游戏内切换到特定的场景/地图,直播间内的观众,可以通过赠送礼物、发送评论、点赞等方式,触发游戏内不同的特效,整蛊或守护主播的游戏角色。

# 核心步骤

  1. 主播通过schema拉起游戏
  2. 平台接收到游戏开始调用时,开放粉丝侧的送礼、点赞、评论等入口
  3. 平台调用livelink提供的特效接口,触发游戏内的特效
  4. 平台接收到游戏结束调用时,关闭粉丝侧相关入口

# 平台需提供接口

接口签名方式和数据接口保持一致

# 接收游戏对局状态

当主播的游戏角色,开始/结束对局时,会调用该接口通知平台侧。如果接收到”开始“状态,表示游戏已经准备就绪,可以开始渲染特效了,此时平台应该展示对应的点赞、送礼界面给到直播间用户;反之,如果游戏”结束“,平台应该关闭粉丝侧对应的界面。

请求方式:
POST http(s)://xxxxxx

请求结构:
{
    "users":[
        {
            "uid": "xxxx" // 绑定的平台主播ID
        }
    ],
    "game_state":5, // 5游戏开始 6游戏结束
}

响应结构:
{
    "ret":0,
    "tid":"",
    "msg":"ok"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

# livelink提供接口

接口签名方式和数据接口保持一致

# 特效展示

平台侧调用该接口,在主播的游戏角色对局内,控制产生不同的特效。

请求方式:
POST https://welive.qq.com/dataproxy/interaction/showeffect

请求结构:
{
    "plat":"huya",
    "uid":"123",
    "game":"ymzx",
    "ymzx_args":{ // 每个游戏可能不一样
        "gift_id":"1",
        "extra":"xxx" // 游戏侧参数
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13

# 支持的游戏

  • 王者荣耀
  • 和平精英
  • 元梦之星
lastUpdate: 8/7/2025, 10:15:30 AM