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	取得或設定擷取作業的視訊來源。

另請參閱

• 相機設定檔範例
• 防震視訊範例