共用方式為


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

取得或設定應該初始化MediaCaptureMediaFrameSourceGroup。 這個屬性會定義一組可以同時使用的媒體畫面來源。

StreamingCaptureMode

取得或設定串流模式。

VideoDeviceId

取得視訊相機 的 DeviceInformation.Id

VideoProfile

取得或設定影片設定檔,提供提示給驅動程式,以允許它針對不同的擷取案例進行優化。

VideoSource

取得或設定擷取作業的視訊來源。

適用於

另請參閱