इस पेज का अनुवाद Cloud Translation API से किया गया है.

YouTube Player API Reference for iframe Embeds

IFrame प्लेयर एपीआई आपको अपनी वेबसाइट पर YouTube वीडियो प्लेयर एम्बेड करने देता है और JavaScript का इस्तेमाल करके प्लेयर को कंट्रोल करने देता है.

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

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

ज़रूरी शर्तें

उपयोगकर्ता के ब्राउज़र में HTML5 postMessage सुविधा काम करनी चाहिए. ज़्यादातर आधुनिक ब्राउज़र पर postMessage काम करता है.

एम्बेड किए गए प्लेयर में कम से कम 200 पिक्सल गुणा 200 पिक्सल की व्यूपोर्ट होनी चाहिए. अगर प्लेयर कंट्रोल दिखाता है, तो यह कंट्रोल काफ़ी बड़ा होना चाहिए, ताकि व्यूपोर्ट का कम से कम साइज़ छोटा किए बिना, कंट्रोल पूरी तरह से दिख सकें. हमारा सुझाव है कि 16:9 प्लेयर की लंबाई कम से कम 480 पिक्सल और ऊंचाई 270 पिक्सल होनी चाहिए.

IFrame API का इस्तेमाल करने वाले किसी भी वेब पेज पर, यह JavaScript फ़ंक्शन भी लागू होना चाहिए:

onYouTubeIframeAPIReady – एपीआई इस फ़ंक्शन को तब कॉल करेगा, जब पेज प्लेयर एपीआई के लिए JavaScript डाउनलोड कर लेगा, ताकि आप अपने पेज पर एपीआई का इस्तेमाल कर सकें. इसलिए, यह फ़ंक्शन ऐसे प्लेयर ऑब्जेक्ट बना सकता है जिन्हें आपको पेज लोड होने पर दिखाना है.

शुरू करना

नीचे दिए गए एचटीएमएल पेज का नमूना, एम्बेड किया गया प्लेयर बनाता है. यह वीडियो लोड करता है, छह सेकंड तक चलता है, और फिर प्लेबैक बंद हो जाता है. एचटीएमएल में नंबर वाली टिप्पणियों के बारे में, उदाहरण के नीचे दी गई सूची में बताया गया है.

<!DOCTYPE html>
<html>
  <body>
    <!-- 1. The <iframe> (and video player) will replace this <div> tag. -->
    <div id="player"></div>

    <script>
      // 2. This code loads the IFrame Player API code asynchronously.
      var tag = document.createElement('script');

      tag.src = "https://www.youtube.com/iframe_api";
      var firstScriptTag = document.getElementsByTagName('script')[0];
      firstScriptTag.parentNode.insertBefore(tag, firstScriptTag);

      // 3. This function creates an <iframe> (and YouTube player)
      //    after the API code downloads.
      var player;
      function onYouTubeIframeAPIReady() {
        player = new YT.Player('player', {
          height: '390',
          width: '640',
          videoId: 'M7lc1UVf-VE',
          playerVars: {
            'playsinline': 1
          },
          events: {
            'onReady': onPlayerReady,
            'onStateChange': onPlayerStateChange
          }
        });
      }

      // 4. The API will call this function when the video player is ready.
      function onPlayerReady(event) {
        event.target.playVideo();
      }

      // 5. The API calls this function when the player's state changes.
      //    The function indicates that when playing a video (state=1),
      //    the player should play for six seconds and then stop.
      var done = false;
      function onPlayerStateChange(event) {
        if (event.data == YT.PlayerState.PLAYING && !done) {
          setTimeout(stopVideo, 6000);
          done = true;
        }
      }
      function stopVideo() {
        player.stopVideo();
      }
    </script>
  </body>
</html>

नीचे दी गई सूची में, ऊपर दिए गए नमूने के बारे में ज़्यादा जानकारी दी गई है:

इस सेक्शन का <div> टैग, पेज पर उस जगह की पहचान करता है जहां iFrame API, वीडियो प्लेयर को दिखाएगा. प्लेयर ऑब्जेक्ट के लिए कंस्ट्रक्टर, जो वीडियो प्लेयर लोड हो रहा है सेक्शन में बताया गया है, यह अपने id से <div> टैग की पहचान करता है, ताकि यह पक्का किया जा सके कि एपीआई <iframe> को सही जगह पर रखता है. खास तौर पर, IFrame API <div> टैग को <iframe> टैग से बदल देगा.

