MediaEncodingProfile クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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 MediaEncodingProfilefunction MediaEncodingProfile()Public NotInheritable Class MediaEncodingProfile- 継承
- 属性
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 オブジェクトの一覧を設定します。 |