The Video XBlock is for embedding videos hosted on different video platforms into your Open edX courses.
Supported video platforms:
The idea of crowd-funded universal video-xblock was proposed by @natea (Appsembler) at the Open edX Conference 2016 at Stanford. It was well-received and several companies offered to sponsor the initial development.
Appsembler initially contracted with Raccoon Gang to build the wistia-xblock as a prototype (see the Github repo), and later created a new Video XBlock featuring universal pluggable interface with several video hosting providers support:
Appsembler and Raccoon Gang will be co-presenting [a talk about the video-xblock] at the Open edX Con 2017 in Madrid.
We welcome folks from the Open edX community to contribute additional video backends as well as report and fix issues.
Thanks to InterSystems and Open University for sponsoring the initial version of the Video XBlock!
sudo -sHu edxapp
source ~/edxapp_env
# Install VideoXBlock using pip
pip install --process-dependency-links -e "git+https://github.com/appsembler/xblock-video.git@dev#egg=video_xblock"
You can enable the Video xblock in studio through the advanced settings:
From the main page of a specific course, click on Settings, Advanced Settings in the top menu.
Check for the Advanced Module List policy key, and add
"video_xblock"
in the policy value list.
Click on the Save changes button.
To embed a video simply copy & paste its URL into a Video URL
field.
Sample supported video URLs:
To successfully use videos hosted on Brightcove Videocloud service one must
provide valid Brightcove account_id
associated with the video. To find out
your account_id
go to Videocloud studio -> Admin -> Account Information.
Grab your BC_TOKEN from Brightcove Videocloud:
var cookiesArray = document.cookie.split(";"), cookiesObj = {}, i, tmpArray = [];
for (i = 0; i < cookiesArray.length; i++) {
tmpArray = cookiesArray[i].split("=");
if (tmpArray[0].indexOf('BC_TOKEN') > -1) {
cookiesObj.BC_TOKEN = tmpArray[1];
}
}
window.prompt("BC_TOKEN:", cookiesObj.BC_TOKEN);
and press <return>
.
Video API Token
section.BC_TOKEN
taken from Brightcvove into Client Token
field.Connect to video platform
button.Given you've connected XBlock to Brightcove platform and have a Video XBlock with a video from Brightcove. You can enablevideo content encryption and/or auto-quality.
To do so:
Brightcove content protection
section.Autoquality
or Autoquality & Encryption
.Re-transcode this video
button.Re-transcode is performed by Brightcove's Videocloud and takes few minutes. After it's done Brightcove Video tech info
section will be updated.
Video Actions
drop-down menu -> Select the Customize
menu item.Captions
menu item.Off
to disable native captions display in the
Video XBlock.Now it is possible to indicate prepopulated values for any xblock field per site installation (see note below).
Sample default settings in /edx/app/edxapp/cms.env.json
:
"XBLOCK_SETTINGS": {
"video_xblock": {
"threeplaymedia_apikey": "987654321",
"account_id": "1234567890"
}
}
Note: here above each provided key corresponds to SITE_NAME environment variable value.
Prereqs: NodeJS >= 4.0
Install development tools and dependencies:
> make tools deps-test
Run quality checks:
> make quality
Run tests:
> make test
VideoXBlock is bundled with a set of XBlock-SDK Workbench scenarios. See workbench docs for details.
The code in this repository is licensed under the GPL v3 licence unless otherwise noted.
Please see LICENSE
file for details.