इसके अलावा, <iframe> एलिमेंट को सीधे पेज पर भी डाला जा सकता है. वीडियो प्लेयर लोड करने वाले सेक्शन में, ऐसा करने का तरीका बताया गया है.
इस सेक्शन में मौजूद कोड, IFrame Player API JavaScript कोड लोड करता है. उदाहरण में, एपीआई कोड को डाउनलोड करने के लिए डीओएम में बदलाव करने की सुविधा का इस्तेमाल किया गया है. जैसा कि इस स्टैक ओवरफ़्लो जवाब में बताया गया है, <script> टैग की async विशेषता, जो एसिंक्रोनस डाउनलोड की सुविधा भी चालू करती है, वह सभी आधुनिक ब्राउज़र में काम नहीं करती है.
प्लेयर एपीआई कोड डाउनलोड होते ही onYouTubeIframeAPIReady फ़ंक्शन लागू हो जाएगा. कोड का यह हिस्सा एक ग्लोबल वैरिएबल, player को परिभाषित करता है, जो आपके ज़रिए एम्बेड किए जाने वाले वीडियो प्लेयर के बारे में बताता है. इसके बाद फ़ंक्शन वीडियो प्लेयर ऑब्जेक्ट बनाता है.
जब onReady इवेंट सक्रिय होगा, तो onPlayerReady फ़ंक्शन काम करेगा. इस उदाहरण में, फ़ंक्शन यह बताता है कि वीडियो प्लेयर तैयार होने पर, उसे चलना शुरू हो जाना चाहिए.
एपीआई, प्लेयर के स्टेटस में बदलाव होने पर onPlayerStateChange फ़ंक्शन को कॉल करता है. इससे, यह जानकारी मिल सकती है कि प्लेयर चल रहा है, रुका हुआ है, पूरा हुआ है, और यह आगे भी चल रहा है. फ़ंक्शन यह संकेत देता है कि जब प्लेयर की स्थिति 1 (चल रही है) है, तो प्लेयर को छह सेकंड के लिए वीडियो चलाना चाहिए और फिर वीडियो को बंद करने के लिए stopVideo फ़ंक्शन को कॉल करना चाहिए.

वीडियो प्लेयर लोड हो रहा है

एपीआई का JavaScript कोड लोड होने के बाद, एपीआई onYouTubeIframeAPIReady फ़ंक्शन को कॉल करेगा. इसके बाद, पेज पर वीडियो प्लेयर डालने के लिए YT.Player ऑब्जेक्ट बनाया जा सकता है. नीचे दिया गया एचटीएमएल, ऊपर दिए गए उदाहरण में से onYouTubeIframeAPIReady फ़ंक्शन को दिखाता है:

var player;
function onYouTubeIframeAPIReady() {
  player = new YT.Player('player', {
    height: '390',
    width: '640',
    videoId: 'M7lc1UVf-VE',
    playerVars: {
      'playsinline': 1
    },
    events: {
      'onReady': onPlayerReady,
      'onStateChange': onPlayerStateChange
    }
  });
}

वीडियो प्लेयर का कंस्ट्रक्टर ये पैरामीटर बताता है:

पहले पैरामीटर में DOM एलिमेंट के बारे में या उस एचटीएमएल एलिमेंट के id के बारे में बताया गया है जहां एपीआई, प्लेयर वाले <iframe> टैग को शामिल करेगा.

IFrame API, प्लेयर में शामिल <iframe> एलिमेंट को बदल देगा. अगर बदले जा रहे एलिमेंट की <iframe> शैली, शामिल किए गए एलिमेंट से अलग है, तो इसका असर आपके पेज के लेआउट पर पड़ सकता है. डिफ़ॉल्ट रूप से, <iframe> एक inline-block एलिमेंट के तौर पर दिखता है.
दूसरा पैरामीटर एक ऑब्जेक्ट है, जो प्लेयर विकल्पों की जानकारी देता है. ऑब्जेक्ट में ये प्रॉपर्टी शामिल हैं:
- width (संख्या) – वीडियो प्लेयर की चौड़ाई. डिफ़ॉल्ट वैल्यू 640 है.
- height (संख्या) – वीडियो प्लेयर की ऊंचाई. डिफ़ॉल्ट वैल्यू 390 है.
- videoId (स्ट्रिंग) – YouTube वीडियो का वह आईडी जो उस वीडियो की पहचान करता है जिसे प्लेयर लोड करेगा.
- playerVars (ऑब्जेक्ट) – ऑब्जेक्ट की प्रॉपर्टी, उन प्लेयर पैरामीटर की पहचान करती हैं जिनका इस्तेमाल प्लेयर को पसंद के मुताबिक बनाने के लिए किया जा सकता है.
- events (ऑब्जेक्ट) – ऑब्जेक्ट की प्रॉपर्टी, उन इवेंट की पहचान करती हैं जो एपीआई सक्रिय करता है. साथ ही, यह उन फ़ंक्शन (इवेंट लिसनर) की भी पहचान करता है जिन्हें एपीआई, इवेंट होने पर कॉल करता है. उदाहरण में, कंस्ट्रक्टर यह दिखाता है कि onReady फ़ंक्शन के सक्रिय होने पर onPlayerReady फ़ंक्शन लागू होगा और onStateChange इवेंट, सक्रिय होने पर onPlayerStateChange फ़ंक्शन लागू होगा.

