Partilhar via


MediaEncodingProfile Classe

Definição

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.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
Herança
Object Platform::Object IInspectable MediaEncodingProfile
Atributos

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.

Aplica-se a

Confira também