Using Asset URLs

AssetURLs can be found in both


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

AssetURLs will change from time to time so its important that you reference the getServiceInfo for each session and getMember 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

Example URL: http://asset.harvestmedia.net/wsalbumart/6168b92550aaaaddd0b49e9476c6093de35899ef /{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

Example URL: 
http://asset.harvestmedia.net/wswaveform/6168b92550aaaaddd0b49e9476c6093de35899ef /{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.

 


Track Stream

URL: http://asset.harvestmedia.net/trackstream/6168b92550aaaaddd0b49e9476c6093de35899ef /{id}

Parameters include:
• ID – the “id” from the track element.

 

Download

URL: 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 Stream

URL: http://cf.harvestmedia.net/assets/samples/montage/6168b92550aaaaddd0b49e9476c6093de35899ef /{id}

Parameters include:

• id – the “id” from the album element

Note: Access to album montage media (fixed format being mp3 96kbps)


Montage Wave Form

URL: http://cf.harvestmedia.net/assets/waveforms/montage/6168b92550aaaaddd0b49e9476c6093de35899ef /{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

URL: http://download.harvestmedia.net/wstrackdownload/6168b92550aaaaddd0b49e9476c6093de35899ef /{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

URL: http://cf.harvestmedia.net/assets/playlistcategoryart/6168b92550aaaaddd0b49e9476c6093de35899ef /{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

URL: http://cf.harvestmedia.net/assets/librarylogo/6168b92550aaaaddd0b49e9476c6093de35899ef /{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.