Moodle PHP Documentation 4.5
Moodle 4.5dev (Build: 20240606) (d3ae1391abe)
media_html5audio_plugin Class Reference

Player that creates HTML5 <audio> tag. More...

Inheritance diagram for media_html5audio_plugin:
core_media_player_native core_media_player

Public Member Functions

 embed ($urls, $name, $width, $height, $options)
 Generates code required to embed the player.
 
 get_embeddable_markers ()
 Lists keywords that must be included in a url that can be embedded with this player.
 
 get_rank ()
 Default rank.
 
 get_supported_extensions ()
 Gets the list of file extensions supported by this media player.
 
 is_enabled ()
 
 list_supported_urls (array $urls, array $options=array())
 Given a list of URLs, returns a reduced array containing only those URLs which are supported by this player.
 
 setup ($page)
 Setup page requirements.
 
 supports ($usedextensions=[])
 Returns human-readable string of supported file/link types for the "Manage media players" page.
 

Static Public Member Functions

static add_attributes ($tag, $attributes)
 Adds attributes to the media tags.
 
static compare_by_rank ()
 
static get_attribute ($tag, $attrname, $type=PARAM_RAW)
 Extracts a value for an attribute.
 
static remove_attributes ($tag, $attrname)
 Removes an attribute from the media tags.
 
static replace_sources ($tag, $sources)
 Replaces all embedded <source> tags and src attribute.
 

Public Attributes

const LINKPLACEHOLDER = '<!--LINKFALLBACK-->'
 Placeholder text used to indicate where the link fallback is placed.
 
const PLACEHOLDER = '<!--FALLBACK-->'
 Placeholder text used to indicate where the fallback content is placed within a result.
 

Protected Member Functions

 get_name ($name, $urls)
 Obtains suitable name for media.
 

Static Protected Member Functions

static pick_video_size (&$width, &$height)
 Utility function that sets width and height to defaults if not specified as a parameter to the function (will be specified either if, (a) the calling code passed it, or (b) the URL included it).
 

Detailed Description

Player that creates HTML5 <audio> tag.

Author
2011 The Open University
License
http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

Member Function Documentation

◆ add_attributes()

static core_media_player_native::add_attributes ( $tag,
$attributes )
staticinherited

Adds attributes to the media tags.

Parameters
string$taghtml tag which properties are extracted, for example "<video ...>....</video>"
array$attributeskey-value pairs of attributes to be added
Return values
string

◆ compare_by_rank()

static core_media_player::compare_by_rank ( )
staticinherited
Deprecated
since Moodle 3.2

◆ embed()

media_html5audio_plugin::embed ( $urls,
$name,
$width,
$height,
$options )

Generates code required to embed the player.

The returned code contains a placeholder comment '' (constant core_media_player\PLACEHOLDER) which indicates the location where fallback content should be placed in the event that this type of player is not supported by user browser.

The $urls parameter includes one or more alternative media formats that are supported by this player. It does not include formats that aren't supported (see list_supported_urls).

The $options array contains key-value pairs. See OPTION_xx constants for documentation of standard option(s).

Parameters
array$urlsURLs of media files
string$nameDisplay name; '' to use default
int$widthOptional width; 0 to use default
int$heightOptional height; 0 to use default
array$optionsOptions array
Return values
stringHTML code for embed

Reimplemented from core_media_player.

◆ get_attribute()

static core_media_player_native::get_attribute ( $tag,
$attrname,
$type = PARAM_RAW )
staticinherited

Extracts a value for an attribute.

Parameters
string$taghtml tag which properties are extracted, for example "<video ...>....</video>"
string$attrnamename of the attribute we are looking for
string$typeone of PARAM_* constants to clean the attribute value
Return values
string|null

◆ get_embeddable_markers()

core_media_player::get_embeddable_markers ( )
inherited

Lists keywords that must be included in a url that can be embedded with this player.

Any such keywords should be added to the array.

