Filters/rtmp: Difference between revisions
Fred Woolard (talk | contribs) (Add How to use section) |
Fred Woolard (talk | contribs) No edit summary |
||
| Line 1: | Line 1: | ||
The '''RTMP streaming media filter''' is used to replace links containing URLs beginning with rtmp:// with a Flowplayer media player using their [http://flash.flowplayer.org/plugins/streaming/rtmp.html rtmp plugin]. It is contributed by [ | The '''RTMP streaming media filter''' is used to replace links containing URLs beginning with rtmp:// with a Flowplayer media player using their [http://flash.flowplayer.org/plugins/streaming/rtmp.html rtmp plugin]. It is contributed by [http://moodle.org/user/view.php?id=286444 Lacey Vickery] and [http://moodle.org/user/view.php?id=268334 Fred Woolard]. | ||
Page output is examined for anchor href values beginning with rtmp:// and ending with a supported extension (currently .mp3, .mp4, and . | Page output is examined for anchor href values beginning with rtmp:// and ending with a supported extension (currently .mp3, .mp4, .flv, and .f4v). Qualifying links are replaced with a div tag containing 'data-' prefixed attributes that are subsequently used by the plugin's JavaScript module to apply a Flowplayer player to the div. The Adobe Flash Player browser plugin is required. | ||
The plugin was developed to work with Adobe's Flash Media Server, but according to Flowplayer, their [http://flash.flowplayer.org/plugins/streaming/rtmp.html | The plugin was developed to work with Adobe's Flash Media Server, but according to Flowplayer, their [http://flash.flowplayer.org/plugins/streaming/rtmp.html RTMP plugin] should work with Wowza, and Red5 as well. The plugin has been tested successfully with Amazon's Cloudfront streaming service. | ||
=Installation= | =Installation= | ||
| Line 14: | Line 14: | ||
In places where you can enter HTML (e.g. wysiwyg editor for topic summary, page resource, etc.), create a link and supply a URL that references the media stream you want to play. The URL would look something like: ''rtmp://fms.example.org/vod/classes/lecture01.flv'' | In places where you can enter HTML (e.g. wysiwyg editor for topic summary, page resource, etc.), create a link and supply a URL that references the media stream you want to play. The URL would look something like: ''rtmp://fms.example.org/vod/classes/lecture01.flv'' | ||
The file extensions filtered are: '''.flv, .mp4, and .mp3''' | The file extensions filtered are: '''.flv, .mp4, .f4v, and .mp3''' | ||
==Cloudfront Streams== | ==Cloudfront Streams== | ||
Amazon's Cloudfront streaming requires the Flowplayer config values for netConnectionUrl, and the clip's URL to be slightly different. For streams originating at Cloudfront append the following query string paramter to the URL so the filter will adjust accordingly: '''?provider=acf''' | Amazon's Cloudfront streaming requires the Flowplayer config values for netConnectionUrl, and the clip's URL to be slightly different. For streams originating at Cloudfront append the following query string paramter to the URL so the filter will adjust accordingly: '''?provider=acf''' | ||
=Playlists= | |||
Support for playlists has been added. Refer to the [[Playlist plugin]] docs. | |||
=Where to Find= | =Where to Find= | ||
The plugin can be found in the Modules and plugins database [ | The plugin can be found in the Modules and plugins database [http://moodle.org/plugins/view.php?plugin=filter_rtmp here]. | ||
=Source code= | =Source code= | ||
The source code repository is located at github.com in the [ | The source code repository is located at github.com in the [http://github.com/appalachianstate/moodle-filter_rtmp appalachianstate/moodle-filter_rtmp] repository. | ||
[[Category:Contributed code]] | [[Category:Contributed code]] | ||
Revision as of 14:58, 12 September 2013
The RTMP streaming media filter is used to replace links containing URLs beginning with rtmp:// with a Flowplayer media player using their rtmp plugin. It is contributed by Lacey Vickery and Fred Woolard.
Page output is examined for anchor href values beginning with rtmp:// and ending with a supported extension (currently .mp3, .mp4, .flv, and .f4v). Qualifying links are replaced with a div tag containing 'data-' prefixed attributes that are subsequently used by the plugin's JavaScript module to apply a Flowplayer player to the div. The Adobe Flash Player browser plugin is required.
The plugin was developed to work with Adobe's Flash Media Server, but according to Flowplayer, their RTMP plugin should work with Wowza, and Red5 as well. The plugin has been tested successfully with Amazon's Cloudfront streaming service.
Installation
- Select the correct version of the filter_rtmp.zip plugin for your Moodle installation.
- Unpack the .zip file into the filter/ folder of your Moodle site.
- Access the notifications page (Site administration->Notifications) to initiate installation.
- Enable and configure the plugin (Site administration->Plugins->Filters->Manage filters).
How to use
In places where you can enter HTML (e.g. wysiwyg editor for topic summary, page resource, etc.), create a link and supply a URL that references the media stream you want to play. The URL would look something like: rtmp://fms.example.org/vod/classes/lecture01.flv
The file extensions filtered are: .flv, .mp4, .f4v, and .mp3
Cloudfront Streams
Amazon's Cloudfront streaming requires the Flowplayer config values for netConnectionUrl, and the clip's URL to be slightly different. For streams originating at Cloudfront append the following query string paramter to the URL so the filter will adjust accordingly: ?provider=acf
Playlists
Support for playlists has been added. Refer to the Playlist plugin docs.
Where to Find
The plugin can be found in the Modules and plugins database here.
Source code
The source code repository is located at github.com in the appalachianstate/moodle-filter_rtmp repository.
