Download - Cara Menggunakan Nokia Mix Radio API

Nokia Mix Radio API

1

Content Nokia Mix Radio API ...................................................................................................................................... 1

Cara menggunakan dan menginstall Nokia Mix Radio API ....................................................................... 2

Launcher.................................................................................................................................................... 5

The Launch Task Launcher .................................................................................................................... 5

The Music Search Task Launcher .......................................................................................................... 6

The Show Artist Task Launcher ............................................................................................................. 7

The Show Gigs Task Launcher ............................................................................................................... 8

The Show Mixes Task Launcher ............................................................................................................ 9

The Show Product Task Launcher ......................................................................................................... 9

The Play Mix Task Launcher ................................................................................................................ 10

API Methods ............................................................................................................................................ 12

Search for an artist .............................................................................................................................. 12

Search for a product ........................................................................................................................... 14

Get search suggestions ....................................................................................................................... 15

Get top artists ..................................................................................................................................... 15

Get top products ................................................................................................................................. 15

Get products by an artist .................................................................................................................... 16

Get new releases ................................................................................................................................. 16

Get a list of genres .............................................................................................................................. 17

Get artists around a location .............................................................................................................. 18

Get a list of available mixes groups .................................................................................................... 18

Referensi ................................................................................................................................................. 20

2

Saat menggunakan Nokia Mix Radio API terdapat 2 buah metode yaitu Launcher dan API Methods.

Launcher adalah saat dimana aplikasi kita akan membuka aplikasi Nokia Mix Radio berikut adalah

Launcher yang disupport di Nokia Mix Radio API :

Search for music.

Show Artist details.

Show Gigs nearby.

Show available mixes.

Show product details.

Play a mix.

Selain Launcher terdapat juga API Methods yang disediakan oleh Nokia Mix Radio API perbedaan nya

dengan launcher adalah API Methods tidak akan membuka aplikasi Nokia Mix Radio jadi data yang telah

kita terima dari Nokia Mix Radio API dapat langsung dikonsumsi oleh aplikasi buatan kita. Berikut adalah

API Methods yang telah disediakan oleh Nokia Mix Radio API :

Search for an artist.

Search for a product (such as album, single or track).

Get search suggestions.

Get top artists.

Get top products.

Get products by an artist.

Get new releases.

Get a list of genres.

Get artists around a location.

Get a list of available mixes groups.

Cara menggunakan dan menginstall Nokia Mix Radio

API Pertama – tama buka visual studio yang telah terinstal windows phone SDK dan buat project baru

3

Untuk menggunakan Nokia Mix Radio API kita perlu menambahka libray Nokia Mix Radio untuk

menginstall nya dapat klik kanan di bagian references lalu pilih “Manage NuGet Packages” dimana untuk

melakukan hal ini PC kita harus terkoneksi dengan internet.

Setelah itu akan muncul halaman seperti ini dan kita cari “Nokia MixRadio” setelah itu tinggal pilih

install.

4

Jika telah sukses maka project kita sudah terinstall Nokia Mix Radio API dan untuk menggunakan nya

anda dapat menambahkan perintah using di bagian code.cs dengan perintah

using TestNokiaMixRadioAPI.Resources; using Nokia.Music.Tasks;

using diatas digunakan untuk mendeklarasikan bahwa page yang kita isikan using itu akan menggunakan

Nokia Mix Radio API.

5

Launcher Bagian Launcher ini adalah bagian dimana hasil kode program dari aplikasi Nokia Mix Radio API kita akan

dilempar atau membuka aplikasi Nokia Mix Radio. Berikut adalah beberapa cara penggunaan Launcher

yang disediakan oleh Nokia Mix Radio API.

The Launch Task Launcher Launcher ini digunakan untuk membuka Aplikasi Nokia Mix Radio API. Pertama tama saya membuat

sebuah button seperti gambar di bawah ini.

Dan masukkan code seperti berikut di dalam button “Launch Nokia Mix Radio”

LaunchTask task = new LaunchTask(); task.Show();

Setelah kode program dijalankan maka hasilnya akan seperti ini

6

The Music Search Task Launcher Launcher ini digunakan untuk membuka Aplikasi Nokia Mix Radio API dan mencari daftar music yang

tersedia di Nokia Mix Radio sesuai dengan kata kunci yang kita masukkan. Berikut adalah potongan kode

program yang digunakan untuk memanggil Launcher The Music Search Task Launcher.

MusicSearchTask task = new MusicSearchTask(); task.SearchTerms = "Love"; task.Show();

task.SearchTerms = "Love"; adalah perintah yang digunakan kita untuk kita mencari daftar music yang

memiliki kata “Love”.


7

The Show Artist Task Launcher Launcher ini digunakan untuk membuka Aplikasi Nokia Mix Radio API dan mencari daftar artist yang

