😺 👰🏿 🤗 नोकिया संगीत एपीआई 👆🏾 😓 📙

हाल ही में, MWC-2013 सम्मेलन में, हमने अपने नए फोन पेश किए। इसके अलावा, एक और खबर को आवाज दी गई थी, जो मुख्य रूप से सॉफ्टवेयर डेवलपर्स के लिए महत्वपूर्ण है। हम तीसरे पक्ष के डेवलपर्स के लिए नए एपीआई खोल रहे हैं: फोटो एपीआई, नोकिया म्यूजिक एपीआई और मैप्स एपीआई। आज हम नोकिया म्यूजिक विंडोज फोन एपीआई के बारे में बात करते हैं। नोकिया संगीत विंडोज फोन एपीआई दुनिया भर से लाखों पटरियों पर नवीनतम जानकारी के लिए आसान पहुँच के साथ आवेदन प्रदान करता है।

नोकिया संगीत विंडोज फोन एपीआई के लिए धन्यवाद, एक आवेदन कई महत्वपूर्ण लाभ प्राप्त कर सकते हैं:
• कवरेज।
• सरलीकरण।
• एपीआई अनुबंध "नीचे-ऊपर संगत।"

कवरेज:
• उपयोगकर्ताओं को उनकी रुचि के संगीत की खोज करने में मदद करता है;
• उपयोगकर्ता को जिस संगीत में रुचि है, उसके बारे में विस्तृत जानकारी प्रदान करता है।
• लगभग 3 मिलियन स्थानीय और अंतर्राष्ट्रीय कलाकारों से 200 से अधिक देशों में लगभग 200 मिलियन पटरियों तक पहुंचने की अनुमति देता है।

अनुप्रयोग विकास का सरलीकरण:
संगीत एपि का मुख्य कार्य एकत्र करना और अधिक महत्वपूर्ण बात यह है कि रिकॉर्ड लेबल और एग्रीगेटर्स से लाखों ट्रैक के बारे में तथ्यों की प्रासंगिकता बनाए रखें। इसके बिना, आपको इस डेटा को इकट्ठा करने, सत्यापित करने, मानकीकृत करने और सुनिश्चित करने के लिए बहुत समय बिताना होगा।

एपीआई संगतता:
संगीत रीस्ट एपीआई एपीआई अनुबंध को एक सरल तथ्य को ध्यान में रखकर बनाया गया है - आप हमेशा संगीत के बारे में कुछ नया सीख सकते हैं।
एपीआई अनुबंध आपको किसी भी समय एपीआई अनुबंध के नए संस्करण को पेश किए बिना अतिरिक्त तत्वों को जोड़ने की अनुमति देता है। लेकिन इससे भी महत्वपूर्ण बात यह है कि यदि आप इस लेख में वर्णित निर्देशों और सिफारिशों का पालन करते हैं, तो आपको आवेदन का नया संस्करण जारी नहीं करना पड़ेगा, इसके उपयोगकर्ता स्वचालित रूप से नई सुविधाओं तक पहुँच प्राप्त करेंगे।

आइए संगीत एक्सप्लोरर एप्लिकेशन के उदाहरण का उपयोग करके एपीआई की क्षमताओं को देखें।

आप एप्लिकेशन को स्वयं और उसके स्रोत कोड को यहां डाउनलोड कर सकते हैं: लिंक ।
संगीत एक्सप्लोरर यह दर्शाता है कि विंडोज फोन 8 की मानक ऑडियो क्षमताओं के साथ नोकिया म्यूजिक एपीआई का उपयोग कैसे किया जाता है। एप्लिकेशन नोकिया म्यूजिक एपीआई फीचर्स का उपयोग करता है जैसे कलाकार का नाम, शीर्ष कलाकारों और नए रिलीज का अनुरोध करने के साथ-साथ एक और एप्लिकेशन से नोकिया म्यूजिक को लॉन्च करने के लिए। रेडियो मिलाएं ”या कलाकार या गीत की जानकारी देखें।

