Nilson Santos Figueiredo Júnior > WebService-Audioscrobbler > WebService::Audioscrobbler::Track

Download:
WebService-Audioscrobbler-0.07.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  2
Open  0
View/Report Bugs
Module Version: 0.07   Source  

NAME ^

WebService::Audioscrobbler::Track - An object-oriented interface to the Audioscrobbler WebService API

SYNOPSIS ^

This module implements an object oriented abstraction of a track within the Audioscrobbler database.

    use WebService::Audioscrobbler::Track;

    my $ws = WebService::Audioscrobbler->new;
    
    # get a track object for the track titled 'bar' by 'foo'
    my $track = $ws->track('foo', 'bar');

    # retrieves the track's tags
    my @tags = $track->tags;

    # prints url for viewing aditional tag info
    print $track->url;

    # prints the tag's artist name
    print $track->artist->name;

This module inherits from WebService::Audioscrobbler::Base.

FIELDS ^

artist

The track's performing artist.

name =head2 title

The name (title) of a given track.

mbid

MusicBrainz ID as provided by the Audioscrobbler database.

url

URL for aditional info about the track.

METHODS ^

new($artist, $title, $data_fetcher)

new(\%fields)

Creates a new object using either the given $artist and $title or the \%fields hashref. The data fetcher object is a mandatory parameter and must be provided either as the second parameter or inside the \%fields hashref.

tags

Retrieves the track's top tags as available on Audioscrobbler's database.

Returns either a list of tags or a reference to an array of tags when called in list context or scalar context, respectively. The tags are returned as WebService::Audioscrobbler::Tag objects by default.

resource_path

Returns the URL from which other URLs used for fetching track info will be derived from.

AUTHOR ^

Nilson Santos Figueiredo Júnior, <nilsonsfj at cpan.org>

COPYRIGHT & LICENSE ^

Copyright 2006-2007 Nilson Santos Figueiredo Júnior, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

syntax highlighting: