MediaEncodingProfile Classe

Definição

Namespace:

Windows.Media.MediaProperties

Descreve o perfil de codificação de um arquivo de áudio ou vídeo. O perfil de codificação inclui descrições dos formatos de codificação de áudio e vídeo e uma descrição do contêiner de mídia.

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

Herança

Object Platform::Object IInspectable MediaEncodingProfile

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Comentários

A qualidade de codificação Automática é uma predefinição especial que preenche as configurações adequadas com base nas configurações atuais da câmera. As configurações modificadas manualmente são ignoradas. Por exemplo, se você criar um perfil predefinido usando um dos métodos de criação estáticos, como CreateM4a, e especificar Auto como a qualidade de codificação, todas as alterações feitas nas propriedades serão substituídas por valores com base nas configurações atuais da câmera.

Observação

É possível criar um MediaEncodingProfile sem suporte em um dispositivo específico. Por exemplo, você pode chamar CreateMp3 com êxito, mas se um codificador mp3 não estiver presente no dispositivo, a tentativa de codificar áudio com as propriedades retornadas desse método falhará. Para obter uma lista dos codecs presentes por padrão para cada família de dispositivos, consulte Codecs com suporte.

Observação

Somente os tipos de perfil de codificação de vídeo dão suporte à configuração de qualidade de codificação automática. Os perfis de áudio não dão suporte a essa configuração e gerarão um erro quando a configuração for usada. Por exemplo: se você criar um perfil usando MediaEncodingProfile.CreateMp3 com AudioEncodingQuality.Auto e chamar PrepareStreamTranscodeAsync, receberá um erro NullReferenceException . Nesse caso, você precisará escolher uma configuração de qualidade de codificação diferente de Auto para permitir que você crie um perfil funcional.

Para obter diretrizes sobre como usar MediaEncodingProfile para definir as propriedades de codificação para imagens capturadas, consulte Captura básica de fotos, vídeos e áudio com MediaCapture. Para obter informações sobre como usar MediaEncodingProfile ao transcodificar arquivos de mídia, consulte Transcode media files.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1703	15063	CreateAlac
1703	15063	CreateFlac
1703	15063	CreateHevc
1.709	16299	GetAudioTracks
1.709	16299	GetVideoTracks
1.709	16299	SetAudioTracks
1.709	16299	SetVideoTracks
1803	17134	GetTimedMetadataTracks
1803	17134	SetTimedMetadataTracks

Construtores

MediaEncodingProfile()

Cria uma nova instância da classe MediaEncodingProfile .

Propriedades

Audio	Obtém ou define as propriedades de codificação para o fluxo de áudio.
Container	Obtém ou define as propriedades do contêiner de mídia.
Video	Obtém ou define as propriedades de codificação para o fluxo de vídeo.

Métodos

CreateAlac(AudioEncodingQuality)	Cria uma instância do áudio MediaEncodingProfile para o ALAC (Apple Lossless Audio Codec).
CreateAv1(VideoEncodingQuality)	Cria um perfil de codificação para vídeo AOMedia Video 1 (AV1).
CreateAvi(VideoEncodingQuality)	Cria uma instância de MediaEncodingProfile para AVI.
CreateFlac(AudioEncodingQuality)	Cria uma instância de MediaEncodingProfile para áudio FLAC (Free Lossless Audio Codec).
CreateFromFileAsync(IStorageFile)	Cria um perfil de codificação de um arquivo de mídia existente.
CreateFromStreamAsync(IRandomAccessStream)	Cria um perfil de codificação de um fluxo que contém dados de mídia.
CreateHevc(VideoEncodingQuality)	Cria uma instância do vídeo MediaEncodingProfile para HEVC (Codificação de Vídeo de Alta Eficiência), também conhecido como vídeo H.265.
CreateM4a(AudioEncodingQuality)	Cria um perfil de codificação para áudio AAC.
CreateMp3(AudioEncodingQuality)	Cria um perfil de codificação para áudio MP3 (MPEG-1 camada 3).
CreateMp4(VideoEncodingQuality)	Cria um perfil de codificação para vídeo H.264.
CreateVp9(VideoEncodingQuality)	Cria um perfil de codificação para vídeo VP9.
CreateWav(AudioEncodingQuality)	Cria uma instância de MediaEncodingProfile para WAV
CreateWma(AudioEncodingQuality)	Cria um perfil de codificação para o Windows Media Audio (WMA).
CreateWmv(VideoEncodingQuality)	Cria um perfil de codificação para o Windows Media Video (WMV).
GetAudioTracks()	Recupera a lista de objetos AudioStreamDescriptor que descrevem os fluxos de áudio incluídos no MediaEncodingProfile.
GetTimedMetadataTracks()	Recupera a lista de objetos TimedMetadataStreamDescriptor que descrevem os fluxos de metadados cronometrados incluídos no MediaEncodingProfile.
GetVideoTracks()	Recupera a lista de objetos VideoStreamDescriptor que descrevem os fluxos de vídeo incluídos no MediaEncodingProfile.
SetAudioTracks(IIterable<AudioStreamDescriptor>)	Define a lista de objetos AudioStreamDescriptor que descrevem os fluxos de áudio incluídos no MediaEncodingProfile.
SetTimedMetadataTracks(IIterable<TimedMetadataStreamDescriptor>)	Define a lista de objetos TimedMetadataStreamDescriptor que descrevem os fluxos de metadados cronometrados incluídos no MediaEncodingProfile.
SetVideoTracks(IIterable<VideoStreamDescriptor>)	Define a lista de objetos VideoStreamDescriptor que descrevem os fluxos de vídeo incluídos no MediaEncodingProfile.

Confira também

• Exemplo de mídia de transcodificação (Windows 10)
• Captura básica de fotos, áudio e vídeo com MediaCapture
• Transcodificar arquivos de mídia