Compartir a través de


MediaEncodingProfile Clase

Definición

Describe el perfil de codificación de un archivo de audio o vídeo. El perfil de codificación incluye descripciones de los formatos de codificación de audio y vídeo y una descripción del contenedor multimedia.

public ref class MediaEncodingProfile sealed
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class MediaEncodingProfile final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class MediaEncodingProfile final
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class MediaEncodingProfile
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaEncodingProfile
function MediaEncodingProfile()
Public NotInheritable Class MediaEncodingProfile
Herencia
Object Platform::Object IInspectable MediaEncodingProfile
Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Comentarios

La calidad de codificación Auto es un valor preestablecido especial que rellena la configuración adecuada en función de la configuración actual de la cámara. La configuración que se modifica manualmente se omite. Por ejemplo, si crea un perfil preestablecido mediante uno de los métodos de creación estáticos, como CreateM4a, y especifica Auto como calidad de codificación, los cambios realizados en las propiedades se sobrescribirán con valores basados en la configuración de la cámara actual.

Nota:

Es posible crear un archivo MediaEncodingProfile que no se admita en un dispositivo determinado. Por ejemplo, puede llamar correctamente a CreateMp3, pero si un codificador mp3 no está presente en el dispositivo, se producirá un error al intentar codificar audio con las propiedades devueltas desde este método. Para obtener una lista de los códecs presentes de forma predeterminada para cada familia de dispositivos, consulte Códecs admitidos.

Nota

Solo los tipos de perfil de codificación de vídeo admiten la configuración de calidad de codificación automática. Los perfiles de audio no admiten esta configuración y generarán un error cuando se use la configuración. Por ejemplo: si crea un perfil mediante MediaEncodingProfile.CreateMp3 con AudioEncodingQuality.Auto y, a continuación, llama a PrepareStreamTranscodeAsync, recibirá un error NullReferenceException . En este caso, deberá elegir una configuración de calidad de codificación distinta de Auto para permitirle crear un perfil funcional.

Para obtener instrucciones paso a paso para usar MediaEncodingProfile para establecer las propiedades de codificación para imágenes capturadas, consulte Captura básica de fotos, vídeos y audio con MediaCapture. Para obtener información sobre el uso de MediaEncodingProfile al transcodificar archivos multimedia, vea Transcodificar archivos multimedia.

Historial de versiones

Versión de Windows Versión del SDK Valor agregado
1703 15063 CreateAlac
1703 15063 CreateFlac
1703 15063 CreateHevc
1709 16299 GetAudioTracks
1709 16299 GetVideoTracks
1709 16299 SetAudioTracks
1709 16299 SetVideoTracks
1803 17134 GetTimedMetadataTracks
1803 17134 SetTimedMetadataTracks

Constructores

MediaEncodingProfile()

Crea una nueva instancia de la clase MediaEncodingProfile .

Propiedades

Audio

Obtiene o establece las propiedades de codificación de la secuencia de audio.

Container

Obtiene o establece las propiedades del contenedor multimedia.

Video

Obtiene o establece las propiedades de codificación de la secuencia de vídeo.

Métodos

CreateAlac(AudioEncodingQuality)

Crea una instancia de MediaEncodingProfile para el audio de Códec de audio sin pérdida de Apple (ALAC).

CreateAv1(VideoEncodingQuality)

Crea un perfil de codificación para vídeo de AOMedia Video 1 (AV1).

CreateAvi(VideoEncodingQuality)

Crea una instancia de MediaEncodingProfile para AVI.

CreateFlac(AudioEncodingQuality)

Crea una instancia de MediaEncodingProfile para audio de Códec de audio sin pérdida gratuita (FLAC).

CreateFromFileAsync(IStorageFile)

Crea un perfil de codificación a partir de un archivo multimedia existente.

CreateFromStreamAsync(IRandomAccessStream)

Crea un perfil de codificación a partir de una secuencia que contiene datos multimedia.

CreateHevc(VideoEncodingQuality)

Crea una instancia de vídeo mediaEncodingProfile para el vídeo de codificación de vídeo de alta eficiencia (HEVC), también conocido como vídeo H.265.

CreateM4a(AudioEncodingQuality)

Crea un perfil de codificación para audio AAC.

CreateMp3(AudioEncodingQuality)

Crea un perfil de codificación para audio MP3 (MPEG-1 nivel 3).

CreateMp4(VideoEncodingQuality)

Crea un perfil de codificación para vídeo H.264.

CreateVp9(VideoEncodingQuality)

Crea un perfil de codificación para vídeo VP9.

CreateWav(AudioEncodingQuality)

Crea una instancia de MediaEncodingProfile para WAV

CreateWma(AudioEncodingQuality)

Crea un perfil de codificación para Audio de Windows Media (WMA).

CreateWmv(VideoEncodingQuality)

Crea un perfil de codificación para Windows Media Video (WMV).

GetAudioTracks()

Recupera la lista de objetos AudioStreamDescriptor que describen las secuencias de audio incluidas en MediaEncodingProfile.

GetTimedMetadataTracks()

Recupera la lista de objetos TimedMetadataStreamDescriptor que describen los flujos de metadatos con tiempo incluidos en MediaEncodingProfile.

GetVideoTracks()

Recupera la lista de objetos VideoStreamDescriptor que describen las secuencias de vídeo incluidas en MediaEncodingProfile.

SetAudioTracks(IIterable<AudioStreamDescriptor>)

Establece la lista de objetos AudioStreamDescriptor que describen las secuencias de audio incluidas en MediaEncodingProfile.

SetTimedMetadataTracks(IIterable<TimedMetadataStreamDescriptor>)

Establece la lista de objetos TimedMetadataStreamDescriptor que describen los flujos de metadatos con tiempo incluidos en MediaEncodingProfile.

SetVideoTracks(IIterable<VideoStreamDescriptor>)

Establece la lista de objetos VideoStreamDescriptor que describen las secuencias de vídeo incluidas en MediaEncodingProfile.

Se aplica a

Consulte también