pagina delle impostazioni di Fotocamera

Articolo
02/29/2024

Questo articolo descrive le funzionalità e il funzionamento della pagina delle impostazioni della fotocamera in Windows 11 e il framework dei valori predefiniti che consente la configurazione della configurazione della fotocamera applicata quando un'applicazione avvia la fotocamera.

Introduzione

Prima di Windows 11, l'unico modo per i clienti di regolare i controlli immagine come Luminosità, Contrasto, Nitidezza e così via, era usare un'utilità fornita dal produttore della fotocamera (se disponibile) o se l'applicazione fotocamera aveva l'interfaccia utente per regolare il controllo immagine desiderato.

La persistenza dei valori regolati ha in genere seguito un modello last-in, rendendo dipendente dal comportamento delle applicazioni che usano la fotocamera. Ad esempio, se un cliente ha regolato il livello di luminosità della fotocamera usando l'utilità del produttore, tale valore viene bloccato solo fino a quando un'altra applicazione non scrive nel controllo luminosità. Ciò significa che il comportamento di un'applicazione ha avuto il potenziale di influire sull'esperienza della fotocamera con un'altra applicazione.

In Windows 11 è stato introdotto un nuovo framework valore predefinito che consente ai clienti di configurare il comportamento della fotocamera ogni volta che viene avviato da un'applicazione. È stata introdotta anche una nuova pagina delle impostazioni della fotocamera estendibile per gestire le fotocamere, inclusi i valori predefiniti.

Terminologia e prerequisiti

Termine	Definizione
App complementare	Applicazione personalizzata sviluppata dal produttore della fotocamera che consente la configurazione e la gestione di una fotocamera oltre alla pagina delle impostazioni della fotocamera.
Valore corrente	Valore di un controllo fotocamera attualmente attivo nell'ISP della fotocamera e mantenuto nella memoria temporanea della fotocamera.
Valore predefinito	Valore iniziale di un controllo fotocamera archiviato su disco e salvato per una fotocamera specifica, per un account utente specifico, in un PC specifico.
ISP	Image Signal Processor, il microprocessore all'interno della fotocamera responsabile del controllo e della lettura dal sensore, l'elaborazione dei dati dell'immagine e il trasferimento dei dati dell'immagine al PC host.
NPU	Unità di elaborazione neurale, hardware dedicato progettato per elaborare carichi di lavoro di intelligenza artificiale con velocità effettiva elevata ed efficienza.
Sensore	Il microprocessore all'interno di una fotocamera responsabile dell'acquisizione delle immagini e della loro conversione in segnali digitali.
Effetti di Windows Studio	Raccolta di effetti video disponibili su PC Windows con NPU.
UVC	Usb Video Class, l'interfaccia standardizzata per il controllo e lo streaming da fotocamere connesse USB.

Visualizzazione e gestione delle fotocamere

La pagina delle impostazioni della fotocamera può essere avviata passando a Impostazioni > Bluetooth e dispositivi > Fotocamera. Questa pagina è stata introdotta in Windows 11 e non è disponibile nelle versioni precedenti di Windows.

Telecamere di rete

La pagina delle impostazioni della fotocamera consente ai clienti di avviare una ricerca della rete locale per le telecamere di rete/IP conformi a ONVIF e connetterle al sistema. Una volta connesso, la fotocamera di rete viene visualizzata e funziona come una fotocamera tradizionale (ad esempio, USB).

Le telecamere di rete connesse a un sistema possono essere rimosse selezionando la fotocamera dall'elenco delle fotocamere Connessione nella pagina delle impostazioni della fotocamera e quindi selezionando il pulsante Rimuovi.

Per altre informazioni, vedere Telecamere di rete.

telecamere Connessione

La pagina delle impostazioni della fotocamera visualizza le fotocamere attualmente connesse al sistema e consente ai clienti di accedere a una pagina secondaria con impostazioni aggiuntive correlate a ogni fotocamera. Queste impostazioni includono le impostazioni predefinite dell'immagine, la possibilità di disabilitare la fotocamera e, nel caso delle fotocamere di rete, la possibilità di rimuovere/disconnettere la fotocamera.

Le fotocamere a colori abilitate sono visualizzate nell'elenco e le fotocamere speciali (ad esempio le fotocamere IR) non vengono visualizzate.

Fotocamere disabilitate

Quando una fotocamera è disabilitata tramite la pagina delle impostazioni della fotocamera, viene visualizzata una sezione separata con un elenco di fotocamere disabilitate. Facendo clic su Abilita si riabilita la fotocamera selezionata.

Nota

