de.umass.lastfm
Class Radio

java.lang.Object
  de.umass.lastfm.Radio

public class Radio
extends Object

Provides access to the Last.fm radio streaming service.
Note that you have to be a subscriber (or have a special API key) to use this API. Official documentation can be found here: http://www.last.fm/api/radio

Author:

Janni Kovacs

Nested Class Summary

static class

Radio.RadioStation

Method Summary

Playlist	getPlaylist() Fetches a new radio playlist or null if an error occured, such as when the user is not allowed to stream radio (no subscriber).
Playlist	getPlaylist(boolean discovery, boolean rtp) Fetches a new radio playlist.
Playlist	getPlaylist(boolean discovery, boolean rtp, boolean buyLinks, double speedMultiplier, int bitrate) Fetches a new radio playlist.
String	getStationName()
String	getStationUrl()
String	getType()
int	playlistExpiresIn() Returns the playlist expiration value for the last playlist fetchet, or -1 if no playlist has been fetched yet.
static Radio.RadioStation	search(String name, String apiKey) Resolve the name of a resource into a station depending on which resource it is most likely to represent
boolean	supportsDiscovery()
static Radio	tune(Radio.RadioStation station, Locale locale, Session session) Tune in to a Last.fm radio station.
static Radio	tune(Radio.RadioStation station, Session session) Tune in to a Last.fm radio station.
static Radio	tune(String station, Locale locale, Session session) Tune in to a Last.fm radio station.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getType

public String getType()

getStationName

public String getStationName()

getStationUrl

public String getStationUrl()

supportsDiscovery

public boolean supportsDiscovery()

playlistExpiresIn

public int playlistExpiresIn()

Returns the playlist expiration value for the last playlist fetchet, or -1 if no playlist has been fetched yet.

Returns:

playlist expiration in seconds

search

public static Radio.RadioStation search(String name,
                                        String apiKey)

Resolve the name of a resource into a station depending on which resource it is most likely to represent

Parameters:

name - The tag or artist to resolve

apiKey - A Last.fm API key.

Returns:

A Radio.RadioStation or null

tune

public static Radio tune(Radio.RadioStation station,
                         Session session)

Tune in to a Last.fm radio station.

Parameters:

station - An instance of Radio.RadioStation

session - A Session instance

Returns:

a Radio instance

tune

public static Radio tune(Radio.RadioStation station,
                         Locale locale,
                         Session session)

Tune in to a Last.fm radio station.

Parameters:

station - An instance of Radio.RadioStation

locale - The language you want the radio's name in

session - A Session instance

Returns:

a Radio instance

tune

public static Radio tune(String station,
                         Locale locale,
                         Session session)

Tune in to a Last.fm radio station.

Parameters:

station - A lastfm radio URL

locale - The language you want the radio's name in

session - A Session instance

Returns:

a Radio instance

getPlaylist

public Playlist getPlaylist()

Fetches a new radio playlist or null if an error occured, such as when the user is not allowed to stream radio (no subscriber).

Returns:

a new Playlist or null

getPlaylist

public Playlist getPlaylist(boolean discovery,
                            boolean rtp)

Fetches a new radio playlist.

Parameters:

discovery - Whether to request last.fm content with discovery mode switched on

rtp - Whether the user is scrobbling or not during this radio session (helps content generation)

Returns:

a new Playlist

getPlaylist

public Playlist getPlaylist(boolean discovery,
                            boolean rtp,
                            boolean buyLinks,
                            double speedMultiplier,
                            int bitrate)

Fetches a new radio playlist.

Parameters:

discovery - Whether to request last.fm content with discovery mode switched on

rtp - Whether the user is scrobbling or not during this radio session (helps content generation)

buyLinks - Whether the response should contain links for purchase/download, if available

speedMultiplier - The rate at which to provide the stream (supported multipliers are 1.0 and 2.0)

bitrate - What bitrate to stream content at, in kbps (supported bitrates are 64 and 128)

Returns:

a new Playlist