जैसा कि शुरू करना सेक्शन में बताया गया है कि अपने पेज पर खाली <div> एलिमेंट लिखने के बजाय, आप खिलाड़ी एपीआई का JavaScript कोड <iframe> एलिमेंट से बदल देंगे, आप खुद <iframe> टैग बना सकते हैं. उदाहरण सेक्शन के पहले उदाहरण में, ऐसा करने का तरीका बताया गया है.

<iframe id="player" type="text/html" width="640" height="390"
  src="http://www.youtube.com/embed/M7lc1UVf-VE?enablejsapi=1&origin=http://example.com"
  frameborder="0"></iframe>

ध्यान रखें कि अगर <iframe> टैग लिखा जाता है, तो YT.Player ऑब्जेक्ट बनाते समय, आपको width और height के लिए वैल्यू डालने की ज़रूरत नहीं होती. इन वैल्यू को src टैग में बताए गए videoId या प्लेयर पैरामीटर के तौर पर दिखाया जाता है. सुरक्षा के अतिरिक्त तरीके के तौर पर, आपको यूआरएल में origin पैरामीटर भी शामिल करना चाहिए. साथ ही, यूआरएल स्कीम (http:// या https://) और अपने होस्ट पेज के पूरे डोमेन को, पैरामीटर वैल्यू के तौर पर शामिल करना चाहिए. हालांकि, origin वैकल्पिक है, लेकिन इसे आपके पेज में नुकसान पहुंचाने वाले तीसरे पक्ष के JavaScript का इस्तेमाल होने और आपके YouTube प्लेयर को हाइजैक करने से रोकने के लिए बनाया जाता है.

उदाहरण सेक्शन में, वीडियो प्लेयर ऑब्जेक्ट बनाने के कुछ और उदाहरण भी दिखाए जाते हैं.

ऑपरेशंस

प्लेयर एपीआई के तरीकों को कॉल करने के लिए, आपको सबसे पहले प्लेयर के उस ऑब्जेक्ट का रेफ़रंस लेना होगा जिसे आप कंट्रोल करना चाहते हैं. पहचान फ़ाइल पाने के लिए, आपको YT.Player दस्तावेज़ बनाना होगा. इसके बारे में, शुरू करें और इस वीडियो के वीडियो प्लेयर लोड करें सेक्शन में बताया गया है.

फ़ंक्शन

सूची वाले फ़ंक्शन

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

सूची में शामिल फ़ंक्शन को कॉल करने के लिए, एपीआई में दो अलग-अलग सिंटैक्स इस्तेमाल किए जा सकते हैं.

आर्ग्युमेंट सिंटैक्स के लिए, फ़ंक्शन के आर्ग्युमेंट को तय किए गए क्रम में शामिल करना ज़रूरी है.
ऑब्जेक्ट सिंटैक्स की मदद से, किसी ऑब्जेक्ट को एक पैरामीटर के तौर पर पास किया जा सकता है. साथ ही, यह उन फ़ंक्शन आर्ग्युमेंट के लिए ऑब्जेक्ट की प्रॉपर्टी तय करता है जिन्हें आपको सेट करना है. इसके अलावा, एपीआई में ऐसी दूसरी सुविधा भी हो सकती है जो आर्ग्युमेंट सिंटैक्स में काम नहीं करती.

उदाहरण के लिए, loadVideoById फ़ंक्शन को इनमें से किसी एक तरीके से कॉल किया जा सकता है. ध्यान दें कि ऑब्जेक्ट सिंटैक्स, endSeconds प्रॉपर्टी के साथ काम करता है. हालांकि, आर्ग्युमेंट सिंटैक्स काम नहीं करता.

आर्ग्युमेंट सिंटैक्स
```
loadVideoById("bHQqvYy5KYo", 5, "large")
```

ऑब्जेक्ट सिंटैक्स

loadVideoById({'videoId': 'bHQqvYy5KYo',
               'startSeconds': 5,
               'endSeconds': 60});

वीडियो की सूची बनाने की सुविधा

cueVideoById

आर्ग्युमेंट सिंटैक्स

player.cueVideoById(videoId:String,
                    startSeconds:Number):Void

ऑब्जेक्ट सिंटैक्स

player.cueVideoById({videoId:String,
                     startSeconds:Number,
                     endSeconds:Number}):Void

यह फ़ंक्शन, बताए गए वीडियो का थंबनेल लोड करता है और प्लेयर को वीडियो चलाने के लिए तैयार करता है. खिलाड़ी तब तक FLV का अनुरोध नहीं करता, जब तक playVideo() या seekTo() को कॉल नहीं किया जाता.

ज़रूरी videoId पैरामीटर, वीडियो के YouTube वीडियो आईडी की जानकारी देता है. YouTube डेटा एपीआई में, video संसाधन की id प्रॉपर्टी, आईडी की जानकारी देती है.
वैकल्पिक startSeconds पैरामीटर एक फ़्लोट/पूर्णांक स्वीकार करता है और वह समय बताता है जब playVideo() को कॉल करने पर वीडियो चलना शुरू होता है. अगर आप startSeconds वैल्यू तय करते हैं और फिर seekTo() को कॉल करते हैं, तो खिलाड़ी seekTo() कॉल में दिए गए समय से खेलता है. वीडियो बंद होने और चलने के लिए तैयार होने पर, प्लेयर video cued इवेंट (5) को ब्रॉडकास्ट करेगा.
वैकल्पिक endSeconds पैरामीटर, जो सिर्फ़ ऑब्जेक्ट सिंटैक्स में काम करता है, एक फ़्लोट/इंटेजर स्वीकार करता है. साथ ही, वह समय भी बताता है, जब playVideo() को कॉल करने के दौरान वीडियो चलना बंद हो जाता है. अगर आप endSeconds वैल्यू तय करते हैं और फिर seekTo() को कॉल करते हैं, तो endSeconds वैल्यू काम नहीं करेगी.

loadVideoById

आर्ग्युमेंट सिंटैक्स

player.loadVideoById(videoId:String,
                     startSeconds:Number):Void

ऑब्जेक्ट सिंटैक्स

player.loadVideoById({videoId:String,
                      startSeconds:Number,
                      endSeconds:Number}):Void

यह फ़ंक्शन, बताए गए वीडियो को लोड करता है और चलाता है.

ज़रूरी videoId पैरामीटर, वीडियो के YouTube वीडियो आईडी की जानकारी देता है. YouTube डेटा एपीआई में, video संसाधन की id प्रॉपर्टी, आईडी की जानकारी देती है.
वैकल्पिक startSeconds पैरामीटर, फ़्लोट/पूर्णांक स्वीकार करता है. अगर यह तय किया गया है, तो वीडियो सबसे नज़दीकी कीफ़्रेम से तय समय पर शुरू होगा.
वैकल्पिक endSeconds पैरामीटर, फ़्लोट/पूर्णांक स्वीकार करता है. अगर वीडियो के बारे में जानकारी दी जाती है, तो बताए गए समय पर वीडियो चलने बंद हो जाएगा.

cueVideoByUrl

आर्ग्युमेंट सिंटैक्स

player.cueVideoByUrl(mediaContentUrl:String,
                     startSeconds:Number):Void

ऑब्जेक्ट सिंटैक्स

player.cueVideoByUrl({mediaContentUrl:String,
                      startSeconds:Number,
                      endSeconds:Number}):Void

ज़रूरी mediaContentUrl पैरामीटर, http://www.youtube.com/v/VIDEO_ID?version=3 फ़ॉर्मैट में पूरी तरह क्वालिफ़ाइड YouTube प्लेयर यूआरएल के बारे में बताता है.
वैकल्पिक startSeconds पैरामीटर एक फ़्लोट/पूर्णांक स्वीकार करता है और वह समय बताता है जब playVideo() को कॉल करने पर वीडियो चलना शुरू होता है. अगर startSeconds बताया जाता है और फिर seekTo() पर कॉल किया जाता है, तो प्लेयर seekTo() कॉल में बताए गए समय पर गेम खेलता है. जब वीडियो उस समय तैयार हो जाएगा और चलने के लिए तैयार हो जाएगा, तो प्लेयर video cued इवेंट (5) को ब्रॉडकास्ट करेगा.
वैकल्पिक endSeconds पैरामीटर, जो सिर्फ़ ऑब्जेक्ट सिंटैक्स में काम करता है, एक फ़्लोट/इंटेजर स्वीकार करता है. साथ ही, वह समय भी बताता है, जब playVideo() को कॉल करने के दौरान वीडियो चलना बंद हो जाता है. अगर आप endSeconds वैल्यू तय करते हैं और फिर seekTo() को कॉल करते हैं, तो endSeconds वैल्यू काम नहीं करेगी.

loadVideoByUrl

आर्ग्युमेंट सिंटैक्स

player.loadVideoByUrl(mediaContentUrl:String,
                      startSeconds:Number):Void

ऑब्जेक्ट सिंटैक्स

player.loadVideoByUrl({mediaContentUrl:String,
                       startSeconds:Number,
                       endSeconds:Number}):Void

यह फ़ंक्शन, बताए गए वीडियो को लोड करता है और चलाता है.

ज़रूरी mediaContentUrl पैरामीटर, http://www.youtube.com/v/VIDEO_ID?version=3 फ़ॉर्मैट में पूरी तरह क्वालिफ़ाइड YouTube प्लेयर यूआरएल के बारे में बताता है.
वैकल्पिक startSeconds पैरामीटर एक फ़्लोट/पूर्णांक स्वीकार करता है और उस समय के बारे में बताता है जब से वीडियो चलना शुरू होता है. अगर startSeconds (संख्या एक फ़्लोट हो सकती है) दी गई है, तो वीडियो नज़दीकी कीफ़्रेम से तय समय तक शुरू होगा.
वैकल्पिक endSeconds पैरामीटर, जो सिर्फ़ ऑब्जेक्ट सिंटैक्स में काम करता है, एक फ़्लोट/पूर्णांक स्वीकार करता है और वह समय बताता है जब वीडियो चलना बंद हो जाता है.

सूचियों के लिए फ़ंक्शन को सूची में जोड़ना

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

फ़ंक्शन, आर्ग्युमेंट सिंटैक्स या ऑब्जेक्ट सिंटैक्स के आधार पर अलग-अलग तरीके से काम करते हैं. इसलिए, कॉल करने के दोनों तरीकों के दस्तावेज़ नीचे दिए गए हैं.

cuePlaylist

आर्ग्युमेंट सिंटैक्स
```
player.cuePlaylist(playlist:String|Array,
                   index:Number,
                   startSeconds:Number):Void
```
बताई गई प्लेलिस्ट को सूची में जोड़ देता है. प्लेलिस्ट खत्म होने के बाद, प्लेयर में video cued इवेंट (5) का ब्रॉडकास्ट शुरू होगा.
- ज़रूरी playlist पैरामीटर, YouTube वीडियो आईडी की श्रेणी तय करता है. YouTube डेटा एपीआई में, video संसाधन की id प्रॉपर्टी, उस वीडियो के आईडी की पहचान करती है.
- वैकल्पिक index पैरामीटर, प्लेलिस्ट के पहले वीडियो के इंडेक्स के बारे में बताता है. पैरामीटर में शून्य पर आधारित इंडेक्स का इस्तेमाल किया जाता है और पैरामीटर की डिफ़ॉल्ट वैल्यू 0 है. इसलिए, प्लेलिस्ट में पहला वीडियो लोड करके उसे डिफ़ॉल्ट तौर पर चलाया जाता है.
- वैकल्पिक startSeconds पैरामीटर, फ़्लोट/पूर्णांक स्वीकार करता है और वह समय तय करता है, जब playVideo() फ़ंक्शन को कॉल करने पर प्लेलिस्ट का पहला वीडियो चलना शुरू होता है. अगर आप startSeconds वैल्यू तय करते हैं और फिर seekTo() को कॉल करते हैं, तो खिलाड़ी seekTo() कॉल में दिए गए समय से खेलता है. अगर आप कोई प्लेलिस्ट चुनते हैं और फिर playVideoAt() फ़ंक्शन को कॉल करते हैं, तो प्लेयर बताए गए वीडियो की शुरुआत में चलना शुरू हो जाएगा.
ऑब्जेक्ट सिंटैक्स
```
player.cuePlaylist({listType:String,
                    list:String,
                    index:Number,
                    startSeconds:Number}):Void
```
वीडियो की सूची को कतार में लगाता है. यह सूची, प्लेलिस्ट या उपयोगकर्ता का अपलोड किया गया वीडियो फ़ीड हो सकती है. खोज के नतीजों की सूची को सूची में जोड़ने की सुविधा हटा दी गई है. अब यह 15 नवंबर, 2020 से काम नहीं करेगी.
सूची के ठीक होने और चलने के लिए तैयार होने पर, प्लेयर video cued इवेंट (5) ब्रॉडकास्ट करेगा.
- वैकल्पिक listType प्रॉपर्टी से पता चलता है कि आपको किस तरह के नतीजे वाले फ़ीड मिल रहे हैं. playlist और user_uploads सही वैल्यू हैं. बिना समर्थन वाली वैल्यू search, 15 नवंबर, 2020 से काम नहीं करेगी. डिफ़ॉल्ट वैल्यू playlist है.
- ज़रूरी list प्रॉपर्टी में ऐसी कुंजी है जो उन वीडियो की खास सूची बताती है जिन्हें YouTube को दिखाना चाहिए.
  - अगर listType प्रॉपर्टी की वैल्यू playlist है, तो list प्रॉपर्टी से प्लेलिस्ट आईडी या वीडियो आईडी की श्रेणी के बारे में पता चलता है. YouTube डेटा एपीआई में, playlist संसाधन की id प्रॉपर्टी, किसी प्लेलिस्ट के आईडी की पहचान करती है. साथ ही, video संसाधन की id प्रॉपर्टी एक वीडियो आईडी बताती है.
  - अगर listType प्रॉपर्टी की वैल्यू user_uploads है, तो list प्रॉपर्टी उस उपयोगकर्ता की पहचान करती है जिसके अपलोड किए गए वीडियो दिखाए जाएंगे.
  - अगर listType प्रॉपर्टी की वैल्यू search है, तो list प्रॉपर्टी से खोज क्वेरी का पता चलता है. ध्यान दें: यह सुविधा इस्तेमाल नहीं की जा सकती. अब यह 15 नवंबर, 2020 से काम नहीं करेगी.
- index की वैकल्पिक प्रॉपर्टी से, सूची में शामिल पहले वीडियो के इंडेक्स के बारे में पता चलता है. पैरामीटर में शून्य पर आधारित इंडेक्स का इस्तेमाल किया जाता है और पैरामीटर की डिफ़ॉल्ट वैल्यू 0 है. इसलिए, सूची में पहला वीडियो लोड करके डिफ़ॉल्ट तरीके से चलाया जाता है.
- startSeconds प्रॉपर्टी, एक फ़्लोट/पूर्णांक स्वीकार करती है और वह समय बताती है जब सूची के पहले वीडियो को playVideo() फ़ंक्शन को कॉल करने पर चलना शुरू होता है. अगर आप startSeconds वैल्यू तय करते हैं और फिर seekTo() को कॉल करते हैं, तो खिलाड़ी seekTo() कॉल में दिए गए समय से खेलता है. अगर सूची को चुना जाता है और फिर playVideoAt() फ़ंक्शन को कॉल किया जाता है, तो प्लेयर वीडियो की शुरुआत में चलना शुरू हो जाएगा.

loadPlaylist

आर्ग्युमेंट सिंटैक्स
```
player.loadPlaylist(playlist:String|Array,
                    index:Number,
                    startSeconds:Number):Void
```
यह फ़ंक्शन तय प्लेलिस्ट को लोड करता है और चलाता है.
- ज़रूरी playlist पैरामीटर, YouTube वीडियो आईडी की श्रेणी तय करता है. YouTube डेटा एपीआई में, video संसाधन की id प्रॉपर्टी, वीडियो आईडी की जानकारी देती है.
- वैकल्पिक index पैरामीटर, प्लेलिस्ट के पहले वीडियो के इंडेक्स के बारे में बताता है. पैरामीटर में शून्य पर आधारित इंडेक्स का इस्तेमाल किया जाता है और पैरामीटर की डिफ़ॉल्ट वैल्यू 0 है. इसलिए, प्लेलिस्ट में पहला वीडियो लोड करके उसे डिफ़ॉल्ट तौर पर चलाया जाता है.
- वैकल्पिक startSeconds पैरामीटर एक फ़्लोट/पूर्णांक स्वीकार करता है और वह समय बताता है, जब प्लेलिस्ट में पहला वीडियो चलना शुरू होता है.
ऑब्जेक्ट सिंटैक्स
```
player.loadPlaylist({list:String,
                     listType:String,
                     index:Number,
                     startSeconds:Number}):Void
```
यह फ़ंक्शन तय सूची को लोड करता है और उसे चलाता है. यह सूची, प्लेलिस्ट या उपयोगकर्ता का अपलोड किया गया वीडियो फ़ीड हो सकती है. खोज के नतीजों की सूची लोड करने की सुविधा काम नहीं करती है. यह 15 नवंबर, 2020 से काम नहीं करेगी.
- वैकल्पिक listType प्रॉपर्टी से पता चलता है कि आपको किस तरह के नतीजे वाले फ़ीड मिल रहे हैं. playlist और user_uploads सही वैल्यू हैं. बिना समर्थन वाली वैल्यू search, 15 नवंबर, 2020 से काम नहीं करेगी. डिफ़ॉल्ट वैल्यू playlist है.
- ज़रूरी list प्रॉपर्टी में ऐसी कुंजी है जो उन वीडियो की खास सूची बताती है जिन्हें YouTube को दिखाना चाहिए.
  - अगर listType प्रॉपर्टी की वैल्यू playlist है, तो list प्रॉपर्टी से किसी प्लेलिस्ट आईडी या वीडियो आईडी के कलेक्शन के बारे में पता चलता है. YouTube डेटा एपीआई में, playlist संसाधन की id प्रॉपर्टी किसी प्लेलिस्ट का आईडी बताती है और video रिसॉर्स की id प्रॉपर्टी कोई वीडियो आईडी बताती है.
  - अगर listType प्रॉपर्टी की वैल्यू user_uploads है, तो list प्रॉपर्टी उस उपयोगकर्ता की पहचान करती है जिसके अपलोड किए गए वीडियो दिखाए जाएंगे.
  - अगर listType प्रॉपर्टी की वैल्यू search है, तो list प्रॉपर्टी से खोज क्वेरी का पता चलता है. ध्यान दें: यह सुविधा इस्तेमाल नहीं की जा सकती. अब यह 15 नवंबर, 2020 से काम नहीं करेगी.
- index की वैकल्पिक प्रॉपर्टी से, सूची में शामिल पहले वीडियो के इंडेक्स के बारे में पता चलता है. पैरामीटर में शून्य पर आधारित इंडेक्स का इस्तेमाल किया जाता है और पैरामीटर की डिफ़ॉल्ट वैल्यू 0 है. इसलिए, सूची में पहला वीडियो लोड करके डिफ़ॉल्ट तरीके से चलाया जाता है.
- वैकल्पिक startSeconds प्रॉपर्टी एक फ़्लोट/पूर्णांक स्वीकार करती है और वह समय बताती है, जब सूची का पहला वीडियो चलना शुरू होता है.

वीडियो चलाने के कंट्रोल और प्लेयर की सेटिंग

कोई वीडियो चलाना

player.playVideo():Void: इस समय इस्तेमाल किया गया/लोड किया गया वीडियो चलाता है. इस फ़ंक्शन के चालू होने पर प्लेयर की आखिरी स्थिति playing (1) होगी.

ध्यान दें: वीडियो को आधिकारिक तौर पर देखे जाने की संख्या में तभी गिना जाता है, जब उसे प्लेयर में मौजूद 'चलाएं' बटन से शुरू किया जाता है.

player.pauseVideo():Void: अभी चल रहे वीडियो को रोक देता है. इस फ़ंक्शन के चालू होने पर प्लेयर की आखिरी स्थिति paused (2) होगी. ऐसा तब तक होगा, जब तक कि फ़ंक्शन को कॉल करने पर खिलाड़ी ended (0) में न हो. ऐसे में, प्लेयर की स्थिति नहीं बदलेगी.

player.stopVideo():Void: मौजूदा वीडियो को लोड होने से रोकता है और उसे रद्द करता है. यह फ़ंक्शन बहुत कम मामलों में रिज़र्व होना चाहिए. ऐसा तब होता है, जब आपको पता चलता है कि उपयोगकर्ता प्लेयर में कुछ और वीडियो नहीं देखेगा. अगर आपका इरादा वीडियो को रोकना है, तो आपको सिर्फ़ pauseVideo फ़ंक्शन को कॉल करना चाहिए. अगर आपको प्लेयर में चल रहे वीडियो में बदलाव करना है, तो पहले stopVideo को कॉल किए बिना, सूची में शामिल किसी एक फ़ंक्शन को कॉल किया जा सकता है.

अहम जानकारी: pauseVideo फ़ंक्शन, प्लेयर को paused (2) की स्थिति में छोड़ देता है और stopVideo फ़ंक्शन, प्लेयर को ended (0), paused (2), video cued (5) या unstarted (-1)

प्रॉपर्टी
`yaw`	रेंज (0, 360) में संख्या, जो डिग्री में व्यू के हॉरिज़ॉन्टल ऐंगल को दिखाती है. यह बताता है कि उपयोगकर्ता, व्यू को किस तरफ़ बाईं या दाईं ओर घुमाता है. वीडियो के बीच वाले इक्विरेक्टैंग्यूलर प्रोजेक्शन में न्यूट्रल पोज़िशन, जो 0° होती है. जब दर्शक बाईं ओर घूमता है, तो यह वैल्यू बढ़ती है.
`pitch`	रेंज [-90, 90] की संख्या, डिग्री में व्यू के वर्टिकल ऐंगल को दिखाती है. इससे पता चलता है कि उपयोगकर्ता, व्यू को ऊपर या नीचे देखने के लिए किस सीमा तक अडजस्ट करता है. वीडियो के बीच वाले इक्विरेक्टैंग्यूलर प्रोजेक्शन में न्यूट्रल पोज़िशन, 0° दिखाती है. जब दर्शक ऊपर से ऊपर की ओर देखते हैं, तो यह वैल्यू बढ़ती है.
`roll`	रेंज [-180, 180] में संख्या जो कि व्यू में घड़ी की दिशा में या घड़ी की उल्टी दिशा में घूमने वाला कोण बताती है. इक्विरेक्टैंग्यूलर प्रोजेक्शन में न्यूट्रल पोज़िशन और व्यू के हॉरिज़ॉन्टल ऐक्सिस के समकोण 0° को दिखाते हैं. जब व्यू घड़ी की दिशा में घूमता है, तो यह बढ़ता है और व्यू के वामावर्त घूमता है. ध्यान दें कि एम्बेड किए गए प्लेयर में, व्यू का रोल सेट करने के लिए यूज़र इंटरफ़ेस मौजूद नहीं है. रोल को इनमें से किसी एक तरीके से अडजस्ट किया जा सकता है: किसी मोबाइल ब्राउज़र में ओरिएंटेशन सेंसर का इस्तेमाल करके व्यू के लिए रोल उपलब्ध कराएं. अगर ओरिएंटेशन सेंसर चालू है, तो `getSphericalProperties` फ़ंक्शन `0` को `roll` प्रॉपर्टी की वैल्यू के तौर पर हमेशा दिखाता है. अगर ओरिएंटेशन सेंसर बंद है, तो इस एपीआई का इस्तेमाल करके रोल को ज़ीरो वैल्यू पर सेट करें.
`fov`	रेंज [30, 120] में संख्या, जो व्यूपोर्ट में लंबे व्यू के साथ मापी गई डिग्री में व्यू के फ़ील्ड-ऑफ़-व्यू को दिखाती है. व्यू के आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) के अनुपात में, छोटे किनारे को अपने-आप अडजस्ट कर दिया जाता है. डिफ़ॉल्ट वैल्यू 100 डिग्री होती है. मान को बढ़ाना, वीडियो सामग्री को ज़ूम इन करने जैसा है, और मान को बढ़ाना ज़ूम आउट करने जैसा है. एपीआई की मदद से या वीडियो के फ़ुलस्क्रीन मोड में होने पर, माउसव्हील का इस्तेमाल करके, इस वैल्यू को बदला जा सकता है.

