Extensión:TimedMediaHandler

From mediawiki.org
This page is a translated version of the page Extension:TimedMediaHandler and the translation is 57% complete.
Outdated translations are marked like this.
Manual de extensiones de MediaWiki
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.42
Cambios de la base de datos
Tablas transcode
Licencia GNU Licencia Pública general 2.0 o posterior
Descarga
  • $wgMediaAudioTypes
  • $wgMediaVideoTypes
  • $wgWaitTimeForTranscodeReset
  • $wgTmhEnableMp4Uploads
  • $wgUseFFmpeg2
  • $wgEnableTranscode
  • $wgTranscodeSoftSizeLimit
  • $wgTmhPriorityResolutionThreshold
  • $wgFFmpegVP9RowMT
  • $wgEnableIframeEmbed
  • $wgParserTestMediaHandlers
  • $wgTranscodeBackgroundSizeLimit
  • $wgTranscodeBackgroundTimeLimit
  • $wgEnabledAudioTranscodeSet
  • $wgTmhSoundfontLocation
  • $wgEnabledTranscodeSet
  • $wgMinimumVideoPlayerSize
  • $wgFFmpegThreads
  • $wgTmhFluidsynthLocation
  • $wgTranscodeBackgroundMemoryLimit
  • $wgTmhFileExtensions
  • $wgFFmpegLocation
  • $wgTmhPriorityLengthThreshold
  • $wgTimedTextForeignNamespaces
  • $wgTimedTextNS
  • transcode-reset
  • transcode-status
Descargas trimestrales 229 (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.

Please note that TimedMediaHandler does not currently work with PostgreSQL. See task T157424.


Resumen de funcionalidades

For the player see: VideoJS Player.

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.
[[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= and end= 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

Ejemplo del Reproductor de vídeo
Ejemplo del Reproductor de audio

[[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 carpeta extensions/.
    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 .
  • Yes 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.

Después de descargar esta extensión, tenga en cuenta que requiere Composer .

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 sección está desactualizada, por favor actualícela

A continuación, se muestran algunas variables de configuración que pueden resultar útiles:

// The minimum size for an embed 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;

// The total amout 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 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 can be set it 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 --type:

php maintenance/runJobs.php --type webVideoTranscode

Si ejecutar este comando hace que se cuelgue para siempre, es posible que deba configurar $wgTranscodeBackgroundTimeLimit = 0; en LocalSettings.php. Véase task T206957

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

Esta sección necesita ser expandida
ffmpegfailed 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 your LocalSettings.php.
Unrecognized option 'max_muxing_queue_size'
You may be using ffmpeg 2. You need add $wgUseFFmpeg2 = true; to your LocalSettings.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.