gracenote/gracenote

A PHP library for abstracting the Gracenote API

dev-master 2013-05-28 03:51 UTC

Requires

• php: >=5.3.3
• zendframework/zendframework: 2.*,!=2.0.6

MIT

• Tom Anderson

• zf2
• music
• gracenote

README

This is a library to abstract the Gracenote API

Installation

1. edit composer.json file with following contents:

   "require": {
      "gracenote/gracenote": "dev-master"
   }

2. install composer via curl -s http://getcomposer.org/installer | php (on windows, download http://getcomposer.org/installer and execute it with PHP)

3. run php composer.phar install

Use

Configure the service

use Gracenote\Service\Gracenote;

Gracenote::configure($clientId, $userId);

If you do not have a userId you may fetch one by setting your clientId and running

Gracenote::register();

Run a query

$simpleXmlResult = Gracenote::query('ALBUM_SEARCH', array(
    'mode' => 'SINGLE_BEST_COVER',
    'parameters' => array(
        'ARTIST' => 'the bengals',
        'ALBUM_TITLE' => 'different light',
        'TRACK_TITLE' => 'walk like an egyptian'
    ),
    'options' => array(
        'SELECT_EXTENDED' => 'COVER,REVIEW,ARTIST_BIOGRAPHY,ARTIST_IMAGE,ARTIST_OET,MOOD,TEMPO',
        'SELECT_DETAIL' => 'GENRE:3LEVEL,MOOD:2LEVEL,TEMPO:3LEVEL,ARTIST_ORIGIN:4LEVEL,ARTIST_ERA:2LEVEL,ARTIST_TYPE:2LEVEL',
    ),
));

The Gracenote API will return a SimpleXmlElement of the results