tersedia di Nokia Mix Radio sesuai dengan kata kunci yang kita masukkan. Berikut adalah potongan kode

program yang digunakan untuk memanggil Launcher The Show Artist Task Launcher.

ShowArtistTask task = new ShowArtistTask(); task.ArtistName = "Nicki Minaj"; task.Show();

task.ArtistName = "Nicki Minaj"; adalah perintah yang digunakan kita untuk kita mencari daftar artist

yang bernama "Nicki Minaj". Selain ArtistName kita juga dapat menampilkan daftar artist berdasarkan

ArtistId. ArtistId ini dapat kita temukan di dalam API Methods yang akan dibahas di bab selanjutnya.


8

The Show Gigs Task Launcher Launcher ini digunakan untuk membuka Aplikasi Nokia Mix Radio API dan mencari daftar gigs (festival

music atau konser) yang tersedia di Nokia Mix Radio. Berikut adalah potongan kode program yang

digunakan untuk memanggil Launcher The Show Gigs Task Launcher.

ShowGigsTask task = new ShowGigsTask(); task.Show();


9

The Show Mixes Task Launcher Launcher ini digunakan untuk membuka Aplikasi Nokia Mix Radio API dan mencari daftar mix music yang

tersedia di Nokia Mix Radio. Berikut adalah potongan kode program yang digunakan untuk memanggil

Launcher The Show Mixes Task Launcher.

ShowMixesTask task = new ShowMixesTask(); task.Show();


The Show Product Task Launcher Launcher ini digunakan untuk membuka Aplikasi Nokia Mix Radio API dan menampilkan sebuah product

(lagu) dimana di dalam nya kita dapat mendengarkan sample lagu dan informasi seputar lagu atau

product tersebut yang tersedia di Nokia Mix Radio sesuai dengan product id yang kita masukkan. Berikut

adalah potongan kode program yang digunakan untuk memanggil Launcher The Show Product Task

Launcher.

ShowProductTask task = new ShowProductTask(); task.ProductId = "36100035"; task.Show();

task.ProductId = "36100035"; adalah product id yang digunakan kita untuk kita mencari daftar product

atau lagu yang akan kita tampilkan. Product Id ini dapat kita temukan di dalam API Methods yang akan

dibahas di bab selanjutnya.


10

The Play Mix Task Launcher Launcher ini digunakan untuk membuka Aplikasi Nokia Mix Radio API dan memainkan sebuah lagu yang

tersedia di Nokia Mix Radio sesuai dengan product id yang kita masukkan. Berikut adalah potongan kode

program yang digunakan untuk memanggil Launcher The Play Mix Task Launcher.

PlayMixTask task = new PlayMixTask(); task.MixId = "18523926"; task.Show();

task.MixId = "18523926"; adalah MixId yang dapat kita gunakan untuk memainkan sebuah lagu yang

tersedia di Nokia Mix Radio. Selain task.MixId kita juga dapat mengisi berdasarkan nama dari artist yang

dapat dilihat dari potongan kode berikut.

PlayMixTask task = new PlayMixTask(); task.ArtistName = "Linkin Park"; task.Show();


12

API Methods Perbedaan API Methods dengan Launcher adalah API Methods akan langsung mengirimkan hasil data

dari Nokia Mix Radio API sehingga aplikasi kita tidak akan membuka aplikasi Nokia Mix Radio API.

Sebelumnya untuk menggunakan API Methods kita terlebih dahulu harus memiliki AppId untuk

menjalankan sebuah methods untuk itu anda dapat mendaftar terlebih dahulu di

http://nokia.ly/musicapireg seperti gambar di bawah ini.

Setelah anda login anda dapat langsung merequest app id yang nanti anda dapat gunakan untuk

menjalankan web methods.

Berikut adalah beberapa API Methods yang disediakan oleh Nokia Mix Radio API.

Search for an artist Methods search for an artist ini adalah methods yang digunakan untuk mencari daftar artist sesuai

dengan kata kunci yang kita masukkan.

Berikut ini adalah hasil return yang diberikan oleh Nokia Mix Radio API yang dapat kita gunakan :

Id – Id dari artist

Name – Nama dari artist

Origin – location coordinat dari artist

Genres – genre dari artist

Country – daerah asal artist

Thumb100Uri – foto artist atau album artist berukuran 100 X 100px



http://nokia.ly/musicapireg

13


AppToAppPlayUri – digunakan untuk menjalankan Mix Lagu dari artist melalui aplikasi Nokia Mix

Radio

AppToAppUri – digunakan untuk melihat artist melalui aplikasi Nokia Mix Radio

WebPlayUri – digunakan untuk menjalankan Mix Lagu dari artist melalui website

