Extensión:TimedMediaHandler

This page is a translated version of the page Extension:TimedMediaHandler and the translation is 99% complete.
Outdated translations are marked like this.
Other languages:
Bahasa Indonesia • ‎English • ‎Türkçe • ‎dansk • ‎español • ‎français • ‎português do Brasil • ‎svenska • ‎русский • ‎فارسی • ‎中文 • ‎日本語 • ‎한국어
Extensión matemática MediaWiki
OOjs UI icon advanced.svg
TimedMediaHandler
Estado de lanzamiento estable
Screenshot of TimedMediaHandler extension with Big Buck Bunny as background video.png
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, Brion Vibber, Derk-Jan Hartman
Última versión 0.6.0 (2018-11-07)
Política de compatibilidad Snapshots releases along with MediaWiki. Master is not backwards compatible.
MediaWiki 1.29+
PHP 5.6+
Cambios de la base de datos
Tablas transcode
Licencia GNU Licencia Pública general 2.0 o más tarde
Descarga
  • $wgMediaAudioTypes
  • $wgMediaVideoTypes
  • $wgWaitTimeForTranscodeReset
  • $wgEnableNiceBackgroundTranscodeJobs
  • $wgTmhEnableMp4Uploads
  • $wgUseFFmpeg2
  • $wgEnableTranscode
  • $wgTmhSoundfontLocation
  • $wgTmhWebPlayer
  • $wgTmhPriorityResolutionThreshold
  • $wgFFmpegVP9RowMT
  • $wgEnableIframeEmbed
  • $wgOggThumbLocation
  • $wgParserTestMediaHandlers
  • $wgTranscodeBackgroundSizeLimit
  • $wgTranscodeBackgroundTimeLimit
  • $wgTmhFluidsynthLocation
  • $wgTimedTextForeignNamespaces
  • $wgEnabledAudioTranscodeSet
  • $wgTmhFileExtensions
  • $wgEnabledTranscodeSet
  • $wgTmhUseBetaFeatures
  • $wgMinimumVideoPlayerSize
  • $wgFFmpegThreads
  • $wgMwEmbedModuleConfig
  • $wgTranscodeBackgroundMemoryLimit
  • $wgEnableLocalTimedText
  • $wgFFmpegLocation
  • $wgTmhPriorityLengthThreshold
  • $wgTimedTextNS
  • $wgTranscodeBackgroundPriority
  • transcode-reset
  • transcode-status
Traduce el TimedMediaHandler extensión si es disponible en translatewiki.net

Verificar uso y versión de la matriz.

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 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.

Resumen de funcionalidades

Véase Commons: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|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|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.
[[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 end=1:30, 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. 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.
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 135537) 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
Reproductor de audio más amplio, que muestra una barra de progreso

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). j^ proporciona compilaciones estáticas actualizadas de ffmpeg con soporte WebM para los principales sistemas operativos en firefogg.org/nightly/. Véase las siguientes secciones para obtener instrucciones de instalación en versiones anteriores de MediaWiki.

  • Descarga y extrae los archivos en el directorio «TimedMediaHandler» dentro del directorio extensions/ existente.
  • Cuando instales desde git, ejecuta Composer para instalar dependencias PHP, emitiendo composer install --no-dev en el directorio de extensión. (ver task T173141 para complicaciones potenciales)
  • Añade el siguiente código a tu LocalSettings.php (preferiblemente al final):
    // MediaWiki 1.31 and later
    wfLoadExtension( 'TimedMediaHandler' );
    $wgFFmpegLocation = '/usr/bin/ffmpeg'; // Most common ffmpeg path on Linux
    
  • Ejecuta el script de actualización, que creará automáticamente las tablas que necesita esta extensión en la base de datos.
  • Configure as required.
  • You may need to increase the allowed memory in $wgMaxShellMemory .
  •   Hecho – Navega a Special:Version en tu wiki para verificar que la apariencia 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

See Extension:TimedMediaHandler/VP9 transition for deployment details on planned Wikimedia update from VP8 to VP9.

Sorted by bandwidth tier (grayed items are not currently enabled):

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 = array( 'commonswiki' => 102 );
$wgTimedTextForeignNamespaces = array();

/**
* 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;

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 error 29336). 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';

On older versions of MediaWiki (1.29–1.31)

  • La versión 1.31 no funciona para los administradores de sistema. La extensión ahora requiere wfLoadExtension, elimina la dependencia para la extensión Extensión:MwEmbedSupport , y las constantes PHP de WebVideoTranscode ahora se expresan como valores de cadena.
  • Tenga en cuenta que, aunque MwEmbedSupport was included en TimedMediaHandler para MediaWiki 1.31 y posteriores, para las versiones anteriores de MediaWiki, deberá descargarlo de la página de archivo.

In LocalSettings.php, load the extension with:

// MediaWiki 1.27 - 1.30
wfLoadExtension( 'MwEmbedSupport' );
require_once "$IP/extensions/TimedMediaHandler/TimedMediaHandler.php";

// TimedMediaHandler dependía de MwEmbedSupport hasta la versión 1.30
// MediaWiki 1.27 and earlier
require_once "$IP/extensions/MwEmbedSupport/MwEmbedSupport.php";
require_once "$IP/extensions/TimedMediaHandler/TimedMediaHandler.php";

Prior to 1.31, $wgEnabledTranscodeSet is set with:

// Before 1.31
$wgEnabledTranscodeSet = [
    WebVideoTranscode::ENC_WEBM_160P,
    WebVideoTranscode::ENC_WEBM_240P,
    WebVideoTranscode::ENC_WEBM_360P,
    WebVideoTranscode::ENC_WEBM_480P,
    WebVideoTranscode::ENC_WEBM_720P,
    WebVideoTranscode::ENC_WEBM_1080P
];

$wgEnabledAudioTranscodeSet = [
    WebVideoTranscode::ENC_OGG_VORBIS,
    WebVideoTranscode::ENC_MP3,
];

Troubleshooting

Esta sección necesita ser expandida
"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 above.