इस लेख को किसी बाहरी डेवलपर ने लिखा और सबमिट किया है. YouTube के एपीआई और टूल की टीम, मार्टिन लेग्रिस को उनके समय और विशेषज्ञता के लिए धन्यवाद देती है.
मार्टिन लेग्रीस
मार्च 2008
परिचय
इस ट्यूटोरियल में, हम आपको बताएंगे कि 10 लाइनों से भी कम AS3 कोड की मदद से, YouTube पर पिछले day, week, month या all_time दिनों के सबसे लोकप्रिय वीडियो कैसे देखे जा सकते हैं. आपको कोई भी स्टैंडर्ड फ़ीड मिल सकता है:
- सबसे ज़्यादा देखी गईं
- सबसे नई
- सर्वाधिक चर्चित
- सर्वाधिक लिंक किए गए
- सर्वाधिक प्रतिक्रिया प्राप्त
- हाल के चुनिंदा
- शीर्ष मूल्यांकित
- प्रमुख पसंदीदा
- मोबाइल फ़ोन के लिए वीडियो
इस उदाहरण में इस्तेमाल की गई लाइब्रेरी पूरी तरह से हार्ड-टाइप की गई है. इसका मतलब है कि डेटा मिलने के बाद, अपने-आप पूरा होने की सुविधा का इस्तेमाल IDE में किया जा सकता है. जैसे, FlashDevelop, Flex IDE, Eclipse w/FDT, IntelliJ Idea वगैरह.
ज़रूरी संसाधन
शुरू करने से पहले, आपके लिए उपलब्ध संसाधनों की सूची यहां दी गई है - AS3 डेवलपर, जिसे YouTube API से डेटा इस्तेमाल करने में दिलचस्पी है.
- इन वेब सेवाओं का इस्तेमाल करने के लिए, मैंने जो AS3 लाइब्रेरी बनाई है
- YouTube Data API का आधिकारिक दस्तावेज़
- AS3 के लिए FlashDevelop IDE
- 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);मैंने अभी-अभी पिछले महीने में टॉप रेटिंग वाले वीडियो के लिए अनुरोध किया था, जिसके नतीजे 1 से लेकर 10 हैं (ध्यान दें कि हर कॉल में ज़्यादा से ज़्यादा 50 नतीजे होते हैं). आसान!
नतीजों को मैनेज करना
अब, मैं इन नतीजों को कैसे ऐक्सेस करूं? REST टाइप का webservice पैराडाइम एसिंक्रोनस होता है. इसलिए, नतीजे फ़ेच करते समय कोड को रोकने के बजाय इवेंट का इस्तेमाल करना ज़्यादा आसान होता है. इससे, नतीजों को मैनेज करने में आसानी होती है. इस मामले में, हमें StandardVideoFeedEvent.STANDARD_VIDEO_DATA_RECEIVED इवेंट के लिए, इवेंट लिसनर का एलान करना होगा. जब भी YouTubeClient को स्टैंडर्ड फ़ीड के लिए जवाब मिलेगा, तब हमारे फ़ंक्शन को कॉल किया जाएगा.
client.addEventListener(StandardVideoFeedEvent.STANDARD_VIDEO_DATA_RECEIVED,
doVideosReceived);
कॉल किया जाने वाला फ़ंक्शन doVideosReceived होगा. इसमें एक पैरामीटर, StandardVideoFeedEvent टाइप का वैरिएबल होगा. यह AS3 के स्टैंडर्ड के मुताबिक है. हम इसे एलान कर दें और हमें मिले वीडियो से जुड़ी कुछ चीज़ों को ट्रैक करने दें. हम स्टैंडर्ड आउटपुट को ट्रेस करेंगे:
- वीडियो का टाइटल,
- वीडियो को एम्बेड करने के लिए SWF का यूआरएल,
- व्यू की संख्या,
- टिप्पणियों की संख्या,
- वीडियो की अवधि,
- और लेखक का नाम.
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 के अंदर रैप किया जाता है. इसलिए, उपलब्ध कैटगरी के बारे में जानने के लिए, इन फ़ंक्शन का इस्तेमाल किया जा सकता है.
पूरा स्रोत कोड
इस उदाहरण के लिए पूरा सोर्स कोड यहां दिया गया है. आपके पास एक ZIP फ़ाइल डाउनलोड करने का विकल्प है. इसमें Flash CS3 में उदाहरण चलाने के लिए ज़रूरी सभी चीज़ें मौजूद हैं. हालांकि, अगर हमने गड़बड़ियों को ठीक किया है या सुविधाओं को अपडेट किया है, तो लाइब्रेरी को अपडेट करना सबसे अच्छा है. आप यहां क्लिक करके लाइब्रेरी डाउनलोड कर सकते हैं.
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 साल हैं. फ़िलहाल, वे मुख्य रूप से यूज़र इंटरफ़ेस (यूआई) की रिसर्च पर ध्यान दे रहे हैं. उनका पसंदीदा टूल, ActionScript वाला Flash है. उनका ब्लॉग blog.martinlegris.com पर और वेबसाइट (पुरानी हो सकती है) www.newcommerce.ca पर देखें.
इस काम के लिए,
Creative Commons Attribution 3.0 United States License के तहत लाइसेंस मिला है.