使用Nextcord与Wavelink开发音乐Slash Command时的参数类型配置问题求助

我完全懂你遇到的困扰——Slash命令的参数类型必须是Discord官方支持的原生类型（比如str、int），不能直接用wavelink.YouTubeTrack这种自定义类型，这也是从文本命令迁移到Slash命令时很常见的卡点。下面是具体的解决思路和修正后的代码：

核心思路 #

1. 把song参数的类型改为str，让用户输入歌曲的名称或YouTube链接
2. 在命令内部调用Wavelink的搜索API，将用户输入的字符串转换为wavelink.YouTubeTrack对象
3. 处理搜索结果为空的边界情况，给用户明确的错误提示
4. 修正原代码里的语法错误（比如Player初始化的写法、未加引号的字符串）

修正后的完整代码 #

@drav.slash_command(name='play', description='Plays a song', guild_ids=[server])
async def play(interaction: Interaction, song: str):
    await interaction.response.defer(ephemeral=True, with_message=True)
    
    # 检查用户是否在语音频道
    if not getattr(interaction.user.voice, "channel", None):
        return await interaction.followup.send(
            embed=nextcord.Embed(title=':x: Join a voice channel yourself first!', color=nextcord.Colour.red())
        )
    
    # 连接到语音频道或获取已存在的客户端
    if not interaction.guild.voice_client:
        vc = await interaction.user.voice.channel.connect(cls=wavelink.Player)
    else:
        vc: wavelink.Player = interaction.guild.voice_client
        # 额外检查：如果机器人在其他频道，提示用户
        if vc.channel != interaction.user.voice.channel:
            return await interaction.followup.send(
                embed=nextcord.Embed(title=':x: I\'m already in another voice channel!', color=nextcord.Colour.red())
            )
    
    # 搜索歌曲并转换为YouTubeTrack
    try:
        # 搜索用户输入的内容，返回第一个结果
        track = await wavelink.YouTubeTrack.search(song, return_first=True)
        if not track:
            return await interaction.followup.send(
                embed=nextcord.Embed(title=':x: No songs found matching your query!', color=nextcord.Colour.red())
            )
    except Exception as e:
        return await interaction.followup.send(
            embed=nextcord.Embed(title=':x: Failed to search for the song!', description=str(e), color=nextcord.Colour.red())
        )
    
    # 播放歌曲
    await vc.play(track)
    await interaction.followup.send(
        embed=nextcord.Embed(title=':musical_note: Now Playing!', description=f'[{track.title}]({track.uri})', color=nextcord.Colour.green())
    )

关键修改点说明 #

• 参数类型调整：将song: wavelink.YouTubeTrack改为song: str，符合Slash命令的参数要求
• 搜索逻辑添加：用wavelink.YouTubeTrack.search()将用户输入的字符串转为可播放的Track对象，return_first=True直接取第一个搜索结果
• 边界情况处理：增加了搜索无结果、机器人在其他频道的提示，让交互更友好
• 语法错误修正：原代码中vc = wavelink.Player = await...是错误的写法，改为正确的vc = await ... connect(cls=wavelink.Player)；同时修复了Playing!未加引号的问题，改用Embed展示播放信息更美观

这样修改后，你的Slash命令就能正常注册，并且可以通过用户输入的歌曲名称/链接来播放音乐了。

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