互斥活动

简介

当业务方同时运行多个活动，但希望用户只能参与其中一个时，我们可以利用腾讯游戏来联提供的“互斥组”功能。互斥组确保用户在同个互斥组内的活动中只能选择参加一个，通常以用户首次获得奖励的活动为准。

管理端配置

1. 创建互斥组：

首先，新建一个互斥组，如下图所示。

2. 添加活动到互斥组：

接下来，将希望互斥的活动添加到新创建的互斥组中。这样，从当前时间开始，这些活动就会互斥。

3. 取消活动互斥：

如果未来需要取消活动之间的互斥关系，只需简单地删除互斥组即可。

接口说明

1. 检查用户参与活动资格

此接口用于预先检查用户是否已经参与了互斥组中的其他活动。如果确认当前活动没有被加入到任何互斥组，可以跳过此接口。

请求举例

curl -X POST "https://s1.livelink.qq.com/api/user/getActMutexInfo?actId=691&code=Sw4iQUPDf6MsRE8AG8Vyd6xpP5kV70luCih4rdPwKiE%3D&gameId=yl&livePlatId=egame&nonce=10962347&sig=797c7f8a4dee1352de3c25cb3b5d8e5a&t=1610962347&v=2.0"

参数说明

参数	类型	说明	是否必填
livePlatId	string	平台ID，由腾讯游戏来联统一分配。	是
actId	int	活动ID，即立项时的项目ID。	是
gameId	string	业务名称，参考《业务代码》	是
v	float	固定值2.0。	是
t	int	Unix时间戳，以秒为单位。	是
nonce	string	8位随机字符串。	是
code	string	用户登录状态。平台侧可参考《平台侧接入》	是
sig	string	签名，见《加密与签名》	是

输出举例

{
    "iRet":0, // 非零表示接口错误
    "sMsg":"ok",
    "jData":{
        "status":0, // 0-未参与任何活动或活动不属于互斥组; 1-用户已被锁定在当前活动; 2-用户已被锁定在其他活动 
        "msg":""
    },
    "tid":"204594175939816199"
}