Post on 07-Dec-2015
description
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”.
Setelah kode program dijalankan maka hasilnya akan seperti ini
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.
Setelah kode program dijalankan maka hasilnya akan seperti ini
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();
Setelah kode program dijalankan maka hasilnya akan seperti ini
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();
Setelah kode program dijalankan maka hasilnya akan seperti ini
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.
Setelah kode program dijalankan maka hasilnya akan seperti ini
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();
Setelah kode program dijalankan maka hasilnya akan seperti ini
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
Thumb200Uri – foto artist atau album artist berukuran 200 X 200px
Thumb320Uri – foto artist atau album artist berukuran 320 X 320px
13
Thumb500Uri – foto artist atau album artist berukuran 500 X 500px
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
Thumb100Uri – foto artist atau album artist berukuran 100 X 100px
Thumb200Uri – foto artist atau album artist berukuran 200 X 200px
Thumb320Uri – foto artist atau album artist berukuran 320 X 320px
Thumb500Uri – foto artist atau album artist berukuran 500 X 500px
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
Thumb100Uri – foto artist atau album artist berukuran 100 X 100px
Thumb200Uri – foto artist atau album artist berukuran 200 X 200px
Thumb320Uri – foto artist atau album artist berukuran 320 X 320px
Thumb500Uri – foto artist atau album artist berukuran 500 X 500px
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.