MediaEncodingProfile クラス

リファレンス

定義

名前空間:: Windows.Media.MediaProperties

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

オーディオまたはビデオファイルのエンコードプロファイルについて説明します。エンコードプロファイルには、オーディオとビデオのエンコード形式の説明と、メディアコンテナーの説明が含まれています。

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

継承: Object Platform::Object IInspectable MediaEncodingProfile

属性: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows の要件

デバイスファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

エンコード品質自動は、現在のカメラ設定に基づいて適切な設定を入力する特別なプリセットです。手動で変更された設定は無視されます。たとえば、 CreateM4a などの静的作成メソッドを使用してプリセットプロファイルを作成し、エンコード品質として Auto を 指定すると、プロパティに加えた変更は、現在のカメラ設定に基づいて値で上書きされます。

注意

特定のデバイスでサポートされていない MediaEncodingProfile を作成できます。たとえば、 CreateMp3 を正常に呼び出しても、mp3 エンコーダーがデバイスに存在しない場合、このメソッドから返されたプロパティを使用してオーディオをエンコードしようとすると失敗します。各デバイスファミリに既定で存在するコーデックの一覧については、「サポートされているコーデック」を参照してください。

注意

[自動] のエンコード品質設定は、ビデオエンコードプロファイルの種類でのみサポートされます。オーディオプロファイルではこの設定はサポートされていないため、設定を使用するとエラーが発生します。たとえば、 MediaEncodingProfile.CreateMp3 と AudioEncodingQuality.Auto を使用してプロファイルを作成し、 PrepareStreamTranscodeAsync を呼び出すと、 NullReferenceException エラーが発生します。この場合、機能プロファイルを作成できるようにするには、[自動] 以外のエンコード品質設定を選択する必要があります。

MediaEncodingProfile を使用してキャプチャされた画像のエンコードプロパティを設定する方法については、「MediaCapture を使用した基本的な写真、ビデオ、オーディオキャプチャ」を参照してください。メディアファイルのトランスコード時に MediaEncodingProfile を 使用する方法については、「メディアファイルのコード変換」を参照してください。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
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

コンストラクター

MediaEncodingProfile()

MediaEncodingProfile クラスの新しいインスタンスを作成します。

プロパティ

Audio	オーディオストリームのエンコードプロパティを取得または設定します。
Container	メディアコンテナーのプロパティを取得または設定します。
Video	ビデオストリームのエンコードプロパティを取得または設定します。

メソッド

CreateAlac(AudioEncodingQuality)	Apple Lossless Audio Codec (ALAC) オーディオ用の MediaEncodingProfile のインスタンスを作成します。
CreateAv1(VideoEncodingQuality)	AOMedia Video 1 (AV1) ビデオのエンコードプロファイルを作成します。
CreateAvi(VideoEncodingQuality)	AVI 用 MediaEncodingProfile のインスタンスを作成します。
CreateFlac(AudioEncodingQuality)	Free Lossless Audio Codec (FLAC) オーディオ用の MediaEncodingProfile のインスタンスを作成します。
CreateFromFileAsync(IStorageFile)	既存のメディアファイルからエンコードプロファイルを作成します。
CreateFromStreamAsync(IRandomAccessStream)	メディアデータを含むストリームからエンコードプロファイルを作成します。
CreateHevc(VideoEncodingQuality)	MediaEncodingProfile for High Efficiency Video Coding (HEVC) ビデオ (H.265 ビデオとも呼ばれます) のインスタンスを作成します。
CreateM4a(AudioEncodingQuality)	AAC オーディオのエンコードプロファイルを作成します。
CreateMp3(AudioEncodingQuality)	MP3 (MPEG-1 レイヤー 3) オーディオのエンコードプロファイルを作成します。
CreateMp4(VideoEncodingQuality)	H.264 ビデオのエンコードプロファイルを作成します。
CreateVp9(VideoEncodingQuality)	VP9 ビデオのエンコードプロファイルを作成します。
CreateWav(AudioEncodingQuality)	WAV 用 MediaEncodingProfile のインスタンスを作成します
CreateWma(AudioEncodingQuality)	Windows Media Audio (WMA) のエンコードプロファイルを作成します。
CreateWmv(VideoEncodingQuality)	Windows Media Video (WMV) のエンコードプロファイルを作成します。
GetAudioTracks()	MediaEncodingProfile に含まれるオーディオストリームを記述する AudioStreamDescriptor オブジェクトの一覧を取得します。
GetTimedMetadataTracks()	MediaEncodingProfile に含まれる時間指定メタデータストリームを記述する TimedMetadataStreamDescriptor オブジェクトの一覧を取得します。
GetVideoTracks()	MediaEncodingProfile に含まれるビデオストリームを記述する VideoStreamDescriptor オブジェクトの一覧を取得します。
SetAudioTracks(IIterable<AudioStreamDescriptor>)	MediaEncodingProfile に含まれるオーディオストリームを記述する AudioStreamDescriptor オブジェクトの一覧を設定します。
SetTimedMetadataTracks(IIterable<TimedMetadataStreamDescriptor>)	MediaEncodingProfile に含まれる時間指定メタデータストリームを記述する TimedMetadataStreamDescriptor オブジェクトの一覧を設定します。
SetVideoTracks(IIterable<VideoStreamDescriptor>)	MediaEncodingProfile に含まれるビデオストリームを記述する VideoStreamDescriptor オブジェクトの一覧を設定します。

適用対象