Skip to content
This repository has been archived by the owner on Oct 12, 2022. It is now read-only.

Latest commit

 

History

History
166 lines (121 loc) · 5.59 KB

README.md

File metadata and controls

166 lines (121 loc) · 5.59 KB
Raw

Music Explorer

Music Explorer is an example application demonstrating the use of Nokia Music API together with standard Windows Phone 8 audio features to create an immersive music experience. It shows how to take advantage of Nokia Music API features such as searching for artists by name and requesting top artists and new releases, and it also shows how to launch Nokia Music application from within another application to play mix radio or show artist/product information.

Full panorama

The example has been developed with Silverlight for Windows Phone devices and tested to work on Lumia devices with Windows Phone 8.

This example application is hosted in GitHub: https://github.com/Microsoft/music-explorer

For more information on implementation and porting, visit Lumia Developer's Library: http://developer.nokia.com/Resources/Library/Lumia/#!code-examples/music-explorer.html

  1. Usage

This is a simple build-and-run solution. Learn about what you can do with Nokia Music API related features by trying out the application.

  1. Prerequisites
  • C# basics
  • Windows 8
  • Microsoft Visual Studio Express for Windows Phone 2012
  • NuGet 2.1 (https://nuget.org/), Visual Studio extension to install and update third-party libraries and tools in Visual Studio
  1. Project structure and implementation

3.1 Folders

  • The root folder contains the project file, the license information and this file (release_notes.txt).
  • MusicExplorer: Root folder for the implementation files.
  • Assets: Graphic assets like icons and tiles.
  • Properties: Application property files.
  • Resources: Application resources.
  • Models: MainViewModel and models to bind data and user interface.

3.2 Important files and classes

File Description
ArtistPage.xaml The page showing artist specific info in a pivot component.
ArtistPage.xaml.cs The code-behind file of the artist page.
MainPage.xaml The main page of the application with the panorama component.
MainPage.xaml.cs The code-behind file of the main page.
MusicApi.cs Class responsible of communicating with the Nokia Music API.
MainViewModel.cs Binds data and user interface.
Class Description
ArtistPage This class handles almost half of the UI.
MainPage This class handles almost half of the UI.
MainViewModel This class is responsible for binding the data and UI together.
MusicApi This class is responsible for all the communication to Nokia Music API.

3.3 Used APIs/Windows Phone Components

  • Microsoft.Phone.Maps.Services
  • Microsoft.Phone.Controls.Toolkit
  • Microsoft.Xna.Framework
  • Microsoft.Xna.Framework.Media
  • Newtonsoft.Json
  • Nokia.Music.Wp8
  • System.Device.Location
  • Windows.Devices.Geolocation
  1. Compatibility
  • Windows Phone 8

Tested to work on Nokia Lumia 920 and Nokia Lumia 1520. Developed with Microsoft Visual Studio Express for Windows Phone 2012.

4.1 Required Capabilities

  • ID_CAP_LOCATION
  • ID_CAP_MAP
  • ID_CAP_MEDIALIB_AUDIO
  • ID_CAP_MEDIALIB_PLAYBACK
  • ID_CAP_NETWORKING
  • ID_CAP_SENSORS

4.2 Known Issues

None.

  1. Building, installing, and running the application

5.1 Preparations

Make sure you have the following installed:

  • Windows 8
  • Windows Phone SDK 8.0
  • Latest NuGet Package Manager (>2.7.1) from https://nuget.org/ to enable NuGet Package Restore

5.2 Using the WINDOWS PHONE 8 SDK

  1. Open the SLN file: File > Open Project, select the file MusicExplorer.sln
  2. Select the target 'Emulator WXGA'.
  3. Press F5 to build the project and run it on the Windows Phone Emulator.

5.3 Deploying to Windows Phone 8

Please see official documentation for deploying and testing applications on Windows Phone devices: http://msdn.microsoft.com/en-us/library/gg588378%28v=vs.92%29.aspx

  1. License

See the license text file delivered with this project.

  1. Related documentation

"Nokia Music API" documentation published on Nokia Lumia Developer's Library (http://www.developer.nokia.com/Resources/Library/Lumia/#!nokia-music-api.html) describes the properties and usage of Nokia Music API in detail.

“Optimising for Nokia phablets” documentation on Nokia Lumia Developer's Library (http://developer.nokia.com/Resources/Library/Lumia/#!optimising-for-nokia-phablets.html) describes how to optimize applications for large screen, different aspect ratios, and multiple resolutions.

  1. Version history
  • 1.1.0.0 Major UI-rework (new tile based design replacing list based design, utilizing images of higher resolution in 1080p devices and NuGet package restore support.
  • 1.0.1.0 Bug fix to handle exception when location is set off
  • 1.0.0.0 First release
  • 0.4.0.0 Minor fixes
  • 0.3.0.0 Public beta