如何在Discord.net的GuildMemberUpdated中检测用户角色变化？

核心实现步骤 #

• 注册GuildMemberUpdated事件：这是Discord.Net官方提供的监听服务器成员信息更新的事件，角色变更属于成员信息变动的范畴。
• 对比角色差异：在事件回调中，通过OldMember和NewMember的Roles集合做对比，筛选出新增或移除的角色。
• 按需执行操作：根据角色增减情况编写对应业务逻辑；若没有角色变化，直接返回即可。

代码示例 #

// 客户端初始化时注册事件
_client.GuildMemberUpdated += HandleGuildMemberUpdated;

// 事件处理方法
private async Task HandleGuildMemberUpdated(Cacheable<SocketGuildUser, ulong> oldMember, SocketGuildUser newMember)
{
    // 获取旧成员的缓存数据
    var oldUser = await oldMember.GetOrDownloadAsync();
    if (oldUser == null) return;

    // 提取角色ID集合用于对比
    var oldRoleIds = oldUser.Roles.Select(r => r.Id).ToHashSet();
    var newRoleIds = newMember.Roles.Select(r => r.Id).ToHashSet();

    // 检查角色是否有变化
    if (!oldRoleIds.SetEquals(newRoleIds))
    {
        // 找出新增和移除的角色ID
        var addedRoleIds = newRoleIds.Except(oldRoleIds);
        var removedRoleIds = oldRoleIds.Except(newRoleIds);

        // 执行新增角色后的操作
        foreach (var roleId in addedRoleIds)
        {
            var role = newMember.Guild.GetRole(roleId);
            await newMember.SendMessageAsync($"你获得了角色：{role.Name}");
        }

        // 执行移除角色后的操作
        foreach (var roleId in removedRoleIds)
        {
            var role = newMember.Guild.GetRole(roleId);
            await newMember.SendMessageAsync($"你失去了角色：{role.Name}");
        }
    }
    // 无角色变化时直接返回，无需额外处理
}

关键注意事项 #

• 权限配置：确保机器人拥有GuildMembers相关网关权限，初始化客户端时需指定：

  var config = new DiscordSocketConfig
  {
      GatewayIntents = GatewayIntents.Guilds | GatewayIntents.GuildMembers,
      AlwaysDownloadUsers = true
  };
  var _client = new DiscordSocketClient(config);
  

• 缓存问题：如果OldMember获取不到数据，检查客户端缓存设置是否开启了成员缓存。
• 事件过滤：GuildMemberUpdated会在成员昵称、头像等任何信息变更时触发，必须通过角色集合对比过滤出仅角色变化的场景，避免无效执行。

内容的提问来源于stack exchange，提问作者EinForumModAML