प्रॉपर्टी
`yaw`	ऊपर परिभाषा देखें.
`pitch`	ऊपर परिभाषा देखें.
`roll`	ऊपर परिभाषा देखें.
`fov`	ऊपर परिभाषा देखें.
`enableOrientationSensor`	ध्यान दें: यह प्रॉपर्टी, सिर्फ़ साथ काम करने वाले डिवाइसों पर 360° व्यू देखने के अनुभव पर असर डालती है.एक बूलियन वैल्यू, जो यह बताती है कि IFrame एम्बेड को उन इवेंट पर जवाब देना चाहिए या नहीं जो डिवाइस के ओरिएंटेशन में बदलाव करते हैं, जैसे कि मोबाइल ब्राउज़र का `DeviceOrientationEvent`. पैरामीटर की डिफ़ॉल्ट वैल्यू `true` है. साथ काम करने वाले मोबाइल डिवाइस जब वैल्यू `true` होती है, तो एम्बेड किया गया प्लेयर, डिवाइस के मूवमेंट पर सिर्फ़ निर्भर करता है. इससे 360° वीडियो के `yaw`, `pitch`, और `roll` प्रॉपर्टी में बदलाव होता है. हालांकि, `fov` प्रॉपर्टी को अब भी एपीआई के ज़रिए बदला जा सकता है. असल में, मोबाइल डिवाइस पर `fov` प्रॉपर्टी को ही बदला जा सकता है. यह डिफ़ॉल्ट व्यवहार है. जब वैल्यू `false` होती है, तो डिवाइस की हलचल से 360° व्यू पर कोई असर नहीं पड़ता. साथ ही, `yaw`, `pitch`, `roll`, और `fov` प्रॉपर्टी को एपीआई के ज़रिए सेट किया जाना चाहिए. ऐसे मोबाइल डिवाइस जिनका इस्तेमाल नहीं किया जा सकता `enableOrientationSensor` प्रॉपर्टी की वैल्यू पर, वीडियो चलाने के अनुभव पर कोई असर नहीं पड़ता.

मॉड्यूल	विकल्प	ब्यौरा
captions	फ़ॉन्ट का साइज़	इस विकल्प से प्लेयर में दिखने वाले कैप्शन के फ़ॉन्ट का साइज़ अडजस्ट हो जाता है. मान्य वैल्यू हैं `-1`, `0`, `1`, `2`, और `3`. डिफ़ॉल्ट साइज़ `0` है और सबसे छोटा साइज़ `-1` है. इस विकल्प को `-1` से नीचे के पूर्णांक पर सेट करने से कैप्शन का साइज़ सबसे छोटा दिखेगा. वहीं, इस विकल्प को `3` से ज़्यादा के पूर्णांक पर सेट करने से कैप्शन का साइज़ सबसे बड़ा दिखेगा.
captions	reload	यह विकल्प चल रहे वीडियो के सबटाइटल डेटा को फिर से लोड करता है. अगर आप विकल्प के मान को फिर से पाते हैं, तो मान `null` होगा. सबटाइटल डेटा को फिर से लोड करने के लिए मान को `true` पर सेट करें.

YouTube Player API Reference for iframe Embeds

ज़रूरी शर्तें

शुरू करना

वीडियो प्लेयर लोड हो रहा है

ऑपरेशंस

फ़ंक्शन

सूची वाले फ़ंक्शन

