Using Service Asset URLs

Service AssetURLs can be found in the getServiceInfo method

Cache is optimised at edge locations using these URLs for all images however, for streaming tracks and montages you must use the member AssetUrls so that usage is associated with the member and their region for reporting purposes.

AssetURLs will change from time to time so its important that you reference the getServiceInfo and guest getMember for each session. Further to this the getMember will be called each time a member logs in and/or is persistently logged in. For Example: when art work is replaced in the admin we invalidate the object in cache and change these URLs.

The Asset URL contains parameters which are required to access the specified asset. Replace the parameters in the URL as required before requesting the resource.

Album Art Album image (jpeg)

eg: http://asset.harvestmedia.net/wsalbumart/616899ef /{id}/{width}/{height}

Parameters include:

• ID – the “id” from the album element.

• Width – width of the returned image

• Height – height of the returned image

Note: Width and Height are optional, however if you specify one you must specify the other. If omitted then the URL will return the master artwork (300px x 300px)

Example Album Element:

<album featured=”false” code=”PN8CD 1003″ detail=”Inter Active Sonic Mayem” name=”Gametronix” displaytitle=”Gametronix” id=”755f6215e34d0a3c” />

 

Wave Form Track waveform (png)

eg: http://asset.harvestmedia.net/wswaveform/616899ef/{id}/{width}/{height}/{foregroundColor}/{backgroundColor}

Parameters include:

• ID – the “id” from the track element.

• Width – width of the returned image

• Height – height of the returned image

• Foreground Colour– the desired colour of the wave form

• Background Colour– the desired colour of the background

Width and Height pixels are integer values.

The colour parameters must be passed in as either
- 3 digit RGB is the integer value.
- 6 digit RRGGBB , excluding the pound (#) symbol – e.g. “AAFFBB”, “12de34”.
- 9 digit RRGGBBAA format, excluding the pound (#) symbol – e.g. “AAFFBBCC”, “12de34FF”.

If RGB or RRGGBB are used, the colour is considered opaque. if "AA" is specified, that alpha/opacity will be applied, allowing for semi or fully transparent colours.

Download Download the specified file format

Mateg: http://download.harvestmedia.net/wsdirectdownload/{downloadtoken}

Parameters include:

• downloadtoken – is the download token received from getDownload API call

Note: This URL is used in conjunction with the “getDownload” API call. If this call returns a download token, the “directdownload” asset URL is used to download the asset corresponding to the download token

Montage Wave Form Montage waveform (png)

eg: http://cf.harvestmedia.net/assets/waveforms/montage/616899ef/{id}/{width}/{height}

Parameters include:

• id – the “id” from the album element
• width – width of the returned image
• height – height of the returned image

Note: waveform (png) for album montage

Playlist Art Playlist image (jpeg)

eg: http://download.harvestmedia.net/wstrackdownload/616899ef/{memberaccountid}/{id}/{trackformat}/{trimstart}/{trimend}

Parameters include:

• id – the “id” from the playlist element
• width – width of the returned image
• height – height of the returned image

Playlist Category Art playlist category image (jpeg)


eg: http://cf.harvestmedia.net/assets/playlistcategoryart/616899ef/{id}/{width}/{height}

Parameters include:

• id – the “id” from the playlistcategory element
• width – width of the returned image
• height – height of the returned image

Library Logo Access to the logo for the library at specified dimensions

eg: http://cf.harvestmedia.net/assets/librarylogo/616899ef/{id}/{width}/{height}

Parameters include:

• id – the “id” from the library element 
• width – width of the returned image
• height – height of the returned image

 

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Please sign in to leave a comment.