Skip to content

Latest commit

 

History

History
89 lines (61 loc) · 3.95 KB

README.md

File metadata and controls

89 lines (61 loc) · 3.95 KB
Raw

wp-api-client

This codebase contains the Nokia Music Windows Phone API.

##Overview The Nokia Music Windows Phone API lets you easily integrate your Windows Phone applicaton with Nokia Music on Nokia Lumia phones. The API offers two levels of integration; the simplest and quickest to get going is to use the high-level Launcher Tasks, with more advanced integration available to perform searches and get recommendations within your app.

##License The Nokia Music Windows Phone API is released under the 3-clause license ("New BSD License" or "Modified BSD License") - see https://raw.github.com/nokia-entertainment/wp-api-client/master/LICENSE.txt.

##Usage

##Releases

  • 1.1.0 - A tidy-up release. We have removed optional paging parameters that had incorrectly been included on the GetMixes and GetProduct methods and removed some unneeded properties from the Location type.
  • 1.0.9 - Added Name to Artist Origin object, added AppToAppUri properties to Artist, Mix and Product
  • 1.0.8 - Added GetProduct and GetSimilarProducts
  • 1.0.7 - Added Gzip support
  • 1.0.6 - Fixed MusicSearchTask bug where searching artists with spaces did not work, added LocationConverter for working with Maps control, added exclusiveTag for exclusive mixes
  • 1.0.5 - Added RequestTimeout property to client, fix for location search querystring formatting
  • 1.0.4 - Added Thumb50 property for Artist, Mix and Product types; Added location-based search
  • 1.0.3 - Added Search Suggestions for artists and products
  • 1.0.2 - Initial Release

Launcher Tasks

The launcher APIs in Windows Phone allow an application to integrate with common operating system tasks such as taking a picture, finding an address or a contact, making a call, or saving a ring tone with very little effort.

With the high-level Launchers, you can perform the following using the new app-to-app APIs that Nokia Music supports on Windows Phone 8:

  • Launch the Nokia Music app
  • Search for music
  • Show Artist details
  • Show Gigs nearby
  • Show available mixes
  • Show product details
  • Play a mix

API Methods

With the lower-level API access, you get more control and can perform the following use cases within your app:

  • Search for content
  • Get top artists
  • Get charts
  • Get new releases
  • Get a list of genres
  • Get albums and tracks by an artist
  • Get artist recommendations
  • Get a list of available mixes

Documentation

The documentation for this component is at http://nokia.ly/wpmusicapidoc

Dependencies

We're proud to build on the shoulders of the following giants...

The projects make use of NuGet to install these components at build time.

Tools required to develop

  • Visual Studio 2010 for Windows Phone 7 development
  • Visual Studio 2012 for Windows Phone 8 development

Contributing

If you want to contribute to the project, check out the Issues tab.

You can:

  • Raise an issue
  • Suggest a feature for the application

Feeling like writing some code? Why not take the next step:

  • Fork the repository
  • Make the changes to the codebase
  • Send a pull request once you're happy with it

The team will then review the changes, discuss if anything needs to be addressed, and integrate your changes back into the application.