Alcune fotocamere potrebbero non essere visualizzate nella pagina delle impostazioni della fotocamera se mancano un driver, in uno stato non funzionale o disabilitate tramite utilità alternative, ad esempio Gestione dispositivi.

Configurazione di singole fotocamere

Selezionando una singola fotocamera dall'elenco delle fotocamere Connessione nella pagina delle impostazioni della fotocamera, viene avviata una sottopagina che visualizza un'anteprima della fotocamera, consente la gestione della fotocamera e consente la configurazione delle impostazioni predefinite per l'immagine.

Le impostazioni predefinite visualizzate in questa pagina vengono salvate per fotocamera e per account utente. Inoltre, le impostazioni predefinite per l'immagine non vengono sottoposte a backup e ripristinate durante la reinstallazione del sistema operativo o durante la configurazione di un nuovo dispositivo Windows.

Disabilitazione di una fotocamera

Per disabilitare una fotocamera, selezionarla dall'elenco delle fotocamere Connessione nella pagina delle impostazioni della fotocamera per aprire la relativa pagina secondaria e quindi selezionare il pulsante Disabilita. Selezionando questo pulsante viene attivato un prompt per confermare prima di disabilitare la fotocamera.

In alcuni sistemi, più fotocamere condividono un ISP comune, quindi la disabilitazione di una fotocamera può disabilitare più fotocamere. Questo è comune nei dispositivi a fattore di forma tablet che hanno sia una fotocamera anteriore integrata (videoconferenza) che una fotocamera globale. In questo scenario, la richiesta di conferma include un messaggio che indica che la disabilitazione di una fotocamera causa la disabilitazione di altre fotocamere nel sistema come gruppo.

In alcune circostanze, le fotocamere richiedono che il riavvio del sistema sia disabilitato. In questo scenario, la fotocamera continua a essere visualizzata nell'elenco delle fotocamere Connessione della pagina delle impostazioni della fotocamera, ma rimarrà disattivata con un messaggio che indica la necessità di riavviare il PC.

Risoluzione dei problemi relativi a una fotocamera

Per risolvere i problemi relativi a una fotocamera, selezionarla dall'elenco delle fotocamere Connessione nella pagina delle impostazioni della fotocamera per aprire la relativa sottopagina e quindi selezionare il pulsante Risoluzione dei problemi. Selezionando questo pulsante viene avviata l'utilità Ottieni guida che esegue un'esperienza interattiva per la risoluzione dei problemi della fotocamera.

Regolazione delle impostazioni dell'immagine di base

Quando una fotocamera viene selezionata dall'elenco delle fotocamere Connessione nella pagina delle impostazioni della fotocamera, una selezione di dispositivi di scorrimento e/o interruttori per le impostazioni di imaging di base potrebbe essere disponibile nella sezione Basic Impostazioni, come supportato dalla fotocamera.

La tabella seguente elenca le impostazioni di base disponibili e la corrispondente proprietà KS (o controllo UVC, per le fotocamere USB) che la fotocamera deve implementare per ogni impostazione per essere visibile. Se nessuna delle impostazioni è disponibile nella fotocamera, la sezione Impostazioni di base non sarà visibile.

Impostazione di base	Proprietà KS	Controllo UVC
Luminosità	Vedere le osservazioni che seguono questa tabella	Vedere le osservazioni che seguono questa tabella
Contrasto	KSPROPERTY_VIDEOPROCAMP_CONTRAST	PU_CONTRAST_CONTROL
Nitidezza	KSPROPERTY_VIDEOPROCAMP_SHARPNESS	PU_SHARPNESS_CONTROL
Saturazione	KSPROPERTY_VIDEOPROCAMP_SATURATION	PU_SATURATION_CONTROL
Video HDR	KSPROPERTY_CAMERACONTROL_EXTENDED_VIDEOHDR	MSXU_CONTROL_VIDEO_HDR

Il controllo Luminosità è un controllo univoco perché, a seconda dei controlli supportati dalla fotocamera, esegue il mapping a KSPROPERTY_CAMERACONTROL_EXTENDED_EVCOMPENSATION (MSXU_CONTROL_EVCOMPENSATION per i Fotocamera UVC) o al controllo legacy KSPROPERTY_VIDEOPROCAMP_BRIGHTNESS (PU_BRIGHTNESS_CONTROL per fotocamere UVC).

Il comportamento ideale di un dispositivo di scorrimento per la luminosità predefinita dell'immagine consiste nell'agire come offset/distorsione relativa all'algoritmo AE (Auto Exposure) della fotocamera. Ciò garantisce che le regolazioni siano indipendenti dalla scena e che la fotocamera possa essere sempre più luminosa o un po ' più scura per qualsiasi ambiente di illuminazione specificato.

