MediaCaptureInitializationSettings Klasse

Definition

Namespace:

Windows.Media.Capture

Enthält Initialisierungseinstellungen für das MediaCapture-Objekt , die an die MediaCapture.InitializeAsync-Methode übergeben werden.

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

Vererbung

Object Platform::Object IInspectable MediaCaptureInitializationSettings

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
App-Funktionen	backgroundMediaRecording microphone webcam

Beispiele

Im folgenden Beispiel wird mediaCaptureInitializationSettings initialisiert. Rufen Sie InitializeAsync mit diesen Einstellungen auf, um ein MediaCapture-Objekt zu initialisieren.

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;
}

Hinweise

Anleitungen zum Initialisieren und Herunterfahren des MediaCapture-Objekts finden Sie unter Grundlegende Foto-, Video- und Audioaufnahme mit MediaCapture.

Hinweis

Wenn MediaCaptureSharingMode::SharedReadOnly verwendet wird, können einige der MediaCaptureInitializationSettings-Eigenschaften nicht konfiguriert werden. Weitere Informationen finden Sie unter SharingMode .

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1607	14393	MemoryPreference
1607	14393	SharingMode
1607	14393	SourceGroup
1703	15063	AlwaysPlaySystemShutterSound
2004	19041	DeviceUri
2004	19041	DeviceUriPasswordCredential

Konstruktoren

MediaCaptureInitializationSettings()

Erstellt eine neue instance des MediaCaptureInitializationSettings-Objekts.

Eigenschaften

AlwaysPlaySystemShutterSound	Ruft einen Wert ab, der angibt, ob das System immer einen Auslöserton wiedergeben soll, wenn ein Foto aufgenommen wird.
AudioDeviceId	Ruft die DeviceInformation.Id des Mikrofons ab.
AudioProcessing	Ruft einen Wert ab, der den Audioverarbeitungsmodus angibt, oder legt diesen fest.
AudioSource	Ruft die Audioquelle für den Aufnahmevorgang ab oder legt sie fest.
DeviceUri	Ruft den URI des zu initialisierenden Remoteerfassungsgeräts ab oder legt diesen fest.
DeviceUriPasswordCredential	Ruft das PasswordCredential-Objekt ab, das die Anmeldeinformationen darstellt, die für den Zugriff auf das zu initialisierende Remoteerfassungsgerät verwendet werden, oder legt dieses fest.
MediaCategory	Ruft die Medienkategorie ab oder legt sie fest.
MemoryPreference	Ruft ein Objekt ab, das den bevorzugten Speicherort zum Speichern von Frames angibt, die von einer mediaFrameSource abgerufen werden, die von MediaCapture verwendet wird, oder legt dieses fest.
PhotoCaptureSource	Ruft den Datenstrom ab, der für die Fotoaufnahme verwendet wird, oder legt diesen fest.
PhotoMediaDescription	Ruft die Medienbeschreibung für die Fotoaufnahme ab oder legt sie fest.
PreviewMediaDescription	Ruft die Medienbeschreibung für das Vorschauvideo ab oder legt sie fest.
RecordMediaDescription	Ruft die Medienbeschreibung für die Videoaufzeichnung ab oder legt sie fest.
SharingMode	Ruft ein -Objekt ab, das den Freigabemodus für mediaCapture angibt, oder legt es fest.
SourceGroup	Ruft den MediaFrameSourceGroup ab, mit dem mediaCapture initialisiert werden soll, oder legt diese fest. Diese Eigenschaft definiert eine Reihe von Medienframequellen, die gleichzeitig verwendet werden können.
StreamingCaptureMode	Ruft den Streamingmodus ab oder legt den Streamingmodus fest.
VideoDeviceId	Ruft die DeviceInformation.Id der Videokamera ab.
VideoProfile	Ruft das Videoprofil ab, das dem Treiber Hinweise zur Optimierung für verschiedene Aufnahmeszenarien bereitstellt, oder legt dieses fest.
VideoSource	Ruft die Videoquelle für den Aufnahmevorgang ab oder legt sie fest.

Weitere Informationen

• Beispiel für Kameraprofile
• Videostabilisierungsbeispiel