Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
TamaraGunkel authored Mar 23, 2022
1 parent e5a91b3 commit 24134e0
Showing 1 changed file with 4 additions and 50 deletions.
54 changes: 4 additions & 50 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,60 +3,14 @@ moodle-mod_opencast
This activity can be used to display and view Opencast episodes and series in Moodle.
Users with respective privileges (in the following called teacher) can specify the ID of an existing Opencast
episode/series to add it to their course. An embedded player allows students to watch the videos directly in Moodle. As with every activity, the teachers can restrict the access to the videos for students based on e.g. dates, grades or user profiles.
The <a href="https://github.com/polimediaupv/paella">Paella player</a> is used to play the videos.
The <a href="https://github.com/polimediaupv/paella-core">Paella player</a> is used to play the videos.

The integration with the <a href="https://moodle.org/plugins/block_opencast">Opencast Videos</a> block makes the handling and access restriction of Opencast videos very simple.
Videos can be uploaded via the block and made available via this activity.
The block offers the functionality to add activities so that teachers don't have to explicitly specify the Opencast IDs.
Therefore, it is recommended to use the block for adding activities. Futher information can be found in the documentation of the block.

System requirements
------------------

* Min. Moodle Version: 3.8
* Min. PHP Version: 7.3
* Opencast API level:
* Minimum: v1.1.0

* Installed plugin: <a href="https://github.com/unirz-tu-ilmenau/moodle-tool_opencast">tool_opencast</a>

Usage scenarios
---------------
In the following, the two usage scenarios, providing a series or an episode, are described.

### Use case 1 - Provide a series ###
The teacher wants to provide a series for students. For example, this series contains all lecture recordings.

Steps to add the activity:
1. Add a new "Video (Opencast)" activity.
2. Enter the Opencast id of the series you want to display:</br>
<img src="https://user-images.githubusercontent.com/28386141/115534096-b5df3e00-a297-11eb-86c4-f69da06b0038.PNG" width="500"></br>
3. If you want, you can specify further configurations like access restrictions.
4. The videos in the series can be either displayed in a list view or in a preview view:</br>
<img src="https://user-images.githubusercontent.com/28386141/115258489-523b0080-a131-11eb-9ac1-0819c9aee5a4.png" width="250">
<img src="https://user-images.githubusercontent.com/28386141/115258708-857d8f80-a131-11eb-81a4-4bdbc295f45e.png" width="250">


### Use case 2 - Provide an episode ###
The teacher wants to provide a single episode for students. For example, this episode belongs to a specific lecture.
1. Add a new "Video (Opencast)" activity.
2. Enter the Opencast id of the episode you want to display as in the previous use case. The activity automatically recognizes that the entered id is an episode.
3. If you want, you can specify further configurations like access restrictions.
4. The activity directly displays a player that shows the video:</br>
<img src="https://user-images.githubusercontent.com/28386141/115257347-4b5fbe00-a130-11eb-92b6-b3bd2f832972.png" width="500"></br>

Configuration
-------------
The activity has two global configurations that can be modified by the administrator.
<img src="https://user-images.githubusercontent.com/28386141/115534550-2f772c00-a298-11eb-98c9-70b3d62bd751.png" width="500"></br>

The first configuration "Opencast Channel" specifies the Opencast channel to which the videos are published. Only videos published in this channel can be displayed with this activity. The publication must include media files, e.g. `.mp4` files, that can be served to the paella player.


The second configuration "URL to Paella config.json" specifies the path to the Paella player config. This config can be adapted if you want to modify the look or behavior of the Paella player.

Videos can be uploaded via the block and made available via this activity.

## Documentation ##

The full documentation of the plugin can be found [here](https://moodle.docs.opencast.org/#mod/about/).

## License ##

Expand Down

0 comments on commit 24134e0

Please sign in to comment.