Metadatos de entrada

Artículo
01/09/2023

Advertencia

Azure Media Services se retirará el 30 de junio de 2024. Para obtener más información, consulte la Guía de retirada de AMS.

Un trabajo de codificación está asociado a un recurso (o recursos) de entrada donde desea realizar algunas tareas de codificación. Tras la finalización de una tarea, se produce un recurso de salida. El recurso de salida contiene vídeo, audio, miniaturas, manifiestos y otros archivos.

El recurso de salida también contiene un archivo con metadatos sobre el recurso de entrada. El nombre del archivo JSON de metadatos tiene un identificador aleatorio, no lo use para identificar el recurso de entrada al que pertenece el de salida. Para identificar el recurso de entrada al que pertenece, use el campo Uri (para más información, consulte Otros elementos secundarios).

Media Services no realiza un examen preventivo de los recursos de entrada para generar metadatos. Los metadatos de entrada se generan únicamente como artefactos cuando un recurso de entrada se procesa en un trabajo. Por tanto, estos artefactos se escriben en el recurso de salida. Para generar metadatos de los recursos de entrada y salida, se utilizan diferentes herramientas. Por tanto, los metadatos de entrada tienen un esquema ligeramente diferente al de los metadatos de salida.

En este artículo se describen los elementos y los tipos del esquema JSON en que se basan los metadatos de entrada (<id_de_recurso>_metadata.json). Para información acerca del archivo que contiene metadatos sobre el recurso de salida, consulte Metadatos de salida.

Puede encontrar el ejemplo de esquema JSON al final de este artículo.

Nota

Todo el tiempo se basa en el formato ISO-8601. Para obtener más información sobre el formato de duración, consulta Tiempos y duraciones en el mismo artículo.

AssetFile

Contiene una colección de elementos AssetFile para el trabajo de codificación.

Nota

Los cuatro elementos secundarios siguientes deben aparecer en secuencia.

Nombre	Descripción
VideoTracks	Cada archivo de recursos físico puede contener cero o más pistas de vídeos intercaladas en un formato de contenedor adecuado. Para más información, consulte VideoTracks.
AudioTracks	Cada archivo de recursos físico puede contener cero o más pistas de audio intercaladas en un formato de contenedor adecuado. Para más información, consulte AudioTracks.
Metadata	Metadatos del archivo de recursos representados como cadenas de clave-valor. Por ejemplo: `<Metadata key="language" value="eng" />`

Otros elementos secundarios

Nombre	Descripción
Nombre Obligatorio	Nombre del archivo de recursos. Ejemplo: `"Name": "Ignite-short.mp4"`
Uri Obligatorio	Dirección URL donde se encuentra el recurso de entrada. Para identificar el recurso de entrada al que pertenece el recurso de salida, use el campo `Uri` en lugar del identificador.
Tamaño Obligatorio	Tamaño del archivo de recursos en bytes. Ejemplo: `"Size": 75739259`
Duration Obligatorio	Duración de la reproducción del contenido. Ejemplo: `"Duration": "PT1M10.304S"`.
NumberOfStreams Obligatorio	Número de transmisiones en el archivo de recursos. Ejemplo: `"NumberOfStreams": 2`
FormatNames Obligatorio	Nombres de formatos. Ejemplo: `"FormatNames": "mov,mp4,m4a,3gp,3g2,mj2"`
FormatVerboseName Obligatorio	Nombres detallados de formatos. Ejemplo: `"FormatVerboseName": "QuickTime / MOV"`
StartTime	Hora de inicio del contenido. Ejemplo: `"StartTime": "PT0S"`
OverallBitRate	Velocidad de bits media en bits por segundo del archivo de recursos. Ejemplo: `"OverallBitRate": 8618539`

VideoTracks

