Extensión:TimedMediaHandler
![]() Estado de lanzamiento: estable |
|
---|---|
![]() |
|
Implementación | Multimedia, API |
Descripción | Provee la compatibilidad integrada con transcodificación desde el servidor, WebM, Ogg Theora, Vorbis, MP3, Speex y texto temporizado |
Autor(es) | Michael Dale, Jan Gerber, Tim Starling, James Heinrich, Brooke Vibber, Derk-Jan Hartman |
Última versión | 0.6.0 |
Política de compatibilidad | Lanzamientos de screenshots junto con MediaWiki. Master no es compatible con versiones anteriores. |
MediaWiki | >= 1.43 |
Cambios de la base de datos | Sí |
Tablas | transcode |
Licencia | GNU Licencia Pública general 2.0 o posterior |
Descarga | |
|
|
|
|
|
|
Descargas trimestrales | 209 (Ranked 32nd) |
Wikis públicos que lo utilizan | 1,290 (Ranked 218th) |
Traduce la extensión TimedMediaHandler si está disponible en translatewiki.net | |
Asuntos | Tareas abiertas · Reportar un bug |
La extensión TimedMediaHandler permite mostrar archivos de audio y vídeo en las páginas de un wiki mediante la misma sintaxis que se usa para añadir imágenes. Incluye el [$kaltura reproductor HTML5 Kaltura] y un reproductor VideoJS experimental. Hay soporte para subtítulos y descripciones (también conocido como texto cronometrado) y cambio de flujo en tiempo real entre múltiples archivos WebM y otros derivados y muchas otras características. El soporte del servidor de TMH incluye opciones para cargar audio y video HTML5, múltiples perfiles de transcodificación para entregar contenido, reproducción de archivos MIDI, análisis de metadatos para videos Ogg y WebM e integración con el sistema jobQueue de MediaWiki para programar trabajos de transcodificación.
For new and upcoming developments in 2022 and beyond, see Extension:TimedMediaHandler/2022 work.
Resumen de funcionalidades
For the player see: VideoJS Player.
Véase Commons:Timed Text.
Sinopsis de la sintaxis
Además de la sintaxis de inserción de imágenes, Timed Media Handler admite:
- [[File:Video.ogv]]
- Mostrar un vídeo en su dimensión nominal. Muestra un fotograma del punto medio de su longitud con un botón de reproducción que ejecuta un reproductor incrustado.
- [[File:Audio.oga]]
- Mostrar un marcador de posición para un archivo de sonido, con un botón de reproducción que ejecuta un reproductor incrustado. The player will appear inline or as a pop-up if the audio file has closed captioning/subtitles.
- [[File:Midi.mid]]
- Genere audio digital a partir de las instrucciones de música en el archivo MIDI y muestre el reproductor de audio incorporado para reproducir este audio.
- [[File:Video.ogv|thumb]]
- Mostrar un vídeo en un cuadro de miniatura flotante
<gallery>File:Video.ogv</gallery>
- Mostrar un vídeo incrustado en una galería de imágenes (al pulsar en un clip se creará un cuadro emergente con el reproductor completo)
- [[File:Video.ogg|thumbtime=1:25]]
- Utilizar un fotograma correspondiente a 1 minuto y 25 segundos como la imagen del marcador de posición. Un número entero se toma como la cantidad de desfase en segundos. También se puede utilizar HH:MM:SS, p. ej. 1:02:22 serán 1 hora, 2 minutos y 22 segundos en el video. Floating-point seconds are supported (but broken on Wikimedia wikis: phab:T228467).
- [[File:Video.ogg|start=1:25]]
- Fragmentos de multimedia temporal muestra un clip de vídeo a partir de 1 minuto y 25 segundos del vídeo. Un solo número se toma como compensación en segundos. También puede incluir una hora de finalización con el formato $1, lo que daría como resultado un clip de 5 segundos reproduciéndose de 1:25 a 1:30. Si no se proporciona la duración en la miniatura, la hora de inicio se utilizará para la miniatura mostrada. A single number is taken as an offset in seconds. You can also include an end time of the form
end=1:30
which would result in a clip of 5 seconds playing from 1:25 to 1:30. If thumbtime is not provided, the start time will be used for the displayed thumbnail. También se puede utilizar HH:MM:SS, p. ej. 1:02:22 serán 1 hora, 2 minutos y 22 segundos en el video. start=
andend=
can also be used as query parameters in the URL for a video's file page.- [[File:Video.ogg|muted]]
- Start the media with muted audio. (introducido en 1.39)
- [[File:Video.ogg|loop]]
- Loop the video continuously. (introducido en 1.39)
- En desuso
- Las palabras de sintaxis noicon y noplayer están en desuso y no funcionan. Es probable que la palabra clave disablecontrols quede en desuso. (Véase task T135537) Toma una lista separada por comas de cualquiera de los siguientes valores: options, timedText, fullscreen
Compatibilidad con clientes
[[File:Videoonwikipedia.ogv|300px|thumb|...]]
[[File:example.ogg|thumb|...]]
[[File:example.ogg|30px]]
[[File:example.ogg]]
El reproductor funciona en la mayoría de los navegadores modernos y es compatible con IE9 y versiones posteriores (los navegadores modernos como se describe en la matriz de soporte de MediaWiki). El soporte móvil es irregular, especialmente en iOS.
A partir de agosto de 2015, TimedMediaHandler incluye una corrección de compatibilidad de JavaScript para audio/video en formato Ogg, que funciona en los navegadores Safari, Internet Explorer 10/11 y Microsoft Edge.
Terceros usuarios de MediaWiki también pueden desear habilitar manualmente la compatibilidad con MP4 H.264/AAC para la reproducción nativa de video y audio en Safari/IE/Edge, pero al usar estos formatos, es posible que necesite una licencia de patente de MPEG-LA para la transmisión por Internet.
Instalación
Si desea descargue una versión reciente de ffmpeg para admitir la codificación en WebM (con la última versión de VP8).
- Descarga y extrae los archivos en un directorio denominado «
TimedMediaHandler
» dentro de la carpetaextensions/
.
Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/TimedMediaHandler - Cuando se efectúa la instalación desde Git, hay que ejecutar Composer para que se instalen las dependencias de PHP; para este efecto, ejecute
composer install --no-dev
en el directorio de la extensión. (ver task T173141 para complicaciones potenciales) - Añade el siguiente código en la parte final de tu archivo LocalSettings.php :
wfLoadExtension( 'TimedMediaHandler' ); $wgFFmpegLocation = '/usr/bin/ffmpeg'; // Most common ffmpeg path on Linux
- Ejecuta la secuencia de actualización, que creará automáticamente las tablas de la base de datos que necesita esta extensión.
- Configure as required.
- You may need to increase the allowed memory in $wgMaxShellMemory .
- Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.
La extensión agregará automáticamente los tipos de archivos admitidos (excepto mp4) a $wgFileExtensions , por lo que no es necesario que agregue manualmente los tipos de archivos de vídeo.
Entonces, después de la instalación, cambie al directorio que contiene la extensión, p. ej. "../extensions/TimedMediaHandler/" y ejecute composer install --no-dev
, o al actualizar: composer update --no-dev
.
Alternativamente, así como preferiblemente, agregue la línea "extensions/TimedMediaHandler/composer.json"
al archivo "composer.local.json" en el directorio raíz de su wiki como, por ejemplo.
{
"extra": {
"merge-plugin": {
"include": [
"extensions/TimedMediaHandler/composer.json"
]
}
}
}
Comparación de opciones de codificación de archivos multimedia en Wikipedia
As of 2018, Wikimedia sites use VP9.
Sorted by bandwidth tier:
Tasa de bits | Mbit/s | WebM VP8 | WebM VP9 |
---|---|---|---|
Super Low | 0.08 | 160p | |
Very Low | 0.16 | 160p | 240p |
Low | 0.25 | 240p | 360p |
Moderate | 0.5 | 360p | 480p |
Medium | 1.0 | 480p | 720p |
High | 2.0 | 720p | 1080p |
Very high | 4.0 | 1080p | 1440p |
Super high | 8.0 | 2160p |
Opciones detalladas:
Nombre | 160P | 240P | 360P | 480P | 720P | 1080P | 160P | 240P | 360P | 480P | 720P | 1080P | 1440P | 2160P | |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Contenedor | WebM | ||||||||||||||
Vídeo | Codificación | VP8 | VP9 | ||||||||||||
Anchura máxima (píxeles) | 288 | 426 | 640 | 854 | 1280 | 1920 | 288 | 426 | 640 | 854 | 1280 | 1920 | 2560 | 4096 | |
Altura máxima (píxeles) | 160 | 240 | 360 | 480 | 720 | 1080 | 160 | 240 | 360 | 480 | 720 | 1080 | 1440 | 2160 | |
Tasa de bits (Mbit/s) | 0.16 | 0.25 | 0.5 | 1.0 | 2.0 | 4.0 | 0.08 | 0.16 | 0.25 | 0.5 | 1.0 | 2.0 | 4.0 | 8.0 | |
Audio | Codificación | Vorbis | Opus | ||||||||||||
Canales | 2 (stereo) | (pass-through) | |||||||||||||
Frecuencia de muestreo (Hz) | 44100 | 48000 | |||||||||||||
Calidad | - | 1 | 2 | 3 | - | (default) |
Configuración
Esta página está desactualizada. |
A continuación, se muestran algunas variables de configuración que pueden resultar útiles:
// The minimum size for an embedded video player (smaller than this size uses a pop-up player).
$wgMinimumVideoPlayerSize = 200;
// If transcoding is enabled for this wiki (if disabled, no transcode jobs are added, and no transcode status is displayed).
// Note: if remote embedding an asset, we will still check if the remote repo has transcoding enabled and associated flavors
// for that media embed.
$wgEnableTranscode = true;
// Exclude transcoding jobs from the default job runner because they take very long to complete
$wgJobTypesExcludedFromDefaultQueue[] = 'webVideoTranscode';
$wgJobTypesExcludedFromDefaultQueue[] = 'webVideoTranscodePrioritized';
// The total amount of time a transcoding shell command can take:
$wgTranscodeBackgroundTimeLimit = 3600 * 8;
// Maximum amount of virtual memory available to transcoding processes in KB
$wgTranscodeBackgroundMemoryLimit = 2 * 1024 * 1024; // 2GB avconv, ffmpeg2theora mmap resources so virtual memory needs to be high enough
// Maximum file size transcoding processes can create, in KB
$wgTranscodeBackgroundSizeLimit = 3 * 1024 * 1024; // 3GB
// Number of threads to use in avconv for transcoding
$wgFFmpegThreads = 1;
// The NS for TimedText (registered on MediaWiki.org)
// https://www.mediawiki.org/wiki/Extension_namespace_registration
// Note commons pre-dates TimedMediaHandler and should set $wgTimedTextNS = 102 in LocalSettings.php
$wgTimedTextNS = 710;
// Set TimedText namespace for ForeignDBViaLBRepo on a per wikiID basis
// $wgTimedTextForeignNamespaces = [ 'commonswiki' => 102 ];
$wgTimedTextForeignNamespaces = [];
/**
* Default enabled transcodes
*
* -If set to empty array, no derivatives will be created
* -Derivative keys encode settings are defined in WebVideoTranscode.php
*
* -These transcodes are *in addition to* the source file.
* -Only derivatives with a smaller width than the source asset size will be created
* -Regardless of source size, at least one WebM and Ogg source will be created from the $wgEnabledTranscodeSet
* -Derivative jobs are added to the MediaWiki JobQueue the first time the asset is uploaded
* -Derivative should be listed min to max
*/
// Starting from 1.31
// All valid string values are listed in the extension's extension.json file
$wgEnabledTranscodeSet = [
'160p.webm' => true,
'240p.webm' => true,
'360p.webm' => true,
'480p.webm' => true,
'720p.webm' => true,
'1080p.webm' => true,
];
$wgEnabledAudioTranscodeSet = [
'ogg' => true, // ogg+vorbis
'opus' => false, // ogg+opus
'mp3' => true, // raw mp3
'm4a' => false, // mp4+aac (mp4a.40.5)
];
// If mp3 source assets can be ingested:
$wgTmhEnableMp3Uploads = true;
// If mp4 source assets can be ingested:
$wgTmhEnableMp4Uploads = false;
// If you use ffmpeg 2, it can be set to true
$wgUseFFmpeg2 = false;
Para la transcodificación, asegúrese de tener $wgMaxShellMemory
, $wgMaxShellTime
, $wgMaxShellFileSize
que son lo suficientemente grandes como para permitir que los trabajos de codificación se ejecuten y guarden lo realizado. Lo más probable es que los valores predeterminados sean demasiado bajos.
Ejecución de tareas de transcodificación
Debido a que los trabajos de transcodificación consumen muchos recursos, no se ejecutarán como parte de la cola de trabajos normal (véase el task T29336). En su lugar, deben solicitarse mediante el argumento $2:
Configure Localsettings.php
with:
$wgJobTypesExcludedFromDefaultQueue[] = 'webVideoTranscode';
$wgJobTypesExcludedFromDefaultQueue[] = 'webVideoTranscodePrioritized';
Setup dedicated jobrunners and request running the jobs by the --type
argument:
php ./maintenance/run.php runJobs --type webVideoTranscode
php ./maintenance/run.php runJobs --type webVideoTranscodePrioritized
It is very important to run these tasks as the webserver user.
A single transcode job for a video can easily take an hour or longer, so ensure the commands have enough time and CPU to run.
Nodos de codificación
Para poder transcodificar muchos videos, es posible que desee ejecutar varios nodos de codificación que se conecten a la base de datos maestra y accedan a su almacén de archivos directamente. Necesitará instalar ffmpeg.
Instalación mínima en Debian y Ubuntu
apt install ffmpeg
Plus, add this to your LocalSettings.php (tested for Devuan ASCII (Archived 2018-09-23 at the Wayback Machine) only):
$wgFFmpegLocation = '/usr/bin/ffmpeg';
Troubleshooting
Please note that versions of TimedMediaHandler before MediaWiki 1.38 did not work with PostgreSQL. See task T157424.
ffmpeg
– failed to map segment from shared object- You need to increase the allowed memory in $wgMaxShellMemory .
- Class 'getID3' not found
- You need to install the extension's PHP dependencies using Composer; see the installation section.
- Unrecognized option 'max_muxing_queue_size'
- You may be using ffmpeg 2. You need add
$wgUseFFmpeg2 = true;
to yourLocalSettings.php
. - Unrecognized option 'max_muxing_queue_size'
- You may be using ffmpeg 2. You need add
$wgUseFFmpeg2 = true;
to yourLocalSettings.php
. - [exception] […] /index.php?title=Special:Upload Error: Call to undefined method FSFile::getLocalRefPath()
- This extension is incompatible with Extension:EmbedVideo . Uninstall it. You may also need to make sure you did the composer steps properly.
See also
Esta extensión está siendo usada en uno o más proyectos de Wikimedia. Esto significa probablemente que la extensión es estable y funciona lo suficientemente bien como para ser usada en sitios con gran cantidad de visitas. Puedes buscar el nombre de esta extensión en los archivos CommonSettings.php e InitialiseSettings.php de Wikimedia para ver dónde se instala. Encontrarás la lista completa de extensiones instaladas en un wiki en particular en la página Special:Version del wiki. |
Esta extensión está incluida en los siguientes anfitriones/granjas wiki y/o paquetes: No se trata de una lista oficial. Algunas granjas/hosts wiki y/o paquetes pueden tener disponible esta extensión aunque no estén listados aquí. Siempre compruébelo con su anfitrión o granja wiki para confirmarlo. |