C# Class SpotiFire.SessionExtensions

A Session extension method that plays a single track and notifies it's completion.

This single extension-method takes care of unloading (in case there are any other tracks playing), loading, and starting playback of a single track. Then, when the track is complete, it signals the task. This enables for easy programming of behaviour such as playing through an entire playlist, or simply playing random songs non-stop. Queueing is also easily implemented with this method. However, this method is not meant to be used in combinations with the ability to change what track you are currently listening to. If your application (one way or another) allows the user (or some AI) to select a new song, whilst there is one playing, you SHOULD not use this method, as it can have un-wanted sideeffects (in the magnitude of your application crashing and dying horribly).

The inner workings of this method is implemented using the Session.EndOfTrack event. Every time you call this method an event-handler is attatched to the Session.EndOfTrack event. This means that if you call this method again (before the song is finished), it will attatch a second event-handler, and then a third, and so forth. This can probably be resolved (one way or another), but for now, this functionality is not supported.