Nombre	Descripción
FourCC Obligatorio	Código FourCC del códec de vídeo que ffmpeg notifica. Ejemplo: `"FourCC": "avc1" \| "hev1" \| "hvc1"`
Perfil	Perfil de la pista de vídeo. Ejemplo: `"Profile": "Main"`
Level	Nivel de la pista de vídeo. Ejemplo: `"Level": "3.2"`
PixelFormat	Formato de píxel de la pista de vídeo. Ejemplo: `"PixelFormat": "yuv420p"`
Width Obligatorio	Ancho del vídeo codificado en píxeles. Ejemplo: `"Width": "1280"`
Height Obligatorio	Alto del vídeo codificado en píxeles. Ejemplo: `"Height": "720"`
DisplayAspectRatioNumerator Obligatorio	Numerador de la relación de aspecto de pantalla de vídeo. Ejemplo: `"DisplayAspectRatioNumerator": 16.0`
DisplayAspectRatioDenominator Obligatorio	Denominador de la relación de aspecto de pantalla de vídeo. Ejemplo: `"DisplayAspectRatioDenominator": 9.0`
SampleAspectRatioNumerator	Numerador de la relación de aspecto de muestra de vídeo. Ejemplo: `"SampleAspectRatioNumerator": 1.0`
SampleAspectRatioDenominator	Ejemplo: `"SampleAspectRatioDenominator": 1.0`
FrameRate Obligatorio	Velocidad de fotogramas de vídeo medida en formato .3f. Ejemplo: `"FrameRate": 29.970`
Bitrate	Velocidad de bits de vídeo media en bits por segundo, según los cálculos del archivo de recursos. Solo se cuenta la carga de transmisión básica; la sobrecarga de empaquetado no se incluye. Ejemplo: `"Bitrate": 8421583`
HasBFrames	Número de pista de vídeo de fotogramas B. Ejemplo: `"HasBFrames": 2`
Metadata	Cadenas genéricas de clave-valor que sirven para almacenar información de diversa índole. Vea el ejemplo completo al final del artículo.
Id Obligatorio	Índice de base cero de esta pista de audio o vídeo. este identificador no es necesariamente el objeto TrackID que se usa en un archivo MP4. Ejemplo: `"Id": 2`
Codec	Cadena de códec de pista de vídeo. Ejemplo: `"Codec": "h264 \| hev1"`
CodecLongName	Nombre largo del códec de pista de vídeo o audio. Ejemplo: `"CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10"`
Codec	Cadena de códec de pista de vídeo. Ejemplo: `"Codec": "h264 \| hev1"`
TimeBase Obligatorio	Base de tiempo. Ejemplo: `"TimeBase": "1/30000"`
NumberOfFrames	Número de fotogramas (presente para pistas de vídeo). Ejemplo: `"NumberOfFrames": 2107`
StartTime	Hora de inicio de la pista. Ejemplo: `"StartTime": "PT0.033S"`
Duration	Duración de la pista. Ejemplo: `"Duration": "PT1M10.304S"`

AudioTracks

Nombre	Descripción
SampleFormat	Formato de ejemplo. Ejemplo: `"SampleFormat": "fltp"`
ChannelLayout	Distribución de canales. Ejemplo: `"ChannelLayout": "stereo"`
Channels Obligatorio	Número de canales de audio (0 o más). Ejemplo: `"Channels": 2`
SamplingRate Obligatorio	Velocidad de muestreo de audio en muestras/s o Hz. Ejemplo: `"SamplingRate": 48000`
Bitrate	Velocidad de bits de audio media en bits por segundo, según los cálculos en el archivo de recursos. Solo se cuenta la carga de transmisión básica; la sobrecarga de empaquetado no se incluye en este recuento. Ejemplo: `"Bitrate": 192080`
Metadata	Cadenas genéricas de clave-valor que sirven para almacenar información de diversa índole. Vea el ejemplo completo al final del artículo.
Id Obligatorio	Índice de base cero de esta pista de audio o vídeo. No es necesariamente un elemento TrackID como se usa en un archivo MP4. Ejemplo: `"Id": 1`
Codec	Cadena de códec de pista de vídeo. Ejemplo: `"Codec": "aac"`
CodecLongName	Nombre largo del códec de pista de vídeo o audio. Ejemplo: `"CodecLongName": "AAC (Advanced Audio Coding)"`
TimeBase Obligatorio	Base de tiempo. Ejemplo: `"TimeBase": "1/48000"`
NumberOfFrames	Número de fotogramas (presente para pistas de vídeo). Ejemplo: `"NumberOfFrames": 3294`
StartTime	Hora de inicio de la pista. Ejemplo: `"StartTime": "PT0S"`
Duration	Duración de la pista. Ejemplo: `"Duration": "PT1M10.272S"`

