×
Namespaces

Variants
Actions
Revision as of 10:28, 18 July 2013 by hamishwillee (Talk | contribs)

Introducción al desarrollo con Nokia MixRadio API para Windows Phone

From Nokia Developer Wiki
Jump to: navigation, search

Este articulo muestra cómo comenzar desarrollando aplicaciones que hace uso de los servicios de Nokia Music API.

SignpostIcon XAML 40.png
WP Metro Icon WP8.png
Article Metadata
Compatibility
Platform(s):
Windows Phone 8
Article
Created: franantares (28 Apr 2013)
Last edited: hamishwillee (18 Jul 2013)

Contents

Introducción

Nokia Music API es una colección de servicios web y APIs en C# que Nokia pone a nuestra disposición para enriquecer nuestras aplicaciones y conectarlas con sus servicios. En este artículo veremos los sencillos pasos que hay que seguir para comenzar desarrollando con este potente y rico servicio musical, realizaremos un pequeño proyecto de prueba y explicaremos los distintos tipos de API que Nokia Music pone en manos del desarrollador.

Nokia Music API nos permite mostrar listas con los mejores artistas, resultados de búsqueda musicales, mezclas de música, entre otras muchas cosas. Cuando usemos las APIs de Nokia Music en nuestras aplicaciones, nuestros usuarios podrán encontrar:

  • Música desde más de 200 países
  • Más de 3 millones de artistas locales y globales
  • Más de 20 millones de canciones


Obteniendo las credenciales de Nokia Music API

Para poder usar las API de Nokia Music debemos registrarnos en el portal de desarrolladores de Nokia. Una vez registrados, nos dirigimos a la página para la petición de credenciales de Nokia Music API.

API Registration Home.PNG

En esta página registraremos nuestra aplicación que hará uso de las APIs de Nokia Music dándole un nombre, una descripción y finalmente pulsando en el botón Request Access.

New App Request.PNG

Si todo ha ido bien, se nos presentará una página de confirmación con los datos de nuestra aplicación y las credenciales que debemos usar para acceder a los servicios de Nokia Music.

Registration Details.png

Es importante que guardemos estos datos en un lugar seguro ya que sin ellos no podremos acceder a los servicios de Nokia Music.

Creando nuestro primer proyecto con Nokia Music API

Ahora que lo tenemos todo listo para empezar a programar, vamos a crear un proyecto de Windows Phone muy simple que nos servirá para probar nuestras credenciales.

Empezaremos creando un proyecto básico de aplicación Windows Phone 8 en Visual Studio. Una vez creado, instalaremos las librerías de Nokia Music a través de la consola de paquetes NuGet. En Visual Studio, haremos clic sobre Tools -> Library Package Manager -> Package Manager Console. Allí introduciremos el comando Install-Package NokiaMusic.

NuGet.PNG

Nos aseguramos de que todo compila y ya tendremos listo nuestro proyecto base para empezar a escribir código y atacar a las API de Nokia Music.

Para probar nuestras credenciales, realizaremos una llamada simple a Nokia Music API para que nos devuelva los artistas o bandas más populares del momento. La llamada será la siguiente:

public void GetTopArtists()
{
var client = new MusicClient(App.MyAppId);
 
client.GetTopArtists(response => Deployment.Current.Dispatcher.BeginInvoke(() =>
{
if (response != null && response.Result != null && response.Result.Count > 0)
{
foreach (Artist artist in response.Result)
{
// Work with top artists.
}
}
if (response != null && response.Error != null)
{
// Display error.
}
}));
}

Nota: MyAppId es una propiedad que hemos creado en la clase App (App.xaml.cs) y que contiene la credencial App ID que conseguimos anteriormente.

Una vez tengamos este método listo, lo llamaremos desde nuestra aplicación como mejor creamos conveniente (por ejemplo, usando el evento Click de un botón). Usando un punto de interrupción, analizamos el objeto response para comprobar que la llamada se ha realizado correctamente y el servicio nos ha devuelto los artistas.

Nokia Music C# API vs Nokia Music REST API

Nokia Music API nos ofrece dos opciones a la hora de consumir sus servicios. En el ejemplo anterior hemos usado un método de Nokia Music C# API. También podemos optar (o combinar) con servicios REST.

La API de C# nos será muy fácil de usar ya que, además de numerosos métodos de Get y Search, se basa en el concepto de Launchers de la API de Windows Phone. Tenemos a nuestra disposición los siguientes Launchers:

  • Buscar música
  • Mostrar detalles de artista
  • Mostrar conciertos cercanos
  • Mostrar mezclas disponibles
  • Mostrar detalles sobre canciones o álbumes a comprar
  • Reproducir una mezcla

Por otro lado tenemos la API REST, la cual cuenta con recursos que llamaremos a través de un cliente HTTP. Las respuestas serán devueltas en formato JSON.

Recapitulando

En este artículo hemos visto cómo empezar a desarrollar aplicaciones para Windows Phone haciendo uso de las API de Nokia Music. Hemos visto cómo registrarnos en la página de desarrolladores de Nokia, cómo obtener nuestras credenciales para hacer uso de las API y un pequeño ejemplo usando la API C# de Nokia Music. En la web de desarrolladores de Nokia y en la propia página de Nokia Music tenemos amplia información para crear aplicaciones robustas integradas con los servicios de música de Nokia.

82 page views in the last 30 days.

Was this page helpful?

Your feedback about this content is important. Let us know what you think.

 

Thank you!

We appreciate your feedback.

×