Discord.Addons.Music 0.1.0

Unofficial Discord.Net Addons for Audio

Audio player library for Discord.Net using FFmpeg and Youtube-dl

This project is still in development and not production ready

Requirements

• Libopus & Opus.dll
• Youtube-dl
• FFmpeg

Installation

NuGet

• Discord.Addons.Music

Getting started

This is a basic example on how to use AudioPlayer.

// Initialize AudioPlayer
AudioPlayer audioPlayer = new AudioPlayer();

// Set player's audio client
// This is required for AudioPlayer to create an audio stream to Discord
SocketVoiceChannel voiceChannel = (Context.User as SocketGuildUser)?.VoiceChannel;
var audioClient = await voiceChannel.ConnectAsync();
audioPlayer.SetAudioClient(audioClient);

Playing an audio

To play an audio, we need to load an AudioTrack instance. To do this, we can use TrackLoader class:

string query = "Tuturu Ringtone";
bool wellFormedUri = Uri.IsWellFormedUriString(query, UriKind.Absolute);
List<AudioTrack> tracks = await TrackLoader.LoadAudioTrack(query, fromUrl: wellFormedUri);

// Pick the first entry and use AudioPlayer.StartTrackAsync to play it
AudioTrack firstTrack = tracks.ElementAt(0);
player.StartTrackAsync(firstTrack, interrupt: true);

Handling Audio Event

AudioPlayer implements IAudioEvent and currently there are 3 audio events that can be subscribed:

• OnTrackStartAsync
• OnTrackEndAsync
• OnTrackErrorAsync

For example, a track scheduler:

public class TrackScheduler
{
    public Queue<AudioTrack> SongQueue { get; set; }
    private AudioPlayer player;

    public TrackScheduler(AudioPlayer player)
    {
        SongQueue = new Queue<AudioTrack>();
        this.player = player;
        this.player.OnTrackStartAsync += OnTrackStartAsync;
        this.player.OnTrackEndAsync += OnTrackEndAsync;
    }

    public void EnqueueAsync(AudioTrack track)
    {
        if (player.StartTrackAsync(track, interrupt: false) == false)
        {
            SongQueue.Enqueue(track);
        }
    }

    public void NextTrack()
    {
        player.StartTrackAsync(SongQueue.Dequeue(), interrupt: true);
    }

    private Task OnTrackStartAsync(IAudioClient audioClient, IAudioSource track)
    {
        Console.WriteLine("Track start! " + track.Info.Title);
        return Task.CompletedTask;
    }

    private Task OnTrackEndAsync(IAudioClient audioClient, IAudioSource track)
    {
        Console.WriteLine("Track end! " + track.Info.Title);

        if (SongQueue.Count > 0)
        {
            NextTrack();
        }
        return Task.CompletedTask;
    }
}

Note:

• AudioTrack is actually a PCM AudioSource
• Opus AudioSource is not yet supported

Contributions are very very welcome :]

Example Music Bot

• Example for guild state management and queue system, at ExampleMusicBot project

Contributing

Looking for a constructive feedback, feedback about best practices would really help me out.

Pull requests are very welcome,, Thanks!