Il controllo EV Compensation è progettato in modo esplicito per agire come distorsione per l'algoritmo AE di una fotocamera. Quando una fotocamera supporta il controllo EV Compensation, il dispositivo di scorrimento Luminosità nelle impostazioni della fotocamera esegue il mapping a questo controllo. Quando la fotocamera non supporta il controllo EV Compensation ma supporta il controllo Luminosità legacy, il dispositivo di scorrimento Luminosità esegue il mapping al controllo Legacy Brightness. Quando nessun controllo è supportato dalla fotocamera, il dispositivo di scorrimento Luminosità non è visibile nella pagina delle impostazioni della fotocamera.

Analogamente, le app che offrono dispositivi di scorrimento della luminosità in-app sono invitati a usare la stessa logica per eseguire il mapping del controllo luminosità in-app al controllo EV Compensation o legacy Brightness. Questa logica viene implementata nell'app Fotocamera Windows.

Regolazione degli effetti di Windows Studio (o effetti Fotocamera)

Quando una fotocamera viene selezionata dall'elenco delle fotocamere Connessione nella pagina delle impostazioni della fotocamera, una selezione di interruttori e/o pulsanti di opzione per le impostazioni degli effetti della fotocamera può essere disponibile nella sezione effetti Fotocamera, come supportato dalla fotocamera.

I dispositivi Windows che supportano Gli effetti di Windows Studio denominano invece la sezione Effetti di Windows Studio.

Di seguito è riportato l'elenco degli effetti di Fotocamera disponibili e la proprietà KS corrispondente che la fotocamera deve implementare per ogni impostazione per essere visibile. Se nessuna delle impostazioni è disponibile nella fotocamera, la sezione Fotocamera Effects (o Windows Studio Effects) non sarà visibile.

effetto Fotocamera	Proprietà KS
Sfocatura standard	KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUND edizione Standard GMENTATION (con flag di KSCAMERA_EXTENDEDPROP_BACKGROUND edizione Standard GMENTATION_BLUR)
Sfocatura verticale	KSPROPERTY_CAMERACONTROL_EXTENDED_BACKGROUND edizione Standard GMENTATION (con flag di KSCAMERA_EXTENDEDPROP_BACKGROUND edizione Standard GMENTATION_SHALLOWFOCUS)
Contatto oculare standard	KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION (con flag di KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON)
Contatto oculare migliorato	KSPROPERTY_CAMERACONTROL_EXTENDED_EYEGAZECORRECTION (con flag di KSCAMERA_EXTENDEDPROP_EYEGAZECORRECTION_ON)
Inquadratura automatica	KSPROPERTY_CAMERACONTROL_EXTENDED_DIGITALWINDOW (con flag di KSCAMERA_EXTENDEDPROP_DIGITALWINDOW_AUTOFACEFRAMING)

Quando una fotocamera supporta solo sfocatura Standard, il controllo viene visualizzato come interruttore attivato/disattivato con l'etichetta Sfocatura sfondo.

Quando una fotocamera supporta sfocatura standard e sfocatura verticale, il controllo viene visualizzato come interruttore attivato/disattivato con gli effetti di sfondo dell'etichetta, oltre a un pulsante di opzione per selezionare sfocatura Standard e Sfocatura verticale disponibile quando gli effetti di sfondo sono attivati.

Quando una fotocamera supporta solo il contatto oculare standard, il controllo viene visualizzato come interruttore attivato/disattivato con il contatto eye dell'etichetta.

Quando una fotocamera supporta sia Standard Eye Contact che Enhanced Eye Contact, il controllo viene visualizzato come interruttore attivato/disattivato con l'etichetta Contatto oculare, più un pulsante di opzione per selezionare Standard e Avanzato disponibile quando il contatto oculare è attivato.

Regolazione della rotazione video

Quando viene selezionata una fotocamera esterna dall'elenco delle fotocamere Connessione nella pagina delle impostazioni della fotocamera, è disponibile un elenco a discesa che consente al cliente di selezionare una rotazione video. Le opzioni disponibili sono Nessuna rotazione, Destra 90°, Sinistra 90° o 180°.

L'impostazione Rotazione video è disponibile solo per fotocamere esterne. Se la fotocamera è in uso da un'altra applicazione quando l'impostazione viene modificata, non verrà applicata fino alla successiva utilizzo della fotocamera.

Nota