नोकिया म्यूजिक लाइट जैसे ब्राउज़रों के विपरीत, म्यूजिक म्यूजिक इंटरफेस आपके डिवाइस पर संगीत के साथ-साथ नोकिया म्यूजिक एपीआई का उपयोग करके कलाकारों और म्यूजिक एक्सप्लोरर गानों को देखने के विभिन्न तरीकों से इंटरैक्ट करता है। पसंदीदा कलाकारों को आवृत्ति सुनकर सॉर्ट किया जाता है, अनुशंसित कलाकारों की सूची पसंदीदा सूची के साथ मैचों की संख्या के अनुसार क्रमबद्ध होती है। इसके अलावा, आप डिवाइस पर संग्रहीत पटरियों को सुन सकते हैं।

डिजाइन और इंटरफ़ेस:
संगीत एक्सप्लोरर का मुख्य पैनोरमा, नीचे दिखाया गया है, इसमें छह आइटम शामिल हैं: पसंदीदा, अनुशंसित, नया, शीर्ष, शैलियों और मिक्स।

विस्तार करने के लिए छवि पर क्लिक करें

पसंदीदा 20 कलाकारों को दिखाते हैं जिनके गाने डिवाइस पर सबसे अधिक बार खेले जाते हैं, साथ ही साथ उनकी छवियों को नोकिया म्यूजिक एपीआई का उपयोग करके प्राप्त किया जाता है। "अनुशंसित" एक समान मानदंड द्वारा क्रमबद्ध सबसे समान कलाकारों की सूची भी प्रदान करता है। "नॉवेल्टीज़" और "टॉप" पिछले 10 गाने और नोकिया म्यूजिक सेवा के शीर्ष 10 कलाकारों को दिखाते हैं। शैलियों और मिक्स भी नोकिया संगीत से संबंधित सूची प्रदर्शित करते हैं। शैलियों और मिश्रणों की सूची निवास के वर्तमान देश पर निर्भर करती है, और उनके नाम इसी भाषा में दिए गए हैं। इसके लिए, सेवा डिवाइस के स्थान डेटा का उपयोग करती है।

एक अन्य प्रमुख उपयोगकर्ता इंटरफ़ेस घटक निष्पादक ब्लॉक है, जिसे नीचे दिखाया गया है। आप "पसंदीदा", "अनुशंसित", "शीर्ष 10" की सूची या शैलियों की सूची में से एक कलाकार का चयन करके इसे प्राप्त कर सकते हैं। कलाकार ब्लॉक का उपयोग किसी विशिष्ट कलाकार के लिए Nokia Music सेवा में उपलब्ध उत्पादों को देखने के लिए किया जाता है। आप Nokia Music API का उपयोग करके उत्पाद नहीं खरीद सकते हैं, इसलिए, इस मामले में, Nokia Music एप्लिकेशन खुलता है, जिसमें आप चयनित ट्रैक खरीद सकते हैं। इसके अलावा, कलाकार का ब्लॉक आपको इस कलाकार के मिश्रण को Nokia Music में शुरू करने या डिवाइस पर संग्रहीत उसकी पटरियों को सुनने की अनुमति देता है।

नोकिया म्यूजिक एपि का उपयोग दूसरे एप्लिकेशन से नोकिया म्यूजिक सेवा शुरू करने के लिए किया जा सकता है। विशिष्ट कलाकार या गीत (मिक्स, ट्रैक, एल्बम या सिंगल) देखने के लिए टैब पर एक सेवा शुरू की जा सकती है। इसके अलावा, आप चयनित मिश्रण को चलाने पर पहले से ही सेवा शुरू कर सकते हैं। "नोट" प्रतीक संगीत एक्सप्लोरर में प्रदर्शित किया जाता है यदि चिह्नित ऑब्जेक्ट के साथ बातचीत करने से नोकिया संगीत लॉन्च होगा। नीचे पृष्ठ "शैली" और "मिक्स" हैं जो उपयोगकर्ता की पसंद पर खुलते हैं।

