MediaCaptureInitializationSettings Classe

Definição

Namespace:

Windows.Media.Capture

Contém configurações de inicialização para o objeto MediaCapture que são passadas para o método 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

Herança

Object Platform::Object IInspectable MediaCaptureInitializationSettings

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)
Funcionalidades do aplicativo	backgroundMediaRecording microphone webcam

Exemplos

O método de exemplo a seguir inicializa o MediaCaptureInitializationSettings. Chame InitializeAsync com essas configurações para inicializar um objeto 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;
}

Comentários

Para obter diretrizes sobre como inicializar e desligar o objeto MediaCapture , consulte Captura básica de fotos, vídeos e áudio com MediaCapture.

Observação

Quando MediaCaptureSharingMode::SharedReadOnly é usado, algumas das propriedades MediaCaptureInitializationSettings não podem ser configuradas. Consulte SharingMode para obter detalhes.

Histórico de versão

Versão do Windows	Versão do SDK	Valor adicionado
1607	14393	MemoryPreference
1607	14393	SharingMode
1607	14393	SourceGroup
1703	15063	AlwaysPlaySystemShutterSound
2004	19041	DeviceUri
2004	19041	DeviceUriPasswordCredential

Construtores

MediaCaptureInitializationSettings()

Cria uma nova instância do objeto MediaCaptureInitializationSettings.

Propriedades

AlwaysPlaySystemShutterSound	Obtém um valor que indica se o sistema sempre deve reproduzir um som de obturador quando uma foto é capturada.
AudioDeviceId	Obtém o DeviceInformation.Id do microfone.
AudioProcessing	Obtém ou define um valor que especifica o modo de processamento de áudio.
AudioSource	Obtém ou define a fonte de áudio para a operação de captura.
DeviceUri	Obtém ou define o URI do dispositivo de captura remota a ser inicializado.
DeviceUriPasswordCredential	Obtém ou define o objeto PasswordCredential que representa as credenciais usadas para acessar o dispositivo de captura remota a ser inicializado.
MediaCategory	Obtém ou define a categoria de mídia.
MemoryPreference	Obtém ou define um objeto que especifica o local de memória preferencial para armazenar quadros adquiridos de um MediaFrameSource usado pelo MediaCapture.
PhotoCaptureSource	Obtém ou define o fluxo usado para captura de fotos.
PhotoMediaDescription	Obtém ou define a descrição da mídia para captura de fotos.
PreviewMediaDescription	Obtém ou define a descrição da mídia para o vídeo de visualização.
RecordMediaDescription	Obtém ou define a descrição da mídia para gravação de vídeo.
SharingMode	Obtém ou define um objeto que especifica o modo de compartilhamento para o MediaCapture.
SourceGroup	Obtém ou define o MediaFrameSourceGroup com o qual o MediaCapture deve ser inicializado. Essa propriedade define um conjunto de fontes de quadro de mídia que podem ser usadas simultaneamente.
StreamingCaptureMode	Obtém ou define o modo de streaming.
VideoDeviceId	Obtém o DeviceInformation.Id da câmera de vídeo.
VideoProfile	Obtém ou define o perfil de vídeo que fornece dicas para o driver para permitir que ele otimize para diferentes cenários de captura.
VideoSource	Obtém ou define a origem do vídeo para a operação de captura.

Confira também

• Exemplo de perfis de câmera
• Exemplo de estabilização de vídeo