WebUri – digunakan untuk melihat artist melalui website

Selain itu terdapat juga dua buah methods yang dapat kita jalankan yaitu methods :

PlayMix() – digunakan untuk menjalankan Mix Lagu dari artist melalui aplikasi Nokia Mix Radio

Show() – digunakan untuk melihat artist melalui aplikasi Nokia Mix Radio

Setelah itu saya akan menampilkan album atau foto dari artist tersebut beserta nama nama artist sesuai

dengan kata pencarian yang saya input kan. Untuk itu pertama – tama saya akan membuat tampilan

untuk menampilan data tersebut dan saya membuat desain di bagian xaml seperti gambar berikut.

Di bagian binding saya mengisi Thumb100Uri dan Name. Attribut tersebut dapat anda pakai sesuai

dengan property yang anda dapatkan saat mengakses search artist Methods API. Dan di bagian kode

program saya mengisi button tersebut seperti berikut :

private void Button_Click(object sender, RoutedEventArgs e) { SearchArtist(); } public async void SearchArtist() { MusicClient client = new MusicClient("[app_id]"); var artists = await client.SearchArtistsAsync("Green Day");

14

MainListBox.ItemsSource = artists.Result.ToList(); }

Dan hasil dari kode program tersebut adalah seperti berikut :

Search for a product Methods search for a product adalah methods yang digunakan untuk mencari daftar lagu dari sebuah

artist. Berikut adalah potongan kode program untuk mendapatkan daftar artist paling top :

public async void SearchProduct() { MusicClient client = new MusicClient("[app_id]"); var products = await client.GetArtistProductsAsync("959671"); MainListBox.ItemsSource = products.ToList(); }

Setelah anda mendapatkan hasil return berupa product anda dapat memutar sample lagu selama 30

detik. Berikut adalah potongan kode program untuk memutar sample lagu selama 30 detik. Sebelum

memasukkan kode program terlebih dahulu kita menambahkan Media Element di bagian xaml seperti

berikut :

<MediaElement x:Name="mediaMusic"/>

Dan kode program untuk menjalankan sample lagu sebagai berikut:

MusicClient client = new MusicClient("[app_id]"); var track = client.GetTrackSampleUri("33146450"); mediaMusic.Source = new Uri(track.AbsoluteUri); mediaMusic.Play();

15

Get search suggestions Methods Get Search Suggestions adalah methods yang digunakan untuk mencari daftar kata lain yang

sesuai dengan kata kunci yang kita berikan. Hasil return dari methods berikut adalah list of string

sehingga untuk menampilkan nya lebih baik jika kita menggunakan fitur autocomplete textbox. Berikut

adalah potongan kode program untuk mendapatkan daftar artist paling top :

public async void SearchSuggestion() { MusicClient client = new MusicClient("[app_id]"); string searchTerm = "indonesia"; var search = await client.GetSearchSuggestionsAsync(searchTerm); foreach (var item in search) { MessageBox.Show(item); } }

Selain get search sugesstions terdapat juga Methods untuk mendapatkan artist suggestions yang bisa

diakses di methods GetArtistSearchSuggestionsAsync().

Get top artists Methods Get Top Artist adalah methods yang digunakan untuk mencari daftar artist yang paling top.

Berikut adalah potongan kode program untuk mendapatkan daftar artist paling top :

private void Button_Click(object sender, RoutedEventArgs e) { GetTopArtist(); } public async void GetTopArtist() { MusicClient client = new MusicClient("[app_id]"); var temp = await client.GetTopArtistsAsync(); MainListBox.ItemsSource = temp.ToList(); }

Get top products Berikut ini adalah hasil return yang diberikan oleh Nokia Mix Radio API yang dapat kita gunakan :

Id

Name

Label

Parental Advisory

Price

Seller Statement

16

Street Release Date





Berikut adalah kode program yang digunakan untuk medapatkan top products

private void Button_Click(object sender, RoutedEventArgs e) { GetTopProduct(); } public async void GetTopProduct() { MusicClient client = new MusicClient("[app_id]"); var products = await client.GetTopProductsAsync(Category.Album); MainListBox.ItemsSource = products.Result.ToList(); }

GetTopProductsAsync(Category.Album); adalah parameter untuk kita memilih top product berdasarkan

kategori album. Selain album terdapat juga beberapa kategori lain seperti artist, radio station, single,

dan track.

Get products by an artist Methods Get Products by an Artist adalah methods yang digunakan untuk mencari daftar product lagu

yang dibuat atau dinyanyikan oleh artist yang kita pilih. Berikut adalah potongan kode program untuk

mendapatkan daftar product dari sebuah artist.

public async void GetProductByAnArtist() { MusicClient client = new MusicClient("[app_id]"); var products = await client.GetArtistProductsAsync("id_artist"); MainListBox.ItemsSource = products.ToList(); }

