diff --git a/docs/en_us/course_authors/source/Images/VideoComponentEditor.gif b/docs/en_us/course_authors/source/Images/VideoComponentEditor.gif new file mode 100644 index 0000000000..e72fe6f1a6 Binary files /dev/null and b/docs/en_us/course_authors/source/Images/VideoComponentEditor.gif differ diff --git a/docs/en_us/course_authors/source/create_video.rst b/docs/en_us/course_authors/source/create_video.rst index 38e555027b..1781172323 100644 --- a/docs/en_us/course_authors/source/create_video.rst +++ b/docs/en_us/course_authors/source/create_video.rst @@ -91,6 +91,8 @@ Transcript Format Your transcript must be an .srt file. +.. note:: Some past courses have used .sjson files for video transcripts. If transcripts in your course uses this format, see :ref:`Steps for sjson files`. We don't recommend that you use .sjson files. + ***************************** Step 3. Post the Video Online @@ -120,20 +122,23 @@ Other Sites You can use any video backup site that you want. However, keep in mind that the site where you post the videos may have to handle a lot of traffic. -.. note:: The URL for the video that you post on a third-party site must end in .mp4, .ogg, or - .mpeg. EdX can't support videos that you post on sites such as Vimeo. +.. note:: The URL for the video that you post on a third-party site must end in .mp4, .mpeg, .ogg, or .webm. EdX can't support videos that you post on sites such as Vimeo. .. _Create a Video Component: -************************* -Create a Video Component -************************* +******************************** +Step 4. Create a Video Component +******************************** #. Under **Add New Component**, click **Video**. #. When the new video component appears, click **Edit**. The video editor opens to the **Basic** tab. + + .. image:: Images/VideoComponentEditor.gif + + You'll replace the default values with your own. #. In the **Display Name** field, enter the name you want students to see when they hover the mouse over the unit in the course accordion. This text also appears as a header for the video. @@ -149,11 +154,15 @@ Create a Video Component #. Next to **Timed Transcript**, select an option. - - If edX has a transcript for your video, Studio automatically finds the transcript and associates the transcript with the video. (If you want to modify the transcript, click **Download to Edit**. You can then make your changes and upload the new file by clicking **Upload New Timed Transcript**.) + - If edX already has a transcript for your video, Studio automatically finds the transcript and associates the transcript with the video. For example, edX may have a transcript for your video if you're using a video from an existing course. + + If you want to modify the transcript, click **Download to Edit**. You can then make your changes and upload the new file by clicking **Upload New Timed Transcript**. - If your video has a transcript on YouTube, Studio automatically finds the transcript and asks if you want to import it. To use this YouTube transcript, click **Import from YouTube**. (If you want to modify the YouTube transcript, click **Download to Edit**. You can then make your changes and upload the new file by clicking **Upload New Timed Transcript**.) - - If neither edX nor YouTube has a transcript for your video, click **Upload New Timed Transcript** to upload a transcript file from your computer. + - If neither edX nor YouTube has a transcript for your video, and your transcript uses the .srt format, click **Upload New Timed Transcript** to upload the transcript file from your computer. + + .. note:: If your transcript uses the .sjson format, do not use this setting. For more information, see :ref:`Steps for sjson files`. #. Optionally, click **Advanced** to set more options for the video. For a description of each option, see the table below. @@ -166,19 +175,54 @@ Advanced Options :widths: 20 80 :header-rows: 0 - * - **Download Transcript** - - If you've uploaded a transcript for your video to a backup website such as Amazon S3, enter the external URL for this transcript. - * - **Download Video** - - If you've uploaded a copy of your video to a backup website such as Amazon S3, enter the external URL for this video. Note this URL must end in .mpeg, .mp4, or .ogg. + * - **Display Name** + - The name that you want your students to see. This is the same as the **Display Name** field on the **Basic** tab. * - **End Time** - The time, formatted as hours, minutes, and seconds (HH:MM:SS), when you want the video to end. * - **HTML5 Transcript** - - The name of the timed transcript track (for non-YouTube videos). + - If you uploaded an .srt file on the **Basic** tab, the name of your .srt file appears in this field by default. You don't have to change this setting. + If your transcript uses an .sjson file, see :ref:`Steps for sjson files`. * - **Show Transcript** - Specifies whether you want the transcript to show by default. Students can always turn transcripts on or off while they watch the video. * - **Start Time** - The time, formatted as hours, minutes, and seconds (HH:MM:SS), when you want the video to begin. + * - **Transcript Download Allowed** + - Specifies whether you want to allow your students to download a copy of the transcript. + * - **Video Download Allowed** + - Specifies whether you want to allow your students to download a copy of the video. * - **Video Sources** - - Additional locations where you've posted the video. This field must contain a URL that ends in .mpeg, .mp4, or .ogg. + - Additional locations where you've posted the video. This field must contain a URL that ends in .mpeg, .mp4, .ogg, or .webm. * - **YouTube ID, YouTube ID for .75x speed, YouTube ID for 1.25x speed, YouTube ID for 1.5x speed** - If you have uploaded separate videos to YouTube for different speeds of your video, enter the YouTube IDs for these videos in these fields. + +.. _Steps for sjson files: + +********************** +Steps for .sjson Files +********************** + +If your course uses .sjson files, you'll upload the .sjson file for the video to the **Files & Uploads** page, and then specify the name of the .sjson file in the Video component. + +.. note:: Only older courses that have used .sjson files in the past should use .sjson files. All new courses should use .srt files. + +#. Obtain the .sjson file from a media company such as 3Play. +#. Change the name of the .sjson file to use the following format: + + ``subs_FILENAME.srt.sjson`` + + For example, if the name of your video is **Lecture1a**, the name of your .sjson file must be **subs_Lecture1a.srt.sjson**. +#. Upload the .sjson file for your video to the **Files & Uploads** page. +#. Create a new video component. +#. On the **Basic** tab, enter the name that you want students to see in the **Display Name** field. +#. In the **Video URL** field, enter the URL of the video. For example, the URL may resemble one of the following. + + :: + + http://youtu.be/OEoXaMPEzfM + http://www.youtube.com/watch?v=OEoXaMPEzfM + https://s3.amazonaws.com/edx-course-videos/edx-edx101/EDXSPCPJSP13-G030300.mp4 + +#. Click the **Advanced** tab. +#. In the **HTML5 Transcript** field, enter the file name of your video. Do not include "subs\_" or ".sjson". For the example in step 2, you would only enter **Lecture1a**. +#. Set the other options that you want. +#. Click **Save**.