Configuración para Transcodificación: [nombre de prontus]-xcoding.cfg

Estas opciones te permiten administrar en detalle la transcodificación de los videos cargados en tu sitio Prontus.

Publicado: Lunes 22 de octubre de 2018 por Adriano Varoli Piazza
Última modificación: Jueves 20 de agosto de 2020
Requisitos básicos

Para que el sistema de transcodificación funcione, más allá de las opciones descritas debajo, tu servidor debe tener correctamente instalado el software ffmpeg con soporte para formatos AAC y h264. Para verificar que las librerías de transcodificación a AAC y h264 se encuentren correctamente instaladas, puedes usar la verificación de software de Prontus, en el menú Administrar  Sistema  Verificar Plataforma, con el botón Verificar Software. Dentro de los resultados de la verificación, en el bloque Soporte para Transcodificación verás si todo está correctamente instalado o no.

Opciones generales

MAX_XCODING

Tamaño máximo (en MB) para la transcodificación de videos.

Valor por defecto

max_xcoding = '500'

DIR_FFMPEG

Indica la ruta a la carpeta donde se encuentra el ejecutable de ffmpeg.

Ejemplo

dir_ffmpeg = '/usr/bin'

USAR_LIB_FDK

Activa el uso de la librería libfdk_aac. Requiere FFMPEG con libfdk_aac instalada. Si no se encuentra disponible, la transcodificación fallará.

Valor por defecto

usar_lib_fdk = 'NO'

Valores posibles

usar_lib_fdk = 'NO'
usar_lib_fdk = 'SI'

LIMIT_BITRATE

Activa los límites de bitrate para los videos subidos, si estos superan los umbrales definidos abajo, serán transcodificados una vez que se guarde el artículo que los contiene.

Valor por defecto

limit_bitrate = 'NO'

Valores posibles

limit_bitrate = 'NO'
limit_bitrate = 'SI'

MAX_VIDEO_BITRATE

Máximo bitrate permitido en el video (en kbps). Si es mayor al ingresado se recodificará el video al guardar el artículo que lo contiene. Depende de la variable limit_bitrate.

Valor por defecto

max_video_bitrate = '1200'

MAX_AUDIO_BITRATE

Máximo bitrate permitido en el audio (en kbps). Si es mayor al ingresado se recodificará el video al guardar el artículo que lo contiene. Depende de la variable limit_bitrate.

Valor por defecto

max_audio_bitrate = '128'

XCODE_MAX_PIXEL

Alto y ancho máximo permitido de la imagen del video (en pixeles), al recodificar se usará este tamaño como máximo.

Valor por defecto

xcode_max_pixel = '854'

GEN_HLS

Activa la generación de segmentos para la distribución de videos vía HLS. Al activar esta opción siempre se transcodificarán los videos. Nota: activar la generación de HLS duplica el uso de espacio de almacenamiento para los videos.

Valor por defecto

gen_hls = 'NO'

Valores posibles

gen_hls = 'NO'
gen_hls = 'SI'

PRECISION_HLS

Activa la utilización de mayor precisión al generar los segmentos para HLS, para lograr una duración de 10 segundos. Requiere FFMPEG versión 1.2.12 o superior.

Valor por defecto

precision_hls = 'NO'

Valores posibles

precision_hls = 'NO'
precision_hls = 'SI'

MODO_PARALELO

Activa el procesamiento simultáneo de las múltiples calidades que serán generadas.

Valor por defecto

modo_paralelo = 'NO'

Valores posibles

modo_paralelo = 'NO'
modo_paralelo = 'SI'

XCODE_MAX_PARALELO

Cantidad máxima de procesos que se ejecutarán al transcodificar un video. Nota: Esta es la cantidad de procesos para cada transcodificación individual, no un máximo global.

Valor por defecto

xcode_max_paralelo = '3'

RUTA_TEMPORAL_XCODING

Indica la ruta absoluta a una carpeta donde se realizará el trabajo de transcodificación, por ejemplo puede ser una unidad de memoria RAM. Es opcional.

Ejemplo

ruta_temporal_xcoding = '/var/www/misitio.cl/ramdisk/'
Opciones de Configuración de Transcodificador Externo

USAR_XCODER_EXTERNO

Activa el uso de un servidor de transcodificación externo.

Valor por defecto

usar_xcoder_externo = 'NO'

Valores posibles

usar_xcoder_externo = 'NO'

usar_xcoder_externo = 'SI'

XCODER_HOST

IP o nombre del host del transcodificador externo para comunicarse con éste a través de HTTP.

Ejemplos

xcoder_host = '192.168.10.110'
xcoder_host = 'mitranscodificador.cl'

XCODER_PORT

Puerto para comunicarse con el transcodificador externo a través de HTTP. Por defecto se usa el 80.

Valor por defecto

xcoder_port = '80'

Ejemplos

xcoder_port = '8080'
Opciones del Editor de Formato de Videos

Estas opciones permiten generar distintos perfiles de transcodificación para distintas marcas de video y distintos formatos de video para esas marcas. Prontus guarda estas configuraciones en el archivo /[nombre de prontus]/cpan/data/formatos_adv.cfg.

Puedes configurar solamente un perfil de transcodificación para tus marcas multimedia_video, o varios. Para cada perfil, los parámetros son opcionales, y si no los ingresas, se usarán valores predefinidos. Puedes averiguar más sobre los valores configurables en la documentación de la librería x264. Si necesitas que Prontus genere además salidas con menor resolución (no es posible generar salidas con resolución mayor a la original), puedes crear perfiles nuevo, agregando sufijos como ".b", ".c", etc. Supongamos que en tu Prontus tienes las marcas multimedia_video1 y multimedia_video2, y que quieres especificar una salida de video secundaria además de la normal. Esto resultaría en los perfiles multimedia_video1, multimedia_video2, multimedia_video1.b y multimedia_video2.b. Puedes modificar los parámetros de configuración para cada uno de estos perfiles.

Nota: la configuración de la marca multimedia_video1 no puede eliminarse completamente: Prontus considera esta marca como la marca por defecto para video.

Parámetros configurables

VIDEOSIZE

Alto y ancho máximo (pixeles) permitido para este formato, al recodificar se usará este valor como máximo. La resolución final siempre debe ser un número múltiplo de 8, de otro modo se escalará.

Valor por defecto

multimedia_video1.videosize = '854'

Ejemplo

multimedia_video1.videosize = '1280'

VIDEOBITRATE

Bitrate de video a utilizar al codificar.

Ejemplo

multimedia_video1.videobitrate = '1100'

H264PROFILE

Perfil de h.264 a utilizar.

Ejemplo

multimedia_video1.h264profile = 'main'
multimedia_video1.b.h264profile = 'baseline'

AUDIOBITRATE

Bitrate de audio a utilizar al codificar.

Valor por defecto

multimedia_video1.audiobitrate = '128'

Ejemplo

multimedia_video1.audiobitrate = '64'

AUDIOSAMPLING

Frecuencia de muestreo del audio.

Ejemplo

multimedia_video1.audiosampling = '22050'

AUDIOCHANNELS

Nro de canales de audio que tendrá el audio recodificado.

Ejemplo

multimedia_video1.audiochannels = '2'

X264

Parámetros especificos a pasar a la libreria x264 durante la transcodificación.

Ejemplo

multimedia_video1.x264 = 'b_adapt=2:trellis=1:cabac=1:bframes=3:keyint=90'