IF.Lastfm/doc/scrobbling.md

Scrobbling

Quickstart

Create the scrobbler class:

var auth = new LastAuth(key, secret);
var scrobbler = new Scrobbler(auth);

Or if using a SQLite database:

var scrobbler = new SQLiteScrobbler(auth, databasePath);

then

var scrobble = new Scrobble("65daysofstatic", "The Fall of Math", "Hole", DateTimeOffset.UtcNow);

var response = await scrobbler.ScrobbleAsync();

if (response.Success)
{
	// The scrobble was either successfully sent or has been cached to be sent later.
	bool scrobbleCached = response.Status == LastResponseStatus.Cached;
}
else
{
	if (response.Status == LastResponseStatus.RequestFailed)
	{
		// response.Exception contains info on the http request failing
	}
	else if (response.Status == LastResponseStatus.CacheFailed)
	{
		// response.Exception contains info on the caching mechanism failing
	}
}

Extensibility

IF.Lastfm.Core.Scrobblers.Scrobbler, the core implementation of IScrobbler doesn't cache failed requests.

The ScrobblerBase class provides the mechanism for caching scrobbles. Classes deriving it may implement scrobble caching using an external database - if the scrobble request fails, then it will be saved to a database to be sent later. Currently, any cached scrobbles can either be sent when ScrobbleAsync(Scrobble s) is next called, or independently by calling SendCachedScrobblesAsync().

SQLite

The IF.Lastfm.SQLite.SQLiteScrobbler class enables scrobble caching using a SQLite database.

This is in the NuGet package:

Install-Package Inflatable.Lastfm.SQLite

Dependencies:

• Newtonsoft.JSON
• Inflatable.Lastfm
• sqlite-net-pcl