For example if this player supports FLV and F4V files then it should add '.flv' and '.f4v' to the array. (The check is not case-sensitive.)

Default handling calls the get_supported_extensions function, so players only need to override this if they don't implement get_supported_extensions.

This is used to improve performance when matching links in the media filter.

Return values
arrayArray of keywords to add to the embeddable markers list

Reimplemented in media_videojs_plugin, media_vimeo_plugin, and media_youtube_plugin.

◆ get_name()

core_media_player::get_name ( $name,
$urls )
protectedinherited

Obtains suitable name for media.

Uses specified name if there is one, otherwise makes one up.

Parameters
string$nameUser-specified name ('' if none)
array$urlsArray of moodle_url used to make up name
Return values
stringName

◆ get_rank()

media_html5audio_plugin::get_rank ( )

Default rank.

Return values
int

Reimplemented from core_media_player.

◆ get_supported_extensions()

media_html5audio_plugin::get_supported_extensions ( )

Gets the list of file extensions supported by this media player.

Note: This is only required for the default implementations of list_supported_urls(), get_embeddable_markers() and supports(). If you override these functions to determine supported URLs in some way other than by extension, then this function is not necessary.

Return values
arrayArray of strings (extension not including dot e.g. '.mp3')

Reimplemented from core_media_player_native.

◆ is_enabled()

core_media_player::is_enabled ( )
inherited
Deprecated
since Moodle 3.2

◆ list_supported_urls()

media_html5audio_plugin::list_supported_urls ( array $urls,
array $options = array() )

Given a list of URLs, returns a reduced array containing only those URLs which are supported by this player.

(Empty if none.)

Parameters
array$urlsArray of moodle_url
array$optionsOptions (same as will be passed to embed)
Return values
arrayArray of supported moodle_url

Reimplemented from core_media_player_native.

◆ pick_video_size()

static core_media_player::pick_video_size ( & $width,
& $height )
staticprotectedinherited

Utility function that sets width and height to defaults if not specified as a parameter to the function (will be specified either if, (a) the calling code passed it, or (b) the URL included it).

Parameters
int$widthWidth passed to function (updated with final value)
int$heightHeight passed to function (updated with final value)

Reimplemented in media_html5video_plugin, and media_videojs_plugin.

◆ remove_attributes()

static core_media_player_native::remove_attributes ( $tag,
$attrname )
staticinherited

Removes an attribute from the media tags.

Parameters
string$taghtml tag which properties are extracted, for example "<video ...>....</video>"
string | array$attrname
Return values
string

◆ replace_sources()

static core_media_player_native::replace_sources ( $tag,
$sources )
staticinherited

Replaces all embedded <source> tags and src attribute.

Parameters
string$taghtml tag which properties are extracted, for example "<video ...>....</video>"
string$sourcesreplacement string (expected to contain <source> tags)
Return values
string

◆ setup()

core_media_player::setup ( $page)
inherited

Setup page requirements.

The typical javascript requirements MUST not take action on the content directly. They are meant to load the required libraries and listen to events in order to know when to take action. The role of this method is not to provide a way for plugins to look for content to embed on the page. The self::embed() method is meant to be used for that.

Parameters
moodle_page$pageThe page we are going to add requirements to.
Since
Moodle 3.2

Reimplemented in media_videojs_plugin.

◆ supports()

core_media_player::supports ( $usedextensions = [])
inherited

Returns human-readable string of supported file/link types for the "Manage media players" page.

Parameters
array$usedextensionsextensions that should NOT be highlighted
Return values
string

Reimplemented in media_videojs_plugin.

Member Data Documentation

◆ LINKPLACEHOLDER

const core_media_player::LINKPLACEHOLDER = '<!--LINKFALLBACK-->'
inherited

Placeholder text used to indicate where the link fallback is placed.

No other players will apply to it but it will be converted to the link in the end (unless prevented by OPTION_NO_LINK).


The documentation for this class was generated from the following file: