Kode-Kitchen
diff --git a/‎README.md‎
Lines changed: 14 additions & 4 deletions b/‎README.md‎
Lines changed: 14 additions & 4 deletions
diff --git a/‎build/ableplayer.js‎
Lines changed: 24 additions & 7 deletions b/‎build/ableplayer.js‎
Lines changed: 24 additions & 7 deletions
diff --git a/‎media/itaccess.jpg‎
102 KB b/‎media/itaccess.jpg‎
102 KB
@@ -198,6 +198,8 @@ The following attributes are supported on the \<video\> element only:
     default to 360.
 -   **poster** - path to an image file. Will be displayed in the player
     until the video is played.
+-   **data-youtube-id** - optional; 11-character YouTube ID, to play the YouTube video using *Able Player*.
+-   **data-youtube-desc-id** - optional; 11-character YouTube ID of the described version of a video. See the section below on *YouTube Support* for additional information. 
 
 The following additional features are supported by *Able Player*:
 
@@ -340,12 +342,20 @@ Features of the interactive transcript include the following:
 YouTube Support
 ---------------
 
-To play a YouTube video in *Able Player*, simply include the **data-youtube-id** attribute 
+To play a YouTube video in *Able Player*, simply include a **data-youtube-id** attribute 
 on the \<video\> element. The value of this attribute must be the video's 11-character YouTube ID. 
 
-Currently we are unable to access captions via the YouTube API, so even if the video is already 
-captioned on YouTube, captions will need to be included redundantly within *Able Player* 
-as described above in the Closed Captions section.  
+If captions are available on the YouTube video, they will be displayed automatically for users 
+who have captions turned on when watching other YouTube videos. 
+
+If a described version is available of the video, include a **data-youtube-desc-id** attribute 
+on the \<video\> element as well. The value of this attribute must be the 11-character YouTube ID
+of the described version. If users have "Description on by Default" checked within their *Able Player* 
+preferences, the described version of the video will automatically play by default. 
+
+Adjustable playback rate is available for some videos, but only if the user has opted in on using 
+the HTML5 player in YouTube. 
+To opt in, visit the <a href="https://www.youtube.com/html5">YouTube HTML5 Video Player</a> page.   
 
 MIME Types
 ----------
 
@@ -102,13 +102,12 @@
       this.youtubeId = $(media).data('youtube-id'); 
     }
 
-    if ($(media).data('debug') !== undefined && $(media).data('debug') !== "false") { 
-      this.debug = true; 
+    if ($(media).data('youtube-desc-id') !== undefined && $(media).data('youtube-desc-id') !== "") { 
+      this.youtubeDescId = $(media).data('youtube-desc-id'); 
     }
 
-    if ($(media).data('youtube-id') !== undefined && $(media).data('youtube-id') !== "") { 
-      // move this to <source> element
-      this.youtubeId = $(media).data('youtube-id'); 
+    if ($(media).data('debug') !== undefined && $(media).data('debug') !== "false") { 
+      this.debug = true; 
     }
 
     if ($(media).data('volume') !== undefined && $(media).data('volume') !== "") { 
@@ -715,8 +714,19 @@
       var containerId = thisObj.mediaId + '_youtube';
       thisObj.$mediaContainer.prepend($('<div>').attr('id', containerId));
 
+      var youTubeId; 
+      // if a described version is available && user prefers desription 
+      // give them the described version 
+      if (thisObj.youtubeDescId && thisObj.prefDesc) { 
+        youTubeId = thisObj.youtubeDescId; 
+        // TODO: add alert informing the user that the described version is being loaded
+      }
+      else { 
+        youTubeId = thisObj.youtubeId;
+      }
+      
       thisObj.youtubePlayer = new YT.Player(containerId, {
-        videoId: thisObj.youtubeId,
+        videoId: youTubeId,
         height: thisObj.playerHeight.toString(),
         width: thisObj.playerWidth.toString(),
         playerVars: {
@@ -1907,7 +1917,8 @@
 
     this.injectOffscreenHeading();
 
-    if (this.mediaType === 'video') {
+    // youtube adds its own big play button
+    if (this.mediaType === 'video' && this.player !== 'youtube') {
       this.injectBigPlayButton();
 
       // add container that captions or description will be appended to
@@ -4131,6 +4142,10 @@ console.log('number of matching parent elements: ' + prevHeading.length);
     }
     else if (this.player === 'youtube') {
       // Youtube always supports a finite list of playback rates.  Only expose controls if more than one is available.
+console.log('how many playbackrates are supported?');
+var ytrates = this.youtubePlayer.getAvailablePlaybackRates(); 
+console.log(ytrates.length + '. They are: ');
+console.log(ytrates);
       return (this.youtubePlayer.getAvailablePlaybackRates().length > 1);
     }
   };
@@ -4548,6 +4563,8 @@ console.log('fast forwarding ' + this.seekInterval + ' seconds');
     }
     else if (this.player === 'youtube') {
       var rates = this.youtubePlayer.getAvailablePlaybackRates();
+console.log('available playback rates:');
+console.log(rates);
       var currentRate = this.getPlaybackRate();
       var index = rates.indexOf(currentRate);
       if (index === -1) {