MediaCaptureInitializationSettings Classe

Definizione

Spazio dei nomi:

Windows.Media.Capture

Contiene le impostazioni di inizializzazione per l'oggetto MediaCapture che vengono passate al metodo MediaCapture.InitializeAsync .

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

Ereditarietà

Object Platform::Object IInspectable MediaCaptureInitializationSettings

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
Funzionalità dell'app	backgroundMediaRecording microphone webcam

Esempio

Nell'esempio seguente viene inizializzato MediaCaptureInitializationSettings. Chiamare InitializeAsync con queste impostazioni per inizializzare un oggetto 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;
}

Commenti

Per istruzioni su come inizializzare e arrestare l'oggetto MediaCapture , vedi Acquisizione di foto, video e audio di base con MediaCapture.

Nota

Quando si usa MediaCaptureSharingMode::SharedReadOnly , alcune delle proprietà MediaCaptureInitializationSettings non possono essere configurate. Per informazioni dettagliate, vedere SharingMode .

Cronologia delle versioni

Versione di Windows	Versione dell'SDK	Valore aggiunto
1607	14393	MemoryPreference
1607	14393	SharingMode
1607	14393	SourceGroup
1703	15063	AlwaysPlaySystemShutterSound
2004	19041	DeviceUri
2004	19041	DeviceUriPasswordCredential

Costruttori

MediaCaptureInitializationSettings()

Crea una nuova istanza dell'oggetto MediaCaptureInitializationSettings.

Proprietà

AlwaysPlaySystemShutterSound	Ottiene un valore che indica se il sistema deve sempre riprodurre un suono di otturatore quando viene acquisita una foto.
AudioDeviceId	Ottiene la DeviceInformation.Id del microfono.
AudioProcessing	Ottiene o imposta un valore che specifica la modalità di elaborazione audio.
AudioSource	Ottiene o imposta l'origine audio per l'operazione di acquisizione.
DeviceUri	Ottiene o imposta l'URI del dispositivo di acquisizione remota da inizializzare.
DeviceUriPasswordCredential	Ottiene o imposta l'oggetto PasswordCredential che rappresenta le credenziali utilizzate per accedere al dispositivo di acquisizione remota da inizializzare.
MediaCategory	Ottiene o imposta la categoria di supporti.
MemoryPreference	Ottiene o imposta un oggetto che specifica il percorso di memoria preferito per l'archiviazione dei fotogrammi acquisiti da MediaFrameSource utilizzato da MediaCapture.
PhotoCaptureSource	Ottiene o imposta il flusso utilizzato per l'acquisizione di foto.
PhotoMediaDescription	Ottiene o imposta la descrizione multimediale per l'acquisizione di foto.
PreviewMediaDescription	Ottiene o imposta la descrizione multimediale per il video di anteprima.
RecordMediaDescription	Ottiene o imposta la descrizione multimediale per la registrazione video.
SharingMode	Ottiene o imposta un oggetto che specifica la modalità di condivisione per MediaCapture.
SourceGroup	Ottiene o imposta l'oggetto MediaFrameSourceGroup con cui deve essere inizializzato MediaCapture . Questa proprietà definisce un set di origini fotogrammi multimediali che possono essere usate contemporaneamente.
StreamingCaptureMode	Ottiene o imposta la modalità di streaming.
VideoDeviceId	Ottiene la DeviceInformation.Id della videocamera.
VideoProfile	Ottiene o imposta il profilo video che fornisce suggerimenti al driver per consentire l'ottimizzazione per scenari di acquisizione diversi.
VideoSource	Ottiene o imposta l'origine video per l'operazione di acquisizione.

Vedi anche

• Esempio di profili fotocamera
• Esempio di stabilizzazione video