Discord Python:如何无需静音角色实时静音指定语音频道用户?
当然可以实现!你遇到的问题其实是Discord的一个小机制:修改频道权限后,用户当前的语音会话不会自动刷新权限设置,必须触发一次会话重置才能让新的权限规则生效。下面给你两种不用创建「Muted」角色的Python实现方案:
方案一:临时移动用户触发权限刷新(最可靠)
这个方法的核心思路是通过短暂移动用户来强制Discord重新加载用户的频道权限,操作简单且稳定:
- 先修改目标用户在指定语音频道的发言权限为禁用状态
- 将用户暂时转移到一个临时语音频道,再移回原频道,以此触发权限刷新
代码示例
async def mute_user_in_specific_channel(guild: discord.Guild, user: discord.Member, target_voice_channel: discord.VoiceChannel): # 先检查用户是否确实在目标语音频道里 if not user.voice or user.voice.channel != target_voice_channel: return # 1. 设置频道权限:禁止该用户在目标频道发言 await target_voice_channel.set_permissions(user, speak=False) # 2. 准备临时频道(优先找已有的临时频道,没有就新建) temp_channel = discord.utils.get(guild.voice_channels, name="TempMuteHolder") if not temp_channel: temp_channel = await guild.create_voice_channel( name="TempMuteHolder", category=target_voice_channel.category # 和原频道同分类,避免用户困惑 ) try: # 短暂移动用户到临时频道再移回原频道 await user.move_to(temp_channel) await user.move_to(target_voice_channel) finally: # 清理临时频道(可选,不想保留的话就删掉) await temp_channel.delete()
注意事项
- 你的机器人需要拥有这几个权限:Manage Channels(创建/删除临时频道)、Move Members(移动用户)、Manage Permissions(修改频道权限)
- 如果服务器里已有闲置的语音频道,可以直接用它代替临时创建的频道,省去创建/删除的步骤
方案二:调用Discord API强制刷新权限(不推荐)
如果你不想移动用户,可以直接调用Discord的API来触发权限刷新,但这个方法不够稳定(Discord可能调整API端点),而且需要手动处理HTTP请求:
代码示例
import aiohttp async def refresh_permissions_to_mute(user: discord.Member, target_voice_channel: discord.VoiceChannel): # 先修改频道权限 await target_voice_channel.set_permissions(user, speak=False) # 获取机器人的Token bot_token = user.bot.http.token # 调用Discord API触发用户语音状态刷新 api_url = f"https://discord.com/api/v9/guilds/{target_voice_channel.guild.id}/members/{user.id}/voice" headers = {"Authorization": f"Bot {bot_token}"} async with aiohttp.ClientSession() as session: # 发送空的PATCH请求,强制刷新用户的语音权限状态 await session.patch(api_url, headers=headers, json={})
补充说明
如果你只是需要临时静音用户,不需要持久化的权限限制,其实可以用全局静音(await user.edit(mute=True)),但这会让用户在所有语音频道都无法发言,不符合你「特定频道静音」的需求,所以还是优先选择方案一。
内容的提问来源于stack exchange,提问作者SevaOle
相关产品推荐
相关产品推荐