GetArtistProductsAsync("id_artist"); adalah parameter id dari artist yang akan kita tampilkan product

nya. Id_artist ini bisa kita dapatkan dari methods yang memberikan return artist misalnya search for an

artist, get top artist,dll.

Get new releases Berikut ini adalah hasil return yang diberikan oleh Nokia Mix Radio API yang dapat kita gunakan :

Id

Name

Label

Parental Advisory

Price

17

Seller Statement

Street Release Date





Berikut adalah kode program yang digunakan untuk medapatkan new release

private void Button_Click(object sender, RoutedEventArgs e) { GetNewRelease(); } public async void GetNewRelease() { MusicClient client = new MusicClient("[app_id]"); var products = await client.GetNewReleasesAsync(Category.Album); MainListBox.ItemsSource = products.Result.ToList(); }

GetTopProductsAsync(Category.Album); adalah parameter untuk kita memilih new release berdasarkan

kategori album. Selain album terdapat juga beberapa kategori lain seperti artist, radio station, single,

dan track.

Get a list of genres Berikut ini adalah hasil return yang diberikan oleh Nokia Mix Radio API yang dapat kita gunakan :

Id – id genre

Name – nama genre

Berikut adalah kode program yang digunakan untuk medapatkan genre

private void Button_Click(object sender, RoutedEventArgs e) { GetGenre(); } public async void GetGenre() { MusicClient client = new MusicClient("[app_id]"); var genre = await client.GetGenresAsync(); MainListBox.ItemsSource = genre.Result.ToList(); }

18

Get artists around a location Methods Get Artist Around Location adalah methods yang digunakan untuk mencari artist yang

berlokasi di sekitar device kita. Berikut adalah kode program yang digunakan untuk medapatkan artist

around a location.

private void Button_Click(object sender, RoutedEventArgs e) { GetArtistAroundLocation(); } public async void GetArtistAroundLocation() { GeoCoordinateWatcher watcher; watcher = new GeoCoordinateWatcher(GeoPositionAccuracy.Default); watcher.Start(); MusicClient client = new MusicClient("[app_id]"); var search = await client.GetArtistsAroundLocationAsync(watcher.Position.Location.Latitude,watcher.Position.Location.Longitude); MainListBox.ItemsSource = search.Result.ToList(); }

Kode program berikut :

GeoCoordinateWatcher watcher; watcher = new GeoCoordinateWatcher(GeoPositionAccuracy.Default); watcher.Start();

Digunakan untuk mendapatkan lokasi device kita. Namun terlebih dahulu kita harus menambahkan

capabilities ID_CAP_LOCATION di dalam file WMAppManifest.xml yang dapat dilihat di solution explorer

dan menambahkan library dengan mengetikan using System.Device.Location; di bagian atas.

Get a list of available mixes groups Method get a list of available mixes groups adalah method yang digunakan untuk kita mendapatkan Mix

Group yang nanti nya dari setiap group tersebut kita dapat putar lagu – lagu di dalam nya menggunakan

aplikasi Nokia Mix Radio. Berikut adalah potongan kode program untuk melihat group mix yang ada di

Nokia Mix Radio API.

private void Button_Click(object sender, RoutedEventArgs e) { GetMixGroups(); } public async void GetMixGroups() { MusicClient client = new MusicClient("[app_id]"); var search = await client.GetMixGroupsAsync(); MainListBox.ItemsSource = search.Result.ToList();

19

}

Setelah anda mendapatkan data dari mix group anda dapat melihat daftar kategori yang ada di dalam

mix group tersebut dengan mengisikan kode program sebagai berikut

public async void GetMixes() { MusicClient client = new MusicClient("[app_id]"); var search = await client.GetMixesAsync("52041897"); MainListBox.ItemsSource = search.Result.ToList(); }

Maka anda akan mendapatkan semua mixes yang tersedia di group tersebut.

client.GetMixesAsync("52041897"); membutuhkan parameter id group yang bisa didapat dari hasil

return client.GetMixGroupsAsync(); dan jika anda telah mendapatkan daftar mixes berikut adalah

potongan kode program untuk memainkan mixes yang telah anda pilih.

public async void PlayMixes() { MusicClient client = new MusicClient("[app_id]"); var search = await client.GetMixAsync("52041953"); search.Play(); }

client.GetMixAsync("52041953"); parameter tersebut didapatkan dari hasil return

GetMixesAsync("52041897"); dan setelah itu aplikasi akan membuka aplikasi Nokia Mix Radio dan

memainkan lagu sesuai dengan mixes yang dipilih.

20

Referensi http://developer.nokia.com/Resources/Library/Lumia/#!nokia-mixradio-api/quick-start.html