वीडियो की सूची बनाने की सुविधा

सूचियों के लिए फ़ंक्शन को सूची में जोड़ना

वीडियो चलाने के कंट्रोल और प्लेयर की सेटिंग

कोई वीडियो चलाना

360 डिग्री वाले वीडियो चलाने की सुविधा को कंट्रोल करना

प्लेलिस्ट में वीडियो चलाना

प्लेयर की आवाज़ कम या ज़्यादा करना

प्लेयर का आकार सेट करना

वीडियो चलाने की रफ़्तार सेट करना

प्लेलिस्ट के लिए वीडियो चलाने की सुविधा सेट करना

वीडियो चलाने की स्थिति

वीडियो की जानकारी लोड हो रही है

प्लेलिस्ट की जानकारी लोड हो रही है

इवेंट लिसनर को जोड़ना या हटाना

डीओएम नोड ऐक्सेस करना और उनमें बदलाव करना

इवेंट

मोबाइल पर विचार

स्क्रिप्ट अपने-आप चलने और स्क्रिप्ट चलाने की सुविधा

उदाहरण

YT.Player ऑब्जेक्ट बनाए जा रहे हैं

360 डिग्री वाले वीडियो कंट्रोल करना

बदलावों का इतिहास

April 27, 2021

October 13, 2020

October 24, 2019

May 16, 2018

June 19, 2017

August 11, 2016

June 29, 2016

June 24, 2016

January 6, 2016

December 18, 2015

April 28, 2014

March 25, 2014

July 23, 2013

October 31, 2012

August 22, 2012

August 6, 2012

July 19, 2012

July 16, 2012

June 6, 2012

March 30, 2012

March 26, 2012

`YT.Player` ऑब्जेक्ट बनाए जा रहे हैं