Metadatos

Nombre	Descripción
key Obligatorio	La clave del par clave-valor.
value Obligatorio	El valor del par clave-valor.

Ejemplo de esquema

{
  "AssetFile": [
    {
      "VideoTracks": [
        {
          "FourCC": "avc1",
          "Profile": "Main",
          "Level": "3.2",
          "PixelFormat": "yuv420p",
          "Width": "1280",
          "Height": "720",
          "DisplayAspectRatioNumerator": 16.0,
          "DisplayAspectRatioDenominator": 9.0,
          "SampleAspectRatioNumerator": 1.0,
          "SampleAspectRatioNumeratorSpecified": true,
          "SampleAspectRatioDenominator": 1.0,
          "SampleAspectRatioDenominatorSpecified": true,
          "FrameRate": 29.970,
          "Bitrate": 8421583,
          "BitrateSpecified": true,
          "HasBFrames": 2,
          "HasBFramesSpecified": true,
          "Disposition": {
            "Default": 1
          },
          "Metadata": [
            {
              "key": "creation_time",
              "value": "2018-02-21T21:42:08.000000Z"
            },
            {
              "key": "language",
              "value": "eng"
            },
            {
              "key": "handler_name",
              "value": "Video Media Handler"
            },
            {
              "key": "encoder",
              "value": "AVC Coding"
            }
          ],
          "Id": 2,
          "Codec": "h264",
          "CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
          "TimeBase": "1/30000",
          "NumberOfFrames": 2107,
          "NumberOfFramesSpecified": true,
          "StartTime": "PT0.033S",
          "Duration": "PT1M10.304S"
        }
      ],
      "AudioTracks": [
        {
          "SampleFormat": "fltp",
          "ChannelLayout": "stereo",
          "Channels": 2,
          "SamplingRate": 48000,
          "Bitrate": 192080,
          "BitrateSpecified": true,
          "BitsPerSampleSpecified": true,
          "Disposition": {
            "Default": 1
          },
          "Metadata": [
            {
              "key": "creation_time",
              "value": "2018-02-21T21:42:08.000000Z"
            },
            {
              "key": "language",
              "value": "eng"
            },
            {
              "key": "handler_name",
              "value": "Sound Media Handler"
            }
          ],
          "Id": 1,
          "Codec": "aac",
          "CodecLongName": "AAC (Advanced Audio Coding)",
          "TimeBase": "1/48000",
          "NumberOfFrames": 3294,
          "NumberOfFramesSpecified": true,
          "StartTime": "PT0S",
          "Duration": "PT1M10.272S"
        }
      ],
      "Metadata": [
        {
          "key": "major_brand",
          "value": "mp42"
        },
        {
          "key": "minor_version",
          "value": "19529854"
        },
        {
          "key": "compatible_brands",
          "value": "mp42isom"
        },
        {
          "key": "creation_time",
          "value": "2018-02-21T21:42:08.000000Z"
        }
      ],
      "Name": "Ignite-short.mp4",
      "Uri": "https://amsstorageacct.blob.core.windows.net/asset-00000000-0000-0000-000000000000/ignite.mp4",
      "Size": 75739259,
      "Duration": "PT1M10.304S",
      "NumberOfStreams": 2,
      "FormatNames": "mov,mp4,m4a,3gp,3g2,mj2",
      "FormatVerboseName": "QuickTime / MOV",
      "StartTime": "PT0S",
      "OverallBitRate": 8618539,
      "OverallBitRateSpecified": true
    }
  ]
}

Obtener ayuda y soporte técnico

Puede ponerse en contacto con Media Services con preguntas o seguir nuestras actualizaciones mediante uno de los métodos siguientes:

PREGUNTAS Y RESPUESTAS
Stack Overflow. Etiquete las preguntas con azure-media-services.
@MSFTAzureMedia o use @AzureSupport para solicitar soporte técnico.
Abra una incidencia de soporte técnico a través del Azure Portal.

Compartir a través de