WebService::LastFM 0.07

WebService::LastFM provides you a simple interface to Last.FM Web service API. It currently supports Last.FM Stream API 1.2.<br /><br />METHODS ^<br /><br />new(%args)<br /><br /> $lastfm = WebService::LastFM->new(<br /> username => $username,<br /> password => $password,<br /> );<br /><br /> Creates and returns a new WebService::LastFM object.<br />get_session()<br /><br /> $stream_info = $lastfm->get_session;<br /><br /> Returns a session key and stream URL as a WebService::LastFM::Session object.<br />get_new_playlist()<br /><br /> $stream_info = $lastfm->get_new_playlist();<br /><br /> Returns a WebService::LastFM::Playlist that contains a list of tracks based on the current station. You can/should use the get_next_track method to retrieve the WS:LFM:Track object. Once the playlist is depleted (right now 5 tracks) just grab a new playlist.<br /><br /> my $playlist = $lastfm->get_new_playlist();<br /><br /> while ( my $track = $playlist->get_next_track() ) {<br /><br /> print "Playing '".$track->title."' by ".$track->creator."n";<br /><br /> my @cmd = ( 'mpg123' , $track->location() );<br /> system( @cmd );<br /><br /> }<br /><br />get_nowplaying()<br /><br /> $current_song = $lastfm->get_nowplaying;<br /><br /> Returns a WebService::LastFM::NowPlaying object to retrieve the information of the song you're now listening.<br />send_command($command)<br /><br /> $response = $lastfm->send_command($command);<br /><br /> Sends a command to Last.FM Stream API to control the streaming. $command can be one of the follows: skip, love, ban, rtp, or nortp.<br /><br /> $response which you'll get after issuing a command will be either 'OK' or 'FAILED' as a string.<br />change_station($friend)<br /><br /> $response = $lastfm->change_station($friend);<br /><br /> Changes the station of your stream to $friend's one.<br /><br /> $response which you'll get after issuing a command will be either 'OK' or 'FAILED' as a string.<br />change_tag($tag)<br /><br /> $response = $lastfm->change_tag($tag);<br /><br /> Change the station of your stream to play music tagged with $tag.<br /><br /> $response which you'll get after issuing a command will be either 'OK' or 'FAILED' as a string.<br />ua<br /><br /> $lastfm->ua->timeout(10);<br /><br /> Returns the LWP::UserAgent object which is internally used by $lastfm object. You can set some values to customize its behavior.

Requirements:	No special requirements
Platforms:	*nix, Linux
Keyword:	039ok039,  Command,  Failed,  Issuing,  Lastfm,  Lastfmgtget Playlist,  Object,  Playlist,  Response,  Retrieve,  Returns,  Station,  Stream,  Tracks,  Webservicelastfm,  You039ll
Users rating:	0/10