Quando la rotazione video è impostata su qualsiasi valore diverso da "Nessuna rotazione ", Windows rimuove tutti i tipi di dati compressi (ad esempio, MJPEG, H.264 e così via) dalla fotocamera e restituisce rigorosamente i tipi di dati non compressi. Le applicazioni legacy e/o le fotocamere che dipendono dai tipi di dati compressi disponibili potrebbero non funzionare correttamente quando è configurata l'impostazione Rotazione video.

Reimpostazione delle impostazioni della fotocamera

Quando una fotocamera viene selezionata dall'elenco delle fotocamere Connessione nella pagina delle impostazioni della fotocamera, il pulsante Reimposta impostazioni consente di ripristinare le impostazioni predefinite della fotocamera.

Quando si usa questo pulsante, le modifiche apportate al Impostazioni Basic, agli effetti di Windows Studio (o agli effetti Fotocamera) o ai controlli rotazione video vengono cancellati e la fotocamera viene riavviata con la configurazione di fabbrica.

L'uso del pulsante Reimposta impostazioni reimposta anche le impostazioni predefinite configurate da un'app complementare.

Comportamento del valore predefinito

Le modifiche apportate al Impostazioni Basic, agli effetti di Windows Studio (o agli effetti Fotocamera) o ai controlli rotazione video vengono applicati immediatamente al flusso della fotocamera live (e visibili nell'anteprima) e vengono salvati anche come valore predefinito per la successiva apertura della fotocamera da parte di un'applicazione.

Quando nessuna applicazione usa la fotocamera, il comportamento della pagina delle impostazioni della fotocamera è semplice. Le modifiche apportate dai clienti al Impostazioni Basic, agli effetti di Windows Studio (o agli effetti Fotocamera) o ai controlli rotazione video vengono applicati immediatamente al flusso di anteprima della fotocamera live e salvati come valori predefiniti aggiornati che verranno applicati quando le applicazioni avviano la fotocamera in futuro.

Come si applicano i valori predefiniti alle applicazioni fotocamera

Quando un'applicazione si apre e avvia la fotocamera, Windows avvia la fotocamera e quindi applica tutti i valori predefiniti alla fotocamera configurata tramite la pagina delle impostazioni della fotocamera, a meno che l'applicazione non abbia scritto un determinato controllo dopo l'apertura della fotocamera, ma prima di avviare il flusso.

Si consideri, ad esempio, uno scenario in cui il cliente imposta il contrasto predefinito sul 55% usando la pagina delle impostazioni della fotocamera e quindi avvia la fotocamera in un'applicazione (ad esempio Microsoft Teams):

Se l'applicazione apre un handle per la fotocamera e quindi richiede l'avvio del flusso: Windows imposta il valore corrente della fotocamera per il controllo Contrasto (KSPROPERTY_VIDEOPROCAMP_CONTRAST) su 55%. Il controllo della fotocamera viene quindi consegnato all'applicazione.
Se l'applicazione apre un handle alla fotocamera, scrive il valore corrente del controllo Contrasto su 45%, quindi richiede l'avvio del flusso: Windows ignora la scrittura del valore corrente per il controllo Contrasto perché l'app lo ha già preiniziato.

Una volta eseguita l'esecuzione della fotocamera, l'applicazione può eseguire le operazioni seguenti con il valore corrente del controllo Contrast:

Non eseguire alcuna operazione, nel qual caso il contrasto rimane al valore impostato durante l'inizializzazione per la durata della sessione.
Scriverlo in un valore diverso, nel qual caso il contrasto cambia in qualsiasi elemento impostato dall'applicazione su, per la durata della sessione o fino a quando la stessa applicazione lo scrive nuovamente, a seconda di quale sia il primo.

Quando le applicazioni della fotocamera (ad esempio Microsoft Teams) scrivono nei controlli fotocamera (contrasto, luminosità e così via), lo fanno scrivendo le proprietà KS della fotocamera. Questo modifica il valore corrente del controllo sulla fotocamera e non modifica il valore predefinito come la pagina delle impostazioni della fotocamera.

Uso della pagina delle impostazioni della fotocamera mentre la fotocamera è in uso

Il comportamento può essere più complesso quando viene usata la pagina delle impostazioni della fotocamera mentre un'altra applicazione usa la fotocamera. La pagina delle impostazioni della fotocamera visualizza sempre i valori predefiniti, ma il flusso di anteprima (e il flusso video mostrato nell'applicazione) rappresenta i valori correnti impostati sulla fotocamera.