वास्तुकला और कार्यान्वयन:
संगीत एक्सप्लोरर एक सरल अनुप्रयोग है जो मॉडल - व्यू मॉडल (MVVM) टेम्पलेट को लागू करता है। यह टेम्प्लेट आपको डेटा और उपयोगकर्ता इंटरफ़ेस को अलग करने की अनुमति देता है और विंडोज फोन 8 के लिए एप्लिकेशन विकसित करते समय इसका व्यापक रूप से उपयोग किया जाता है। एप्लिकेशन में, मॉडल (डेटा) C # क्लासेस होता है, और व्यू (यूजर इंटरफेस) WPApp नियंत्रणों का उपयोग करके पॉपुलेटेड PhoneApplicationPages का एक सेट है। MainViewModel, जो मॉडल और दृश्य जोड़ता है, एक C # वर्ग भी है। यह डेटा बाइंडिंग प्रदान करने के लिए सभी एप्लिकेशन पृष्ठों के लिए डेटाकोटेक्स्ट के रूप में सेट किया गया है। आप यहां MVVM के बारे में और अधिक जानकारी प्राप्त कर सकते हैं, साथ ही पृष्ठ के निचले भाग में भी देखें अनुभाग में लिंक की सूची का उपयोग कर सकते हैं। संगीत एक्सप्लोरर के अधिक विस्तृत वास्तुशिल्प विवरण को देखने के लिए, आप विकी में इस परियोजना पृष्ठ के कार्यान्वयन पर जा सकते हैं।

यहां संगीत एक्सप्लोरर द्वारा उपयोग किए जाने वाले सबसे महत्वपूर्ण एपीआई की एक तालिका है, साथ ही साथ उनकी क्षमताओं:

संगीत एक्सप्लोरर द्वारा उपयोग की जाने वाली निम्नलिखित सेवाएँ Nokia Music API द्वारा प्रदान की जाती हैं:

Nokia Music API का उपयोग करने के लिए, एप्लिकेशन को एक अद्वितीय ऐप आईडी और ऐप टोकन की आवश्यकता होगी (यदि आप केवल लॉन्चर का उपयोग नहीं करने जा रहे हैं)। उन्हें एपीआई पंजीकरण पृष्ठ पर पंजीकरण करके और नोकिया संगीत एपीआई के लिए क्रेडेंशियल्स का अनुरोध करके प्राप्त किया जा सकता है। Music Explorer के लिए ऐप आईडी और ऐप टोकन MusicApi.cs में सूचीबद्ध हैं:

namespace MusicExplorer { ... public class MusicApi { // Constants public const string MUSIC_EXPLORER_APP_ID = "music_explorer_private_app_id"; // real app id not shown here public const string MUSIC_EXPLORER_APP_TOKEN = "music_explorer_private_app_token"; // real app token not shown here ... } }

WP8 के लिए आवेदन में वर्तमान Nokia Music API क्लाइंट के लिंक भी होने चाहिए, जो बदले में JSON.Net लाइब्रेरी के लिए एक लिंक की आवश्यकता होती है ताकि इसे एप्लिकेशन में जोड़ा जा सके।
आवश्यक लिंक जोड़ने के निर्देश Music Explorer प्रोजेक्ट के स्रोत फ़ाइलों में release_notes.txt फ़ाइल में हैं ।

Nokia Music API का स्थानीयकरण:
नोकिया संगीत एपीआई के लिए अनुरोध करने से पहले, संगीत एक्सप्लोरर एक विशिष्ट देश के लिए नोकिया संगीत सेवा की उपलब्धता की जांच करता है, जिसे विंडोज फोन लोकेशन एपीआई का उपयोग करके लागू किया जाता है। डिफ़ॉल्ट रूप से, नोकिया म्यूजिक एपीआई एपीआई के हर अनुरोध के साथ फोन पर क्षेत्र सेटिंग्स का उपयोग करता है (और जांचता है)। यह उपयोगकर्ता को प्रासंगिक, आंशिक रूप से अनुवादित और देश-आधारित जानकारी प्राप्त करने की अनुमति देता है। यह ऊपर चित्रमाला में देखा जा सकता है, जो फिनलैंड के लिए उपलब्ध शैलियों और मिक्स को दिखा रहा है, साथ ही साथ शीर्ष फिनिश कलाकार भी हैं। यदि आप Nokia Music API (उदाहरण के लिए, जर्मनी के लिए de या UK के लिए gb) को कॉल कर रहे हैं, तो यह सूची अलग-अलग मान्य देश कोड का उपयोग करती है।

