MediaCaptureInitializationSettings クラス

定義

MediaCapture.InitializeAsync メソッドに渡される MediaCapture オブジェクトの初期化設定が含まれています。

public ref class MediaCaptureInitializationSettings 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.Both)]
class MediaCaptureInitializationSettings 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.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class MediaCaptureInitializationSettings 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.Both)]
public sealed class MediaCaptureInitializationSettings
[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.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaCaptureInitializationSettings
function MediaCaptureInitializationSettings()
Public NotInheritable Class MediaCaptureInitializationSettings
継承
Object Platform::Object IInspectable MediaCaptureInitializationSettings
属性

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)
アプリの機能
backgroundMediaRecording microphone webcam

次の例では、MediaCaptureInitializationSettings を初期化しています。 これらの設定を使用して InitializeAsync を呼び出して、 MediaCapture オブジェクトを初期化します。

private void InitCaptureSettings()
{
    _captureInitSettings = null;
    _captureInitSettings = new Windows.Media.Capture.MediaCaptureInitializationSettings();
    _captureInitSettings.AudioDeviceId = "";
    _captureInitSettings.VideoDeviceId = "";
    _captureInitSettings.StreamingCaptureMode = Windows.Media.Capture.StreamingCaptureMode.AudioAndVideo;
    _captureInitSettings.PhotoCaptureSource = Windows.Media.Capture.PhotoCaptureSource.VideoPreview;
    
    if (_deviceList.Count > 0)
        _captureInitSettings.VideoDeviceId = _deviceList[0].Id;
}

注釈

MediaCapture オブジェクトの初期化とシャットダウンに関するハウツー ガイダンスについては、「MediaCapture を使用した基本的な写真、ビデオ、オーディオ キャプチャ」を参照してください。

注意

MediaCaptureSharingMode::SharedReadOnly を使用する場合、MediaCaptureInitializationSettings プロパティの一部を構成できません。 詳細については、「 SharingMode 」を参照してください。

バージョン履歴

Windows のバージョン SDK バージョン 追加された値
1607 14393 MemoryPreference
1607 14393 SharingMode
1607 14393 SourceGroup
1703 15063 AlwaysPlaySystemShutterSound
2004 19041 DeviceUri
2004 19041 DeviceUriPasswordCredential

コンストラクター

MediaCaptureInitializationSettings()

MediaCaptureInitializationSettings オブジェクトの新しいインスタンスを作成します。

プロパティ

AlwaysPlaySystemShutterSound

写真のキャプチャ時にシステムが常にシャッター サウンドを再生する必要があるかどうかを示す値を取得します。

AudioDeviceId

マイクの DeviceInformation.Id を取得します。

AudioProcessing

オーディオ処理モードを指定する値を取得または設定します。

AudioSource

キャプチャ操作のオーディオ ソースを取得または設定します。

DeviceUri

初期化するリモート キャプチャ デバイスの URI を取得または設定します。

DeviceUriPasswordCredential

初期化するリモート キャプチャ デバイスへのアクセスに使用される資格情報を表す PasswordCredential オブジェクトを取得または設定します。

MediaCategory

メディア カテゴリを取得または設定します。

MemoryPreference

MediaCapture によって使用される MediaFrameSource から取得したフレームを格納するための優先メモリの場所を指定するオブジェクトを取得または設定します。

PhotoCaptureSource

写真のキャプチャに使用されるストリームを取得または設定します。

PhotoMediaDescription

写真キャプチャのメディアの説明を取得または設定します。

PreviewMediaDescription

プレビュー ビデオのメディアの説明を取得または設定します。

RecordMediaDescription

ビデオ録画のメディアの説明を取得または設定します。

SharingMode

MediaCapture の共有モードを指定するオブジェクトを取得または設定します。

SourceGroup

MediaCapture を初期化する MediaFrameSourceGroup を取得または設定します。 このプロパティは、同時に使用できるメディア フレーム ソースのセットを定義します。

StreamingCaptureMode

ストリーミング モードを取得または設定します。

VideoDeviceId

ビデオ カメラの DeviceInformation.Id を取得します。

VideoProfile

さまざまなキャプチャ シナリオに合わせて最適化するためのヒントをドライバーに提供するビデオ プロファイルを取得または設定します。

VideoSource

キャプチャ操作のビデオ ソースを取得または設定します。

適用対象

こちらもご覧ください