Transloadit

Concatenar audio

🤖/audio/concat concatena varios archivos de audio.

Robot /audio/concat

Este Robot puede concatenar una cantidad casi infinita de archivos de audio.

Ejemplo de uso

Si tienes un formulario con 3 campos de entrada de archivos y quieres concatenar los audios subidos en un orden específico, indica a Transloadit usando el atributo name de cada campo de entrada. Usa este atributo como valor de la clave fields en el JSON y establece as en audio_[[index]]. Transloadit concatenará los archivos según el orden ascendente del índice:

{
  "steps": {
    "concatenated": {
      "robot": "/audio/concat",
      "use": {
        "steps": [
          {
            "name": ":original",
            "fields": "first_audio_file",
            "as": "audio_1"
          },
          {
            "name": ":original",
            "fields": "second_audio_file",
            "as": "audio_2"
          },
          {
            "name": ":original",
            "fields": "third_audio_file",
            "as": "audio_3"
          }
        ]
      },
      "ffmpeg_stack": "v7"
    }
  }
}

Parámetros

  • interpolate

    boolean | Record<string, boolean>

    Controla si las Assembly Variables se interpolan en campos de instrucciones individuales.

    De forma predeterminada, la mayoría de los campos de instrucciones de los Robots interpolan Assembly Variables. Establece esta opción en false para tratar todos los campos de instrucciones como texto literal, o establece la ruta de un campo individual en false para tratar únicamente ese campo como texto literal. En el caso de los campos específicos de un Robot que son literales de forma predeterminada, establece esta opción en true o la ruta de ese campo en true para volver a habilitar la interpolación.

    Usa nombres de campos como path o rutas con puntos como ffmpeg.vf para los objetos anidados.

  • output_meta

    Record<string, boolean> | boolean | Array<string>

    Te permite especificar un conjunto de metadatos cuyo cálculo requiere más recursos de CPU y que, por lo tanto, está desactivado de forma predeterminada para que tus Assemblies se procesen rápidamente.

    Para imágenes, puedes añadir "has_transparency": true a este objeto para determinar si la imagen contiene partes transparentes y "dominant_colors": true para extraer un array de códigos de color hexadecimales de la imagen.

    Para imágenes, también puedes añadir "blurhash": true para extraer una cadena BlurHash, una representación compacta de un marcador de posición para la imagen que resulta útil para mostrar una vista previa desenfocada mientras se carga la imagen completa.

    Para videos, puedes añadir el parámetro "colorspace": true para extraer el espacio de color del video de salida.

    Para videos, también puedes añadir "interlaced": true para detectar si el video está entrelazado. Esto combina el indicador field_order de ffprobe, cuyo costo en recursos de procesamiento es bajo, con una pasada de muestreo limitada mediante idet sobre los primeros fotogramas de la fuente, y expone interlaced, field_order y un objeto de diagnóstico interlace_detection en file.meta. Esto requiere muchos recursos computacionales y se factura en consecuencia.

    Para audio, puedes añadir "mean_volume": true para obtener un único valor que represente el volumen promedio del archivo de audio.

    También puedes establecerlo en false para omitir la extracción de metadatos y acelerar la transcodificación.

  • user_meta

    Record<string, any>(valor predeterminado: {})

    Añade metadatos personalizados a cada archivo emitido por este Robot sin modificar el contenido del archivo.

    Los valores se combinan con los user_meta existentes en el archivo de entrada. Si ambos objetos contienen la misma clave, el valor de este Robot tiene prioridad. Se admiten Assembly Variables, por ejemplo { "internal_file_id": "${file.id}" }.

  • result

    boolean

    Indica si los resultados de este Step deben aparecer en el Assembly Status JSON

  • queue

    batch

    Establecer la cola en «batch» reduce manualmente la prioridad de los Jobs de este Step para evitar consumir cupos prioritarios con Jobs que no necesitan un tiempo de espera cero en la cola

  • force_accept

    boolean(valor predeterminado: false)

    Forzar a un Robot a aceptar un tipo de archivo que habría ignorado.

    De forma predeterminada, los Robots ignoran los archivos que no reconocen. 🤖/video/encode, por ejemplo, ignorará sin problemas las imágenes de entrada.

    Si configuras el parámetro force_accept como true, puedes forzar a los Robots a aceptar todos los archivos que reciban. Esto normalmente provocará errores y solo debe usarse para depuración o para abordar casos extremos.

  • ignore_errors

    boolean | Array<meta | execute>(valor predeterminado: [])

    Ignorar errores durante fases específicas del procesamiento.

    Establecer este parámetro en ["meta"] hará que el Robot ignore los errores durante la extracción de metadatos.

    Establecer este parámetro en ["execute"] hará que el Robot ignore los errores durante la fase principal de ejecución.

    Configurar este parámetro como true equivale a ["meta", "execute"] y hará que se ignoren los errores en ambas fases.

  • use

    string | Array<string> | Array<object> | object

    Especifica qué Step o Steps se usarán como entrada.

    • Puedes elegir cualquier nombre para los Steps, excepto ":original" (reservado para las subidas de usuarios gestionadas por Transloadit)
    • Puedes proporcionar varios Steps como entrada mediante arrays: 
      {
  "use": [
    ":original",
    "encoded",
    "resized"
  ]
}
    • También puedes etiquetar los Steps de entrada con as para comunicar la intención semántica a los Robots: 
      {
  "use": [
    {
      "name": ":original",
      "as": "image"
    },
    {
      "name": ":original",
      "as": "mask"
    }
  ]
}

  • ffmpeg

    object

    Un objeto de parámetros que se pasará a FFmpeg. Si se utiliza un ajuste preestablecido, las opciones especificadas se combinan con las de ese ajuste. Para consultar las opciones disponibles, revisa la documentación de FFmpeg. Las opciones especificadas aquí tienen prioridad sobre las del ajuste preestablecido.

  • ffmpeg_stack

    v6 | v7 | v8 | string(valor predeterminado: "v7")

    Selecciona la versión del stack de FFmpeg que se usará para el encoding. Actualmente recomendamos usar «v7». Las versiones exactas «v6.0.0», «v7.0.0» y «v8.0.0» son valores heredados que siguen aceptándose por compatibilidad con versiones anteriores. También se aceptan los valores obsoletos «v5.x».

  • preset

    aac | alac | audio/aac | audio/alac | audio/flac | audio/mp3 | audio/ogg |

    Realiza la conversión usando un ajuste preestablecido.

    Si especificas tus propios parámetros de FFmpeg mediante el parámetro ffmpeg del Robot y no has especificado un ajuste preestablecido, el ajuste preestablecido predeterminado mp3 no se aplica. Así no tienes que sobrescribir manualmente cada uno de los valores del ajuste preestablecido MP3.

    Para ver una lista de ajustes preestablecidos de audio, consulta ajustes preestablecidos de audio.

  • bitrate

    string | number

    Tasa de bits del archivo de audio resultante, en bits por segundo. Si no se especifica, se usará de forma predeterminada la tasa de bits del archivo de audio de entrada.

  • sample_rate

    string | number

    Frecuencia de muestreo del archivo de audio resultante, en hercios. Si no se especifica, se usará de forma predeterminada la frecuencia de muestreo del archivo de audio de entrada.

  • audio_fade_seconds

    string | number(valor predeterminado: 1)

    Cuando se usa, esto añade un efecto de fundido de entrada y de salida del audio entre cada sección de tu archivo de audio concatenado. Se usa el valor de tipo float, así que si quieres un efecto de retardo de audio de 500 milisegundos entre cada sección de video, seleccionarías 0,5. También se pueden representar valores enteros.

    Este parámetro no añade un efecto de fundido de audio al principio ni al final de tu archivo de audio resultante. Si quieres hacerlo, crea un Step adicional de 🤖/audio/encode y usa nuestro parámetro ffmpeg como se muestra en esta demostración  (English).

  • crossfade

    boolean(valor predeterminado: false)

    Cuando se establece en true, este parámetro habilita el fundido cruzado entre archivos de audio concatenados usando el filtro acrossfade de FFmpeg. Esto crea una transición suave en la que el final de un archivo de audio se superpone y se mezcla con el comienzo del siguiente archivo.

    La duración del fundido cruzado se controla con el parámetro audio_fade_seconds (el valor predeterminado es 1 segundo si audio_fade_seconds es 0).

    Nota: Este parámetro requiere al menos 2 archivos de audio para concatenar y solo funciona con archivos de audio, no con archivos de video.

  • sort_by

    auto | basename | import_order(valor predeterminado: "basename")

    Controla cómo se ordenan las entradas agrupadas cuando no se usa ningún alias numerado explícito para el tipo de entrada. Los alias numerados terminan con un sufijo numérico como _1.

    El valor predeterminado "basename" conserva el comportamiento heredado de ordenamiento natural por nombre base.

    Establécelo en "import_order" para conservar el orden de los Steps de importación basados en arrays cuando todos los archivos de entrada contengan metadatos completos del orden de importación. "auto" tiene la misma preferencia por el orden de importación y usa el ordenamiento natural por nombre base como alternativa.

Demos

Publicaciones relacionadas del blog