 using Nokia.Music.Phone; ... namespace MusicExplorer { ... public partial class MainPage : PhoneApplicationPage { ... private CountryResolver resolver = null; ... private void InitializeNokiaMusicApi(string twoLetterCountryCode) { if (resolver == null) { resolver = new CountryResolver(MusicApi.MUSIC_EXPLORER_APP_ID, MusicApi.MUSIC_EXPLORER_APP_TOKEN); } resolver.CheckAvailability((Response<bool> response) => { Deployment.Current.Dispatcher.BeginInvoke(() => { if (response.Result) { // Make initial requests to fill models. App.MusicApi.Initialize(twoLetterCountryCode); ... } else { MessageBox.Show("Sorry, Nokia Music is not available in this locale."); } }); }, twoLetterCountryCode.ToLower()); } } }

एक ग्राहक बनाएँ:
संगीत एक्सप्लोरर में, Nokia Music API के साथ संचार, ऊपर वर्णित CountryResolver के उपयोग को छोड़कर, आसान संदर्भ के लिए MusicApi वर्ग में संलग्न है। Nokia Music सेवा के सभी अनुरोध MusicClient वर्ग का उपयोग करके किए गए हैं, और इसलिए Nokia Music सेवा की उपलब्धता की पुष्टि करने के बाद अगला कदम है, प्रारंभिक MusicApi पद्धति में MusicClient बनाना।

 using Nokia.Music.Phone; using Nokia.Music.Phone.Types; ... namespace MusicExplorer { ... public class MusicApi { ... // Members private MusicClient client = null; private bool initialized = false; ... public void Initialize(string countryCode) { // Create a music client with correct AppId and Token/AppCode if (countryCode == null || countryCode.Length != 2) { client = new MusicClient(MUSIC_EXPLORER_APP_ID, MUSIC_EXPLORER_APP_TOKEN); } else { client = new MusicClient(MUSIC_EXPLORER_APP_ID, MUSIC_EXPLORER_APP_TOKEN, countryCode.ToLower()); } initialized = true; } ... } }

हम अनुरोध करते हैं:
Nokia Music के लिए अनुरोध एक स्थानीयकृत MusicClient उदाहरण बनाने के बाद भेजा जा सकता है। उदाहरण के लिए, MusicApi से GetTopArtists पद्धति Nokia संगीत सेवा में 10 सबसे लोकप्रिय कलाकारों के लिए अनुरोध करती है (देश के लिए जहां MusicClient लॉन्च किया गया था) और प्रासंगिक जानकारी से MainViewModel के टॉपआर्टिस्टों को भरता है। द हू ऑफ़ द टॉप पैनोरमा उपयोगकर्ता इंटरफ़ेस में टॉपआर्टिस्ट को प्रदर्शित करने के लिए लिंक का उपयोग करता है। चूंकि शेष अनुरोध (नई रिलीज़, शैली, आदि) समान हैं, इसलिए हम उन्हें अलग से नहीं मानेंगे। आप विशिष्ट उदाहरणों के लिंक के लिए परियोजना पृष्ठ देख सकते हैं।

 namespace MusicExplorer { ... public class MusicApi { ... // Members private MusicClient client = null; private bool initialized = false; ... public void GetTopArtists() { if (!initialized) { return; } client.GetTopArtists((ListResponse<Artist> response) => { Deployment.Current.Dispatcher.BeginInvoke(() => { // Use results if (response != null && response.Result != null && response.Result.Count > 0) { App.ViewModel.TopArtists.Clear(); foreach (Artist a in response.Result) { if (a.Thumb100Uri != null) { App.ViewModel.TopArtists.Add(new ArtistModel() { Name = a.Name, Country = CountryCodes.CountryNameFromTwoLetter(a.Country), Genres = a.Genres[0].Name, ThumbUri = a.Thumb100Uri, Id = a.Id }); } else { App.ViewModel.TopArtists.Add(new ArtistModel() { Name = a.Name, Country = CountryCodes.CountryNameFromTwoLetter(a.Country), Genres = a.Genres[0].Name, ThumbUri = new Uri("/Assets/thumb_100_placeholder.png", UriKind.Relative), Id = a.Id }); } } } if (response != null && response.Error != null) { ShowNokiaMusicApiError(); } HideProgressIndicator("GetTopArtists()"); }); }); ShowProgressIndicator("GetTopArtists()"); } ... } }

नोकिया म्यूजिक लॉन्चर्स:
MusicApi Music Explorer की निम्न विधि से पता चलता है कि कलाकार के मिश्रण को चलाने के लिए Nokia Music लॉन्च करना कितना आसान है। सेवा को नोकिया म्यूजिक एपीआई का उपयोग करके किसी कार्य या कलाकार के पेज पर खोला जा सकता है। Nokia Music API में कुछ लॉन्चर विधियों के लिए अद्वितीय कलाकार, मिक्स या पीस आईडी की आवश्यकता होती है। अन्य नोकिया संगीत एप सेवाओं से अनुरोध के जवाब में आईडी प्राप्त की जा सकती है।

 using Nokia.Music.Phone; using Nokia.Music.Phone.Tasks; ... namespace MusicExplorer { ... public class MusicApi { ... public void LaunchArtistMix(string artistName) { ... PlayMixTask task = new PlayMixTask(); task.ArtistName = artistName; task.Show(); } ... } }

एक प्रारंभिक बिंदु के रूप में स्थानीय संगीत:
पसंदीदा में कलाकारों की सूची लोडडाटा मेन व्यूमॉडल विधि का उपयोग करके बनाई गई है। कोड में टिप्पणियां सूची बनाने के लिए उठाए गए कदमों का वर्णन करती हैं।

 using Microsoft.Xna.Framework.Media; ... namespace MusicExplorer.Models { ... public class MainViewModel : INotifyPropertyChanged { ... public ObservableCollection<ArtistModel> LocalAudio { get; private set; } ... MediaLibrary mediaLib = null; //       . ... public MainViewModel() { LocalAudio = new ObservableCollection<ArtistModel>(); ... //     LocalAudio.Add(new ArtistModel() { Name = "MusicExplorerTitlePlaceholder", ItemHeight = "110", ItemWidth = "400" }); } ... public void LoadData() { mediaLib = new MediaLibrary(); ... foreach (Artist a in mediaLib.Artists) { if (a.Songs.Count <= 0) continue; //     string artist = a.Name; int trackCount = a.Songs.Count; int playCount = 0; //      foreach (Song s in a.Songs) { playCount += s.PlayCount; } //     . bool artistAdded = false; for (int i = 1; i < LocalAudio.Count; i++) // Index 0     { if (Convert.ToInt16(LocalAudio[i].PlayCount) < playCount) { this.LocalAudio.Insert(i, new ArtistModel() { Name = artist, LocalTrackCount = Convert.ToString(trackCount), PlayCount = Convert.ToString(playCount) }); artistAdded = true; break; } } // ...     ,      . if (artistAdded == false) { this.LocalAudio.Add(new ArtistModel() { Name = artist, LocalTrackCount = Convert.ToString(trackCount), PlayCount = Convert.ToString(playCount) }); } ... } // ,   -20   int removeIndex = App.ViewModel.LocalAudio.Count - 1; while (removeIndex > 20) { App.ViewModel.LocalAudio.RemoveAt(removeIndex); removeIndex--; } //      « » foreach (ArtistModel m in App.ViewModel.LocalAudio) { if (m.Name == "MusicExplorerTitlePlaceholder") continue; if (Convert.ToInt16(m.LocalTrackCount) > (totalTrackCount / totalArtistCount)) { m.ItemHeight = "200"; m.ItemWidth = "206"; } else { m.ItemHeight = "100"; m.ItemWidth = "206"; } } ... } ... } }

पसंदीदा कलाकारों की सूची बनाने के बाद, उनमें से प्रत्येक के लिए "समान" वाले लोगों की सूची बनाने के लिए डेटाबेस को नोकिया संगीत एपीआई का उपयोग करके खोजा जाता है। फिर यह सूची उन कलाकारों के श्रोताओं की संख्या के अनुसार बनाई गई है जिन्होंने इसी तरह की सूची बनाई थी। इसके अलावा, डिवाइस पर संग्रहीत गाने वाले कलाकारों को सूची से बाहर रखा गया है, क्योंकि मुख्य विचार नए संगीत को बढ़ावा देना है।

अगले लेख में, हम उन्नत फोटो कैप्चरिंग एपीआई के साथ काम करेंगे।

नोकिया संगीत एपीआई

More articles: