MediaCaptureInitializationSettings 类

定义

命名空间:

Windows.Media.Capture

包含传递给 MediaCapture.InitializeAsync 方法的 MediaCapture 对象的初始化设置。

public ref class MediaCaptureInitializationSettings 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.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class MediaCaptureInitializationSettings 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.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class MediaCaptureInitializationSettings

function MediaCaptureInitializationSettings()

Public NotInheritable Class MediaCaptureInitializationSettings

继承

Object Platform::Object IInspectable MediaCaptureInitializationSettings

属性

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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	获取或设置捕获操作的视频源。

另请参阅

• 相机配置文件示例
• 视频防抖动示例