MediaEncodingProfile Classe

Definizione

Spazio dei nomi:

Windows.Media.MediaProperties

Descrive il profilo di codifica per un file audio o video. Il profilo di codifica include descrizioni dei formati di codifica audio e video e una descrizione del contenitore multimediale.

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

Ereditarietà

Object Platform::Object IInspectable MediaEncodingProfile

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

La qualità di codifica Auto è un set di impostazioni speciali che riempie le impostazioni appropriate in base alle impostazioni correnti della fotocamera. Le impostazioni modificate manualmente vengono ignorate. Ad esempio, se si crea un profilo preimpostato usando uno dei metodi di creazione statici, ad esempio CreateM4a e si specifica Auto come qualità di codifica, tutte le modifiche apportate alle proprietà verranno sovrascritte con i valori in base alle impostazioni correnti della fotocamera.

Nota

È possibile creare un file MediaEncodingProfile non supportato in un determinato dispositivo. Ad esempio, è possibile chiamare CreateMp3, ma se un codificatore mp3 non è presente nel dispositivo, il tentativo di codificare l'audio con le proprietà restituite da questo metodo avrà esito negativo. Per un elenco dei codec presenti per impostazione predefinita per ogni famiglia di dispositivi, vedere Codec supportati.

Nota

Solo i tipi di profilo di codifica video supportano l'impostazione di qualità di codifica auto. I profili audio non supportano questa impostazione e genereranno un errore quando viene usata l'impostazione. Ad esempio: se si crea un profilo usando MediaEncodingProfile.CreateMp3 con AudioEncodingQuality.Auto e quindi chiamare PrepareStreamTranscodeAsync, verrà visualizzato un errore NullReferenceException . In questo caso è necessario scegliere un'impostazione di qualità di codifica diversa da Auto per consentire di creare un profilo funzionale.

Per indicazioni sull'uso di MediaEncodingProfile per impostare le proprietà di codifica per le immagini acquisite, vedere Foto di base, video e acquisizione audio con MediaCapture. Per informazioni sull'uso di MediaEncodingProfile durante la transcodatura dei file multimediali, vedere File multimediali transcode.

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
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

Costruttori

MediaEncodingProfile()

Crea una nuova istanza della classe MediaEncodingProfile .

Proprietà

Audio	Ottiene o imposta le proprietà di codifica per il flusso audio.
Container	Ottiene o imposta le proprietà del contenitore multimediale.
Video	Ottiene o imposta le proprietà di codifica per il flusso video.

Metodi

CreateAlac(AudioEncodingQuality)	Crea un'istanza di MediaEncodingProfile per l'audio ALAC (Apple Lossless Audio Codec).
CreateAv1(VideoEncodingQuality)	Crea un profilo di codifica per il video AOMedia Video 1 (AV1).
CreateAvi(VideoEncodingQuality)	Crea un'istanza di MediaEncodingProfile per AVI.
CreateFlac(AudioEncodingQuality)	Crea un'istanza di MediaEncodingProfile per l'audio audio senza perdita di dati (FLAC).
CreateFromFileAsync(IStorageFile)	Crea un profilo di codifica da un file multimediale esistente.
CreateFromStreamAsync(IRandomAccessStream)	Crea un profilo di codifica da un flusso che contiene dati multimediali.
CreateHevc(VideoEncodingQuality)	Crea un'istanza del video MediaEncodingProfile per il video HEVC (High Efficiency Video Coding), noto anche come video H.265.
CreateM4a(AudioEncodingQuality)	Crea un profilo di codifica per l'audio AAC.
CreateMp3(AudioEncodingQuality)	Crea un profilo di codifica per l'audio MP3 (MPEG-1 layer 3).
CreateMp4(VideoEncodingQuality)	Crea un profilo di codifica per il video H.264.
CreateVp9(VideoEncodingQuality)	Crea un profilo di codifica per il video VP9.
CreateWav(AudioEncodingQuality)	Crea un'istanza di MediaEncodingProfile per WAV
CreateWma(AudioEncodingQuality)	Crea un profilo di codifica per Windows Media Audio (WMA).
CreateWmv(VideoEncodingQuality)	Crea un profilo di codifica per Windows Media Video (WMV).
GetAudioTracks()	Recupera l'elenco di oggetti AudioStreamDescriptor che descrivono i flussi audio inclusi nel File MediaEncodingProfile.
GetTimedMetadataTracks()	Recupera l'elenco di oggetti TimedMetadataStreamDescriptor che descrivono i flussi di metadati temporali inclusi nel MediaEncodingProfile.
GetVideoTracks()	Recupera l'elenco di oggetti VideoStreamDescriptor che descrivono i flussi video inclusi nel File MediaEncodingProfile.
SetAudioTracks(IIterable<AudioStreamDescriptor>)	Imposta l'elenco di oggetti AudioStreamDescriptor che descrivono i flussi audio inclusi nel File MediaEncodingProfile.
SetTimedMetadataTracks(IIterable<TimedMetadataStreamDescriptor>)	Imposta l'elenco di oggetti TimedMetadataStreamDescriptor che descrivono i flussi di metadati temporali inclusi nel File MediaEncodingProfile.
SetVideoTracks(IIterable<VideoStreamDescriptor>)	Imposta l'elenco di oggetti VideoStreamDescriptor che descrivono i flussi video inclusi nel File MediaEncodingProfile.

Vedi anche

• Esempio di transcoding multimediale (Windows 10)
• Acquisizione di foto, video e audio di base con MediaCapture
• Eseguire la transcodifica di file multimediali