Si consideri uno scenario di base in cui un'applicazione apre la fotocamera e l'applicazione non ha interfaccia utente per regolare il valore corrente del controllo Contrasto. Se il cliente apre la pagina delle impostazioni della fotocamera per regolare il contrasto mentre l'applicazione è in esecuzione, non ci sono problemi perché l'app non ha modificato il valore corrente del controllo Contrasto lontano dal valore predefinito.

Si consideri ora uno scenario più complesso, in cui il valore predefinito del controllo Contrasto è 55%, ma l'applicazione che usa la fotocamera ha impostato il valore corrente del controllo Contrasto su 45%. In questo caso, il flusso della fotocamera è in esecuzione con il contrasto impostato su 45%. Se il cliente apre la pagina delle impostazioni della fotocamera mentre l'applicazione è in esecuzione, verrà visualizzata un'anteprima che riflette un contrasto del 45%, ma il dispositivo di scorrimento contrasto seguente mostrerà il valore predefinito del 55%, che è una mancata corrispondenza.

A questo punto, il cliente potrebbe modificare il contrasto usando l'applicazione. Il valore corrente del contrasto cambia, influisce sul flusso video sia nell'app che nell'anteprima della pagina delle impostazioni della fotocamera, tuttavia il dispositivo di scorrimento Contrasto nella pagina delle impostazioni della fotocamera continuerà a essere visualizzato al 55%.

In alternativa, il cliente potrebbe modificare il contrasto usando la pagina delle impostazioni della fotocamera. Si supponga, ad esempio, che il dispositivo di scorrimento sia stato modificato al 40%. La pagina delle impostazioni della fotocamera salva il 40% come nuovo valore predefinito e imposta il valore corrente della fotocamera su 40%. Ciò fa sì che il flusso video nella pagina delle impostazioni della fotocamera e nell'applicazione cambi e rifletta un contrasto del 40%.

Nota

Alcune applicazioni possono usare l'API IMF Fotocamera ControlMonitor per monitorare le modifiche esterne ai controlli. Si consideri un'applicazione che desidera mantenere il contrasto al 45% durante l'uso della fotocamera, che l'applicazione può monitorare la proprietà KS contrasto e riscriva immediatamente la proprietà KS al 45% se viene modificata esternamente usando la pagina delle impostazioni della fotocamera.

I problemi di sincronizzazione non sono comuni e si verificano solo nello scenario specifico in cui un cliente apporta modifiche in tempo reale alle impostazioni dell'immagine all'interno di un'applicazione e avvia simultaneamente la pagina delle impostazioni della fotocamera per regolare la stessa impostazione dell'immagine.

Per gestire situazioni di utilizzo simultanee, nella pagina delle impostazioni della fotocamera viene visualizzato un banner informativo quando la fotocamera è in uso da un'altra applicazione, a indicare le modifiche apportate nella pagina delle impostazioni della fotocamera o nell'applicazione influisce sia sull'applicazione che sull'anteprima nella pagina delle impostazioni della fotocamera.

app complementari Fotocamera

Fotocamera produttori possono voler fornire applicazioni personalizzate che consentono ai clienti di modificare le impostazioni predefinite della fotocamera.

Windows 11 offre un framework app complementare Fotocamera che consente ai produttori di sviluppare applicazioni con le funzionalità seguenti:

Possibilità di visualizzare e/o modificare le stesse impostazioni valore predefinite supportate dalla pagina delle impostazioni della fotocamera (ad esempio Luminosità, Contrasto, Effetti di sfondo e così via).
Possibilità di registrare, aggiornare o eliminare le impostazioni valore predefinito per altri controlli fotocamera noti a Windows, ma che non vengono esposti tramite la pagina delle impostazioni della fotocamera , ad esempio il controllo Hue.
Possibilità di registrare, aggiornare o eliminare le impostazioni del valore predefinito per i controlli fotocamera proprietari del produttore (ad esempio, il controllo on/off per l'effetto di regolazione dell'illuminazione personalizzata di un produttore della fotocamera).

Quando una fotocamera associa un'app complementare specifica, viene aggiunta una voce per tale app alla pagina delle impostazioni della fotocamera. Se l'app è installata, può essere avviata dalla pagina delle impostazioni della fotocamera, altrimenti viene visualizzato un collegamento a Microsoft Store per scaricarlo.

Per altre informazioni sulla creazione di un'app complementare, vedere Fotocamera app complementari.

Avvio a livello di codice della pagina delle impostazioni della fotocamera

La pagina delle impostazioni della fotocamera può essere avviata da un'applicazione usando un URI di collegamento diretto, utile per le applicazioni che desiderano consentire l'accesso rapido ai controlli comuni della fotocamera. Per altre informazioni, vedi Avviare la pagina delle impostazioni della fotocamera.