Able Player

Introduction

Able Player is a fully
accessible cross-browser media player created by accessibility specialist
Terrill Thompson. It uses the HTML5 <audio> or <video> element for browsers that support them.

Details on the usage of the Able Player library, including up-to-date support
for filetypes and third-party media hosts, may be found at the Able Player
GitHub page.

Version 3.4.3

This version ships with Able Player library 5.0.0. If you currently write code against the able player javascript 5.0.0 introduces several breaking changes. Review that to determine if any code needs to be updated. Version 3.4.2 is stable and can be used until your code is upgraded.

Requirements

This module requires no modules outside of Drupal core.

This module requires the Drupal core Media module and if you are wishing to enable multiple caption files to support additonal languages, you will need to enable the translation core module.

Installation

1. Download and enable the module using Composer, Drush, or file upload.
2. Enable the module either either through the Drupal admin
   (Extend › Media › Ableplayer) or Drush (drush pm-enable ableplayer).

Configuration

In Able Player 3.x, local video configuation is handled via install. If you are coming from Drupal 8.x, you will need to follow steps 1 and 2.

1. If necessary, create a Video Media type, Structure › Media › Add (admin/structure/media/add) and select Video file as the media source.
2. Set the video file format to Ableplayer from Structure › Media Types › Video
   › Manage display (/admin/structure/media/manage/videos/display) under the display column. Change this display to use Ableplayer.

Remote Video

If you're using remote video (YouTube or Vimeo), configure Able Player to be used by going to Structure › Media Types › Remote Video › Manage display('admin/structure/media/manage/remote_video/display') and choose Able Player Remote Video as the format.

Usage

1. Navigate to Content › Media and select the 'Add media' button.
2. Upload your video file and associated captions, descriptions, chapters, poster image, or sign language video, if applicable.
3. Attach the video to content using the desired method (Media Browser, entity reference, etc.)
4. The video will render with the Able Player wrapper and controls. The output
   should be similar to that found in the Able Player examples.

Additional Language Captions

You must enable the translation core module and add the languages you wish to support at site-url/admin/config/regional/language.

1. Navigate to Content > Media and select the 'Add media' button.
2. Select Able Player Caption
3. Upload your primary language caption file and save the entity
4. Select the caption you just added and then choose the translate option
5. Upload your next language and save the entity