MediaEncodingProfile クラス

定義

名前空間:

Windows.Media.MediaProperties

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

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

継承

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 オブジェクトの一覧を設定します。

こちらもご覧ください

• コード変換メディア サンプル (Windows 10)
• MediaCapture を使った基本的な写真、ビデオ、およびオーディオのキャプチャ
• メディア ファイルのコード変換