Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

..
Failed to load latest commit information.
Assets
Models
Properties
Resources
Toolkit.Content
AboutPage.xaml
AboutPage.xaml.cs
ApiKeys.cs
App.xaml
App.xaml.cs
ArtistPivotPage.xaml
ArtistPivotPage.xaml.cs
CountryCodes.cs
FlipableItem.xaml
FlipableItem.xaml.cs
Licence.txt
LocalizedStrings.cs
MainPage.xaml
MainPage.xaml.cs
MixesPage.xaml
MixesPage.xaml.cs
MusicApi.cs
MusicExplorer.csproj
MusicExplorer.sln
README.md
README_FIRST.txt
TileItem.xaml
TileItem.xaml.cs
TiltGrid.cs
TopArtistsForGenrePage.xaml
TopArtistsForGenrePage.xaml.cs
XnaFrameworkDispatcherService.cs
packages.config
release_notes.txt

README.md

Music Explorer

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

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/mixradio/.net-sdk

1. Usage

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

2. 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

3. 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 MixRadio 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 MixRadio 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
  • MixRadio
  • System.Device.Location
  • Windows.Devices.Geolocation

4. Compatibility

  • Windows Phone 8

Tested to work on Lumia 920. 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.

5. Building, installing, and running the application

5.1 Preparations

Make sure you have the following installed:

  • Windows 8
  • Windows Phone SDK 8.0
  • NuGet 2.1 (https://nuget.org/), Visual Studio extension to install and update third-party libraries and tools in Visual Studio

5.2 Using the WINDOWS PHONE 8 SDK

  1. Open the SLN file: File > Open Project, select the file MusicExplorer.sln
  2. Install Silverlight Toolkit for the project.
    • Right click References in Solution Explorer -> select Manage NuGet Packages
    • Search for 'wptoolkit' and install the 'Windows Phone toolkit' package
  3. Install MixRadio API for the project.
    • Right click References in Solution Explorer -> select Manage NuGet Packages
    • Search for 'MixRadio' and install the 'NokiaMusic' package
  4. Install Json.NET for the project.
    • Right click References in Solution Explorer -> select Manage NuGet Packages
    • Search for 'json' and install the 'Json.NET' package
  5. Select the target 'Emulator WXGA'.
  6. 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

6. Version history

  • 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
Something went wrong with that request. Please try again.