यह लेख किसी बाहरी डेवलपर ने लिखा और सबमिट किया है. YouTube API और टूल टीम अपने समय और विशेषज्ञता के लिए मार्टिन लेग्रिस को धन्यवाद देती हैं.
मार्टिन लेग्रिस
मार्च 2008
सुविधा के बारे में जानकारी
इस ट्यूटोरियल में मैं आपको दिखा रहा हूं कि असल AS3 कोड की 10 से कम लाइनों में, आप पिछले day
, week
, month
या all_time
के लिए YouTube पर सबसे लोकप्रिय वीडियो कैसे पा सकते हैं. आपके पास इनमें से कोई भी स्टैंडर्ड फ़ीड पाने का विकल्प है:
- सबसे ज़्यादा देखे गए वीडियाे
- सर्वाधिक नया
- सर्वाधिक चर्चित
- सर्वाधिक लिंक किए गए
- सर्वाधिक प्रतिक्रिया प्राप्त
- हाल के चुनिंदा
- सबसे अच्छी रेटिंग वाले
- प्रमुख पसंदीदा
- मोबाइल फ़ोन के लिए वीडियो
इस उदाहरण में इस्तेमाल की गई लाइब्रेरी हर टाइप पर हार्ड टाइप की गई है. इसका मतलब है कि आपको डेटा मिलने के बाद, FlashID, Flex IDE, Eclipse w/FDT, IntelliJ Idea वगैरह जैसे आईडीई में, अपने-आप पूरा होने वाली सुविधा का इस्तेमाल किया जा सकता है.
अहम जानकारी
शुरू करने से पहले, आपके लिए उपलब्ध संसाधनों की सूची यहां दी गई है - YouTube API के डेटा का इस्तेमाल करने में दिलचस्पी रखने वाले AS3 डेवलपर की.
- ऐसी AS3 लाइब्रेरी जिसे मैंने इन वेब सेवाओं को इस्तेमाल करने के लिए डेवलप किया था
- YouTube के Data API के आधिकारिक दस्तावेज़
- AS3 के लिए फ़्लैशडेव आईडीई
- उन इवेंट की सूची जिनकी मदद से, YouTubeClient पर अनुरोध वाले कॉल किए गए
खुदाई करने की सुविधा
अपना पहला अनुरोध करना
इसके बाद दिख रहा कोड अच्छी तरह से टिप्पणी करता है. हालांकि, इसके बारे में गहराई से जानने से पहले, मुझे इसके बारे में ज़्यादा जानकारी देनी होगी. सभी अनुरोधों के लिए शुरुआत, YouTubeClient
नाम की क्लास होती है. यह क्लास सिंगलटन है. इसका ऐक्सेस आपको दिया जाता है:
// first you import it import ca.newcommerce.youtube.webservice.YouTubeClient; // then you get a reference to it var client:YouTubeClient = YouTubeClient.getInstance();
अब अनुरोध किया जा सकता है:
client.getStandardFeed(YouTubeClient.STD_TOP_RATED, YouTubeClient.TIME_MONTH, 1, 10);
मैंने हाल ही में, सबसे ज़्यादा रेटिंग वाले वीडियो का अनुरोध किया है. इसमें पिछले एक से दस तक के वीडियो शामिल हैं. ध्यान दें कि हर कॉल पर ज़्यादा से ज़्यादा 50 वीडियो ही दिखाए जा सकते हैं. आसान!
नतीजों को मैनेज करना
अब, मैं इन परिणामों तक कैसे पहुंचूं? REST टाइप का वेबपेज पैरामेट्रिक मॉडल एसिंक्रोनस है. इसलिए, फ़ेच करने के दौरान कोड को रोकने के बजाय इवेंट को हैंडल करना आसान होता है. ऐसी स्थिति में, हमें StandardVideoFeedEvent.STANDARD_VIDEO_DATA_RECEIVED
इवेंट के लिए इवेंट लिसनर के बारे में बताना होगा. हर बार किसी स्टैंडर्ड फ़ीड के लिए YouTubeClient
को जवाब मिलने पर, हमारे फ़ंक्शन को कॉल किया जाएगा.
client.addEventListener(StandardVideoFeedEvent.STANDARD_VIDEO_DATA_RECEIVED, doVideosReceived);
कॉल किया जाने वाला फ़ंक्शन doVideosReceived
होगा. इसमें एक पैरामीटर, StandardVideoFeedEvent
टाइप का वैरिएबल होगा. यह AS3 के मानक का पालन करता है. हमें इसका एलान करने का मौका दें. साथ ही, हमें दिखाए गए वीडियो से जुड़ी कुछ समस्याओं के बारे में बताएं. हम स्टैंडर्ड आउटपुट पर नज़र रखेंगे:
- वीडियो का शीर्षक
- वीडियो एम्बेड करने के लिए SWF का URL,
- देखे जाने की संख्या,
- टिप्पणियों की संख्या,
- वीडियो की अवधि,
- और लेखक का नाम.
function doVideosReceived(evt:StandardVideoFeedEvent):void { // get a reference to the feed containing the videos var feed:VideoFeed = evt.feed; // variable to hold each video retreived on the feed var video:VideoData; // iterate through the availabe results while(video = feed.next()) { // trace a newline followed by the video title trace("\nvideo title:"+video.title); // trace the url to use to embed the flash player with this video playing in it.. trace("player url:"+video.swfUrl); // the view count trace("viewCount:"+video.viewCount); // the comment count trace("commentCount:"+video.commentCount); // the duration trace("duration:"+video.duration); // the author trace("author:"+video.authors.first().name); } }
लाइब्रेरी और फ़ीड के बारे में कुछ नोट
करीब सभी इवेंट में एक .feed
प्रॉपर्टी होती है. ProfileEvent
एक अपवाद है, इसकी जगह .profile
प्रॉपर्टी है, क्योंकि इस कॉल में सिर्फ़ एक रिकॉर्ड मिला है.
फ़ीड कई तरह के होते हैं - उन सभी में यह तरीका लागू होता है:
first()
-- पहला रिकॉर्ड फिर से पाएं और उसे पॉइंट करेंnext()
-- अगला उपलब्ध रिकॉर्ड फिर से पाएंlast()
-- पिछला रिकॉर्ड फिर से पाएं और इस पर कर्सर ले जाएंprevious()
-- फ़ीड पर पिछला रिकॉर्ड फिर से पाएंgetAt()
-- किसी खास जगह पर नतीजा पाएंcount()
-- इस फ़ीड के लिए उपलब्ध परिणामों की संख्या,totalResults
के समान नहीं
नतीजे खत्म होने पर, next()
शून्य दिखता है. पिछले फ़ोन पर भी जब आप पहले नतीजे पर पहुंच जाते हैं, तो previous()
पर अगला कॉल null
दिखेगा.
ध्यान दें कि फ़ीड में कैटगरी डेटा (जैसे, कैटगरी) Iterators
के अंदर रैप किए जाते हैं, ताकि आप उपलब्ध कैटगरी पर जाने के लिए उन फ़ंक्शन का इस्तेमाल कर सकें.
सोर्स कोड को पूरा करें
इस उदाहरण के लिए पूरा सोर्स कोड नीचे दिया गया है. एक ज़िप डाउनलोड किया जा सकता है, जिसमें फ़्लैश सीएस3 के अंदर उदाहरण चलाने के लिए ज़रूरी सभी चीज़ें शामिल हों. हालांकि, अगर हम गड़बड़ियां ठीक कर देते हैं या सुविधाओं को अपडेट करते हैं, तो लाइब्रेरी को अपडेट करना सबसे अच्छा होता है. यहां क्लिक करके, लाइब्रेरी डाउनलोड की जा सकती है.
package { // first import dependencies (You can be more specific than this if you want) import ca.newcommerce.youtube.data.*; import ca.newcommerce.youtube.events.*; import ca.newcommerce.youtube.feeds.*; import ca.newcommerce.youtube.iterators.*; import ca.newcommerce.youtube.webservice.YouTubeClient; public class ytTest() { // some class variables protected var _ws:YouTubeClient; protected var _requestId:Number; public function ytTest() { // now inside of an init function _ws = YouTubeClient.getInstance(); // register to list to the events you are interested in _ws.addEventListener(StandardVideoFeedEvent.STANDARD_VIDEO_DATA_RECEIVED, doVideosReceived); // do your call.. get the Top Rated videos for the last month // results 1 to 10; it returns a requestId _requestId = _ws.getStandardFeed(YouTubeClient.STD_TOP_RATED, YouTubeClient.TIME_MONTH, 1, 10); } protected function doVideosReceived(evt:StandardVideoFeedEvent):void { // get a reference to the feed containing the videos var feed:VideoFeed = evt.feed; // variable to hold each video retrieved on the feed var video:VideoData; while(video = feed.next()) { // trace a newline followed by the video title trace("\nvideo title:"+video.title); // trace the swf URL (used for embedding) trace("player url:"+video.swfUrl); // the view count trace("viewCount:"+video.viewCount); // the comment count trace("commentCount:"+video.commentCount); // the duration trace("duration:"+video.duration); // the author trace("author:"+video.authors.first().name); } } } }
नतीजा
हालांकि, यह लेख बर्फ़ीले पहाड़ की चोटी का सिरा है. हालांकि, इससे आपको यह अंदाज़ा हो जाएगा कि इस लाइब्रेरी का इस्तेमाल करके, YouTube Data API को कितनी आसानी से खोजा जा सकता है. मैंने हर चीज़ को अच्छी तरह टाइप करने में बहुत समय लगाया है. इसलिए, यह जानना आसान है कि हर फ़ीड के हिसाब से कौनसा डेटा उपलब्ध है. यह अभी तक लिखने और अपलोड करने की नई सुविधा नहीं देता है, लेकिन अगर आप लाइब्रेरी में योगदान देना चाहते हैं, तो प्रोजेक्ट पेज पर जाएं.
लेखक की जानकारी
मार्टिन लेग्रिस के पास सॉफ़्टवेयर के 12 साल तक चलने का दावा है. आज के समय में, उनका मुख्य काम यूज़र इंटरफ़ेस पर रिसर्च करना है और उनका पसंदीदा टूल Flash w/ Action है. blog.martinlegris.com और www.newcommerce.ca पर वेबसाइट (पुराना हो सकता है) पर उनका ब्लॉग देखें.
इस काम को
क्रिएटिव कॉमंस एट्रिब्यूशन 3.0 अमेरिका के लाइसेंस के तहत लाइसेंस मिला है.