MediaEncodingProfile Clase

Definición

Espacio de nombres:

Windows.Media.MediaProperties

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

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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.

Consulte también

• Ejemplo de medios de transcodificación (Windows 10)
• Captura básica de fotos, audio y vídeo con MediaCapture
• Transcodificar archivos multimedia