Acquisizione realtà mista per sviluppatoriMixed reality capture for developers

Nota

Per informazioni su una nuova funzionalità MRC per HoloLens 2, vedere Render dalla fotocamera PV di seguito.See Render from the PV camera below for guidance on a new MRC capability for HoloLens 2.

Poiché un utente può eseguire una foto o un video di acquisizione di realtà mista in qualsiasi momento, è necessario tenere presente alcuni aspetti durante lo sviluppo dell'applicazione.Since a user could take a mixed reality capture (MRC) photo or video at any time, there are a few things that you should keep in mind when developing your application. Sono incluse le procedure consigliate per la qualità visiva di MRC e la reattività delle modifiche di sistema durante l'acquisizione di MRCs.This includes best practices for MRC visual quality and being responsive to system changes while MRCs are being captured.

Gli sviluppatori possono anche integrare facilmente l'acquisizione e l'inserimento di realtà miste nelle proprie app.Developers can also seamlessly integrate mixed reality capture and insertion into their apps.

MRC in HoloLens (prima generazione) supporta video e foto fino a 720p, mentre MRC in HoloLens 2 supporta video fino a 1080p e foto con risoluzione 4K.MRC on HoloLens (first-generation) supports videos and photos up to 720p, while MRC on HoloLens 2 supports videos up to 1080p and photos up to 4K resolution.

Importanza della qualità MRCThe importance of quality MRC

Le foto e i video acquisiti in realtà mista rappresentano probabilmente la prima esposizione che un utente avrà dell'app.Mixed reality captured photos and videos are likely the first exposure a user will have of your app. Sia che si tratti di screenshot della realtà mista nella pagina Microsoft Store o di altri utenti che condividono MRCs nei social network.Whether as mixed reality screenshots on your Microsoft Store page or from other users sharing MRCs on social networks. È possibile usare MRC per dimostrarne l'app, istruire gli utenti, incoraggiare gli utenti a condividere le interazioni tra il mondo misto e la ricerca degli utenti e la risoluzione dei problemi.You can use MRC to demo your app, educate users, encourage users to share their mixed world interactions, and for user research and problem solving.

Effetti di MRC sull'appHow MRC impacts your app

Abilitazione di MRC nell'appEnabling MRC in your app

Per impostazione predefinita, un'app non deve eseguire alcuna operazione per consentire agli utenti di eseguire acquisizioni di realtà miste.By default, an app does not have to do anything to enable users to take mixed reality captures.

Abilitazione dell'allineamento migliorato per MRC nell'appEnabling improved alignment for MRC in your app

Per impostazione predefinita, l'acquisizione di realtà mista combina l'output olografico dell'occhio destro con la fotocamera Photo/video (PV).By default, mixed reality capture combines the right eye's holographic output with the photo/video (PV) camera. Queste due origini vengono combinate usando il punto di interesse impostato dall'app immersiva attualmente in esecuzione.These two sources are combined using the focus point set by the currently running immersive app.

Ciò significa che gli ologrammi al di fuori del piano di attivazione non verranno allineati (a causa della distanza fisica tra la fotocamera FV e la visualizzazione destra).This means that holograms outside the focus plane won't align as well (due to the physical distance between the PV camera and the right display).

Imposta il punto di attivazioneSet the focus point

Le app immersive (in HoloLens) devono impostare il punto di messa a fuoco per la posizione desiderata per il piano di stabilizzazione.Immersive apps (on HoloLens) should set the focus point of where they want their stabilization plane to be. In questo modo si garantisce il migliore allineamento nell'auricolare e nell'acquisizione di realtà mista.This ensures the best alignment in both the headset and in mixed reality capture.

Se non è impostato un punto di attivazione, per impostazione predefinita il piano di stabilizzazione sarà di due metri.If a focus point is not set, the stabilization plane will default to two meters.

Rendering dalla fotocamera PV (consenso esplicito)Render from the PV camera (opt-in)

HoloLens 2 aggiunge la possibilità di eseguire il rendering di un'app immersiva dalla fotocamera PV mentre è in esecuzione l'acquisizione di realtà mista.HoloLens 2 adds the ability for an immersive app to render from the PV camera while mixed reality capture is running. Per assicurarsi che l'app supporti correttamente il rendering aggiuntivo, l'app deve acconsentire esplicitamente a questa funzionalità.To ensure the app supports the additional render correctly, the app has to opt-in to this functionality.

Il rendering dalla fotocamera PV offre i miglioramenti seguenti rispetto all'esperienza MRC predefinita:Render from the PV camera offers the following improvements over the default MRC experience:

  • L'allineamento degli ologrammi per l'ambiente fisico e le mani (per le interazioni near) dovrebbe essere accurato a tutte le distanze, anziché avere un offset a distanza diverso dal punto di interesse, come si può vedere nella MRC predefinita.Hologram alignment to both your physical environment and hands (for near interactions) should be accurate at all distances, instead of having an offset at distances other than the focus point as you might see in the default MRC.
  • L'occhio destro nell'auricolare non verrà compromesso, perché non verrà usato per il rendering degli ologrammi per l'output di MRC.The right eye in the headset won't be compromised, as it won't be used to render the holograms for the MRC output.

Per abilitare il rendering dalla fotocamera PV sono disponibili tre passaggi:There are three steps to enable rendering from the PV camera:

  1. Abilitare il HolographicViewConfiguration PhotoVideoCameraEnable the PhotoVideoCamera HolographicViewConfiguration
  2. Gestire il rendering HolographicCamera aggiuntivoHandle the additional HolographicCamera render
  3. Verificare che gli shader e il rendering del codice siano corretti da questa HolographicCamera aggiuntivaVerify your shaders and code render correctly from this additional HolographicCamera
Abilitare il HolographicViewConfiguration di PhotoVideoCamera in DirectXEnable the PhotoVideoCamera HolographicViewConfiguration in DirectX

Per acconsentire esplicitamente al rendering dalla fotocamera PV, un'app Abilita semplicemente il HolographicViewConfigurationdi PhotoVideoCamera:To opt-in to rendering from the PV Camera, an app simply enables the PhotoVideoCamera's HolographicViewConfiguration:

var display = Windows.Graphics.Holographic.HolographicDisplay.GetDefault();
var view = display.TryGetViewConfiguration(Windows.Graphics.Holographic.HolographicViewConfigurationKind.PhotoVideoCamera);
if (view != null)
{
    view.IsEnabled = true;
}
Gestire il rendering HolographicCamera aggiuntivo in DirectXHandle the additional HolographicCamera render in DirectX

Quando l'app ha acconsentito esplicitamente al rendering dalla fotocamera PV e viene avviata l'acquisizione di realtà mista:When the app has opt-in to render from the PV camera and mixed reality capture starts:

  1. L'evento CameraAdded di HolographicSpace viene attivato.HolographicSpace's CameraAdded event will fire. Questo evento può essere rinviato se l'app non è in grado di gestire la fotocamera in questo momento.This event can be deferred if the app cannot handle the camera at this time.
  2. Una volta completato l'evento (e non ci sono rinvii in attesa), il HolographicCamera verrà visualizzato nell'elenco AddedCameras di HolographicFrame successivo.Once the event has completed (and there are no outstanding deferrals) the HolographicCamera will appear in the next HolographicFrame's AddedCameras list.

Quando l'acquisizione di realtà mista viene arrestata (o se l'app Disabilita la configurazione della visualizzazione mentre è in esecuzione l'acquisizione della realtà mista): HolographicCamera verrà visualizzato nell'elenco RemovedCameras di HolographicFrame successivo e verrà attivato l'evento CameraRemoved di HolographicSpace.When mixed reality capture stops (or if the app disables the view configuration while mixed reality capture is running): the HolographicCamera will appear in the next HolographicFrame's RemovedCameras list and the HolographicSpace's CameraRemoved event will fire.

Una proprietà ViewConfiguration è stata aggiunta a HolographicCamera per facilitare l'identificazione della configurazione a cui appartiene la fotocamera.A ViewConfiguration property has been added to HolographicCamera to help identify the configuration a camera belongs to.

Abilitare il HolographicViewConfiguration di PhotoVideoCamera in UnityEnable the PhotoVideoCamera HolographicViewConfiguration in Unity

Nota

Questa operazione richiede Unity 2018.4.13 F1, Unity 2019.3.0 F1o versione successiva.This requires Unity 2018.4.13f1, Unity 2019.3.0f1, or newer.

Per acconsentire esplicitamente al rendering dalla fotocamera PV, quando si usa il Toolkit di realtà mista, abilitare il provider di impostazioni della camera di realtà mista di Windows e selezionare l'impostazione di rendering dalla fotocamera FV .To opt-in to rendering from the PV Camera, when using the Mixed Reality Toolkit, enable the Windows Mixed Reality Camera Settings provider and check the Render from PV Camera setting.

Se non si usa il Toolkit di realtà mista, è possibile usare un componente per acconsentire manualmente come descritto in precedenza per DirectX.If you're not using the Mixed Reality Toolkit, you can use a component to manually opt-in as described above for DirectX.

Gestire il rendering di HolographicCamera aggiuntivo in UnityHandle the additional HolographicCamera render in Unity

Questa operazione viene eseguita automaticamente da Unity.This is done for you automatically by Unity.

Abilita PhotoVideoCamera HolographicViewConfiguration in UnrealEnable the PhotoVideoCamera HolographicViewConfiguration in Unreal

Nota

Questa operazione richiede Unreal Engine 4.25 o versioni successive.This requires Unreal Engine 4.25 or newer.

Per acconsentire esplicitamente al rendering dalla fotocamera/videocamera:To opt-in to rendering from the PV Camera:

  1. Chiama SetEnabledMixedRealityCamera e ResizeMixedRealityCamera.Call SetEnabledMixedRealityCamera and ResizeMixedRealityCamera
    • Usa i valori Size X (Dimensione X) e Size Y (Dimensione Y) per impostare le dimensioni video.Use the Size X and Size Y values to set the video dimensions.

Terza fotocamera

Gestire il rendering di HolographicCamera aggiuntivo in UnrealHandle the additional HolographicCamera render in Unreal

Questa operazione viene eseguita automaticamente da Unreal.This is done for you automatically by Unreal.

Verificare lo shader e il codice supportano fotocamere aggiuntiveVerify shaders and code support additional cameras

Eseguire un'acquisizione di realtà mista e verificare l'allineamento insolito, il contenuto mancante o problemi di prestazioni.Run a mixed reality capture and check for unusual alignment, missing content, or performance issues. Aggiornare gli shader e il codice nel modo appropriato.Update shaders and code as appropriate.

Se sono presenti alcune scene che non possono supportare il rendering in una fotocamera aggiuntiva, è possibile disabilitare il HolographicViewConfiguration di PhotoVideoCamera durante l'esecuzione.If there are certain scenes that cannot support rendering to an additional camera, you can disable the PhotoVideoCamera's HolographicViewConfiguration during them.

Disabilitazione di MRC nell'appDisabling MRC in your app

app 2D2D app

le app 2D possono scegliere di nascondere il contenuto visivo quando l'acquisizione di realtà mista viene eseguita da:2D apps can choose to have their visual content obscured when mixed reality capture is running by:

App immersivaImmersive app

Le app immersive possono scegliere di escludere il contenuto visivo dall'acquisizione di realtà mista:Immersive apps can choose to have their visual content excluded from mixed reality capture by:

Tastiera passwordPassword Keyboard

Con l'aggiornamento di Windows 10 maggio 2019, il contenuto visivo viene automaticamente escluso dall'acquisizione di realtà mista quando è visibile una password o un PIN.With the Windows 10 May 2019 Update, visual content is automatically excluded from mixed reality capture when a password or pin keyboard is visible.

Sapere quando MRC è attivoKnowing when MRC is active

La classe AppCapture può essere usata da un'app per capire quando viene eseguita l'acquisizione di realtà mista di sistema (per audio o video).The AppCapture class can be used by an app to know when system mixed reality capture is running (for either audio or video).

Nota

L'API GetForCurrentView di AppCapture può restituire null se l'acquisizione di realtà mista non è disponibile nel dispositivo.AppCapture's GetForCurrentView API can return null if mixed reality capture isn't available on the device. È anche importante annullare la registrazione dell'evento CapturingChanged quando l'app viene sospesa. in caso contrario, MRC può entrare in uno stato bloccato.It's also important to de-register the CapturingChanged event when your app is suspended, otherwise MRC can get into a blocked state.

Procedure consigliate (specifiche di HoloLens)Best practices (HoloLens-specific)

È previsto che MRC funzioni senza lavoro aggiuntivo da parte degli sviluppatori, ma ci sono alcuni aspetti da considerare per fornire la migliore esperienza di acquisizione della realtà mista dell'app.MRC is expected to work without additional work from developers, but there are a few things to be aware of to provide the best mixed reality capture experience of your app.

MRC usa il canale alfa dell'ologramma per fondersi con le immagini della fotocameraMRC uses the hologram’s alpha channel to blend with the camera imagery

Il passaggio più importante consiste nel verificare che l'app venga cancellata in nero trasparente anziché in un nero opaco.The most important step is to make sure your app is clearing to transparent black instead of clearing to opaque black. In Unity questa operazione viene eseguita per impostazione predefinita con la MixedRealityToolkit, ma se si sviluppa in non Unity, potrebbe essere necessario modificare una riga.In Unity, this is done by default with the MixedRealityToolkit but if you are developing in non-Unity, you may need to make a one line change.

Di seguito sono riportati alcuni elementi che potrebbero essere visualizzati in MRC se l'app non viene cancellata in nero trasparente:Here are some of the artifacts you might see in MRC if your app is not clearing to transparent black:

Errori di esempio: bordi neri intorno al contenuto (da cancellare a nero trasparente)Example Failures: Black edges around the content (failing to clear to transparent black)

Failing to clear to transparent black: black edge artifacts around holograms Failing to clear to transparent black: black edge artifacts around holograms

Errori di esempio: l'intera scena di sfondo dell'ologramma appare nera.Example Failures: The entire background scene of the hologram appears black. L'impostazione di un valore alfa in background di 1 produce uno sfondo neroSetting a background alpha value of 1 results in a black background

L'impostazione di un valore alfa in background di 1 produce uno sfondo nero

Risultato previsto: gli ologrammi appaiono correttamente combinati con il mondo reale (risultato previsto se cancellando il nero trasparente)Expected Result: Holograms appear properly blended with the real-world (expected result if clearing to transparent black)

Risultato previsto per la cancellazione del nero trasparente

Soluzione:Solution:

  • Modificare il contenuto visualizzato come nero opaco per avere un valore alfa pari a 0.Change any content that is showing up as opaque black to have an alpha value of 0.
  • Assicurarsi che l'app venga cancellata in nero trasparente.Ensure that the app is clearing to transparent black.
  • Unity viene impostato su Clear per cancellare automaticamente il valore di MixedRealityToolkit, ma se si tratta di un'app non Unity è necessario modificare il colore usato con ID3D11DeiceContext:: ClearRenderTargetView ().Unity defaults to clear to clear automatically with the MixedRealityToolkit, but if it’s a non-Unity app you should modify the color used with ID3D11DeiceContext::ClearRenderTargetView(). Si desidera assicurarsi di deselezionare il nero trasparente (0, 0, 0, 0) invece del nero opaco (0, 0, 0, 1).You want to ensure you clear to transparent black (0,0,0,0) instead of opaque black (0,0,0,1).

È ora possibile ottimizzare i valori alfa delle risorse, se si preferisce, ma in genere non è necessario.You can now tune the alpha values of your assets if you’d like, but typically don’t need to. Nella maggior parte dei casi, MRCs sarà perfetto.Most of the time, MRCs will look good out of the box. MRC presuppone l'alfa premoltiplicato.MRC assumes pre-multiplied alpha. I valori alfa avranno effetto solo sull'acquisizione di MRC.The alpha values will only affect the MRC capture.

Cosa aspettarsi quando MRC è abilitato in HoloLensWhat to expect when MRC is enabled on HoloLens

Le condizioni seguenti si applicano sia a HoloLens (First-Generation) che a HoloLens 2, salvo diversa indicazione:The following apply to both HoloLens (first-generation) and HoloLens 2, unless otherwise noted:

  • Il sistema consente di limitare l'applicazione al rendering 30Hz.The system will throttle the application to 30Hz rendering. Questa operazione crea una certa capacità per l'esecuzione di MRC, in modo che l'app non debba tenere una riserva di budget costante e corrisponda anche al framerate dei record video MRC di 30fpsThis creates some headroom for MRC to run so the app doesn’t need to keep a constant budget reserve and also matches the MRC video record framerate of 30fps
  • Il contenuto dell'ologramma nell'occhio destro del dispositivo può sembrare "Spark" durante la registrazione/streaming MRC: il testo potrebbe diventare più difficile da leggere e i bordi dell'ologramma potrebbero sembrare più frastagliati (la scelta del rendering della terza fotocamera in HoloLens 2 evita questa compromissione)Hologram content in the right eye of the device may appear to “sparkle” when recording/streaming MRC: text may become more difficult to read and hologram edges may appear more jaggy (opting-in to 3rd camera render on HoloLens 2 avoids this compromise)
  • Le foto e i video di MRC rispetteranno il punto di interesse dell'applicazione se l'applicazione lo ha abilitato, in modo da garantire la corretta posizionamento degli ologrammi.MRC photos and videos will respect the application’s focus point if the application has enabled it, which will help ensure holograms are accurately positioned. Per i video, il punto di messa a fuoco è smussato, in modo che gli ologrammi possano sembrare lentamente posizionati se la profondità del punto di messa a fuoco cambia significativamente.For videos, the Focus Point is smoothed so holograms may appear to slowly drift into place if the Focus Point depth changes significantly. Gli ologrammi che si trovano in profondità diverse dal punto di interesse possono apparire in offset rispetto al mondo reale (vedere l'esempio riportato di seguito, in cui il punto di messa a fuoco è impostato su 2 metri, ma l'ologramma è posizionato a 1 contatore).Holograms that are at different depths from the focus point may appear offset from the real world (see example below where Focus Point is set at 2 meters but hologram is positioned at 1 meter).

Gli ologrammi a 2 metri verranno visualizzati perfettamente registrati nel mondo.

Integrazione della funzionalità MRC dall'interno dell'appIntegrating MRC functionality from within your app

L'app per la realtà mista può avviare l'acquisizione di foto o video MRC dall'interno dell'app e il contenuto acquisito viene reso disponibile per l'app senza essere archiviato nel "rullo della fotocamera" del dispositivo.Your mixed reality app can initiate MRC photo or video capture from within the app, and the content captured is made available to your app without being stored to the device's "Camera roll." È possibile creare un registratore MRC personalizzato o sfruttare l'interfaccia utente di acquisizione della fotocamera incorporata.You can create a custom MRC recorder or take advantage of built-in camera capture UI.

MRC con interfaccia utente integrata della fotocameraMRC with built-in camera UI

Gli sviluppatori possono usare l' API dell'interfaccia utente di acquisizione della fotocamera per ottenere una foto o un video della realtà mista acquisita dall'utente con poche righe di codice.Developers can use the Camera Capture UI API to get a user-captured mixed reality photo or video with just a few lines of code.

Questa API avvia l'interfaccia utente della fotocamera MRC predefinita, da cui l'utente può scattare una foto o un video e restituisce l'acquisizione risultante all'app.This API launches the built-in MRC camera UI, from which the user can take a photo or video, and returns the resulting capture to your app. Se si vuole creare un'interfaccia utente della fotocamera personalizzata o un accesso di livello inferiore al flusso di acquisizione, è possibile creare un registratore di acquisizione di realtà mista personalizzato.If you want to create your own camera UI, or need lower-level access to the capture stream, you can create a custom Mixed Reality Capture recorder.

Creazione di un registratore MRC personalizzatoCreating a custom MRC recorder

Mentre l'utente può sempre attivare una foto o un video usando il servizio di acquisizione di sistema MRC, un'applicazione potrebbe voler creare un'app fotocamera personalizzata, ma includere ologrammi nel flusso della fotocamera come MRC.While the user can always trigger a photo or video using the system MRC capture service, an application may want to build a custom camera app but include holograms in the camera stream just like MRC. Questo consente all'applicazione di avviare le acquisizioni per conto dell'utente, creare un'interfaccia utente di registrazione personalizzata o personalizzare le impostazioni di MRC per citare alcuni esempi.This allows the application to kick off captures on behalf of the user, build custom recording UI, or customize MRC settings to name a few examples.

HoloStudio aggiunge una fotocamera MRC personalizzata usando gli effetti di MRCHoloStudio adds a custom MRC camera using MRC effects

HoloStudio aggiunge una fotocamera MRC personalizzata usando gli effetti di MRC

Le applicazioni Unity dovrebbero vedere Locatable_camera_in_Unity per la proprietà per abilitare gli ologrammi.Unity Applications should see Locatable_camera_in_Unity for the property to enable holograms.

Altre applicazioni possono eseguire questa operazione usando le API di acquisizione di Windows Media per controllare la fotocamera e aggiungere un effetto video e audio MRC per includere ologrammi virtuali e audio dell'applicazione in stills e video.Other applications can do this by using the Windows Media Capture APIs to control the Camera and add an MRC Video and Audio effect to include virtual holograms and application audio in stills and videos.

Le applicazioni hanno due opzioni per aggiungere l'effetto:Applications have two options to add the effect:

Nota

Lo spazio dei nomi Windows. Media. MixedRealityCapture non verrà riconosciuto da Visual Studio, ma le stringhe sono ancora valide.The Windows.Media.MixedRealityCapture namespace will not be recognized by Visual Studio, but the strings are still valid.

Effetto video MRC (Windows. Media. MixedRealityCapture. MixedRealityCaptureVideoEffect)MRC Video Effect (Windows.Media.MixedRealityCapture.MixedRealityCaptureVideoEffect)

Nome proprietàProperty Name TipoType Valore predefinitoDefault Value DescrizioneDescription
StreamTypeStreamType UINT32 (MediaStreamType)UINT32 (MediaStreamType) 1 (VideoRecord)1 (VideoRecord) Descrivere il flusso di acquisizione per cui viene usato questo effetto.Describe which capture stream this effect is used for. L'audio non è disponibile.Audio is not available.
HologramCompositionEnabledHologramCompositionEnabled booleanboolean trueTRUE Flag per abilitare o disabilitare gli ologrammi nell'acquisizione video.Flag to enable or disable holograms in video capture.
RecordingIndicatorEnabledRecordingIndicatorEnabled booleanboolean trueTRUE Flag per abilitare o disabilitare l'indicatore di registrazione sullo schermo durante l'acquisizione di ologrammi.Flag to enable or disable recording indicator on screen during hologram capturing.
VideoStabilizationEnabledVideoStabilizationEnabled booleanboolean falseFALSE Flag per abilitare o disabilitare la stabilizzazione video con tecnologia HoloLens Tracker.Flag to enable or disable video stabilization powered by the HoloLens tracker.
VideoStabilizationBufferLengthVideoStabilizationBufferLength UINT32UINT32 00 Consente di impostare il numero di frame cronologici utilizzati per la stabilizzazione del video.Set how many historical frames are used for video stabilization. 0 è 0: latenza e quasi "Free" da un punto di vista dell'alimentazione e delle prestazioni.0 is 0-latency and nearly "free" from a power and performance perspective. 15 è consigliato per la massima qualità (a costo di 15 fotogrammi di latenza e memoria).15 is recommended for highest quality (at the cost of 15 frames of latency and memory).
GlobalOpacityCoefficientGlobalOpacityCoefficient floatfloat 0,9 (HoloLens) 1,0 (auricolare immersivo)0.9 (HoloLens) 1.0 (Immersive headset) Impostare il coefficiente di opacità globale di un ologramma compreso tra 0,0 (completamente trasparente) e 1,0 (completamente opaco).Set global opacity coefficient of hologram in range from 0.0 (fully transparent) to 1.0 (fully opaque).
BlankOnProtectedContentBlankOnProtectedContent booleanboolean falseFALSE Flag per abilitare o disabilitare la restituzione di un frame vuoto se è presente un'app UWP 2D che mostra il contenuto protetto.Flag to enable or disable returning an empty frame if there is a 2d UWP app showing protected content. Se questo flag è false e un'app UWP 2D Visualizza contenuto protetto, l'app UWP 2D verrà sostituita da una trama di contenuto protetta sia nell'auricolare che nell'acquisizione di realtà mista.If this flag is false and a 2d UWP app is showing protected content, the 2d UWP app will be replaced by a protected content texture in both the headset and in the mixed reality capture.
ShowHiddenMeshShowHiddenMesh booleanboolean falseFALSE Flag per abilitare o disabilitare la visualizzazione della mesh di area nascosta e del contenuto adiacente della fotocamera olografica.Flag to enable or disable showing the holographic camera's hidden area mesh and neighboring content.
OutputSizeOutputSize DimensioneSize 0, 00, 0 Imposta la dimensione di output desiderata dopo il ritaglio per la stabilizzazione del video.Set the desired output size after cropping for video stabilization. Viene scelta una dimensione di ritaglio predefinita se si specifica 0 o una dimensione di output non valida.A default crop size is chosen if 0 or an invalid output size is specified.
PreferredHologramPerspectivePreferredHologramPerspective UINT32UINT32 Rendering dall' impostazione della fotocamera nel portale del dispositivo WindowsRender from Camera setting in the Windows Device Portal Enum usato per indicare quale configurazione della visualizzazione della fotocamera olografica deve essere acquisita: 0 (display) significa che all'app non verrà richiesto di eseguire il rendering dalla fotocamera Photo/video, 1 (PhotoVideoCamera) chiederà all'app di eseguire il rendering dalla fotocamera foto/video (se supportata dall'app).Enum used to indicate which holographic camera view configuration should be captured: 0 (Display) means that the app won't be asked to render from the photo/video camera, 1 (PhotoVideoCamera) will ask the app to render from the photo/video camera (if the app supports it). Supportato solo su HoloLens 2Only supported on HoloLens 2

Nota

È possibile modificare il valore predefinito di PreferredHologramPerspective nel portale per dispositivi Windows passando alla pagina di acquisizione della realtà mista e deselezionando il rendering dalla fotocamera.You can change the default value of PreferredHologramPerspective in the Windows Device Portal by going to the Mixed Reality Capture page and unchecking Render from Camera. L'impostazione predefinita è 1 (PhotoVideoCamera), ma può essere deselezionata per impostarla su 0 (visualizzazione).The setting defaults to 1 (PhotoVideoCamera), but can be unchecked to set it to 0 (Display).

Il valore predefinito di PreferredHologramPerspective è 0 (display) prima dell'aggiornamento del 2020 giugno (Windows olografico, versione 2004 Build 19041,1106 e Windows olografico, versione 1903 Build 18362,1064).The default value of PreferredHologramPerspective was 0 (Display) prior to the June 2020 update (Windows Holographic, version 2004 build 19041.1106 and Windows Holographic, version 1903 build 18362.1064).

Effetto audio MRC (Windows. Media. MixedRealityCapture. MixedRealityCaptureAudioEffect)MRC Audio Effect (Windows.Media.MixedRealityCapture.MixedRealityCaptureAudioEffect)

Nome proprietàProperty Name TipoType Valore predefinitoDefault Value DescrizioneDescription
MixerModeMixerMode UINT32UINT32 2 (MIC e audio di sistema)2 (Mic and System audio) Enum usato per indicare le origini audio da usare: 0 (solo audio MIC), 1 (solo audio di sistema), 2 (MIC e audio di sistema)Enum used to indicate which audio sources should be used: 0 (Mic audio only), 1 (System audio only), 2 (Mic and System audio)
LoopbackGainLoopbackGain floatfloat Impostazione di miglioramento audio app nel portale per dispositivi WindowsApp Audio Gain setting in the Windows Device Portal Ottenere da applicare al volume audio del sistema.Gain to apply to system audio volume. Compreso tra 0,0 e 5,0.Ranges from 0.0 to 5.0. Supportato solo su HoloLens 2Only supported on HoloLens 2
MicrophoneGainMicrophoneGain floatfloat Impostazione del guadagno audio mic nel portale del dispositivo WindowsMic Audio Gain setting in the Windows Device Portal Ottenere da applicare al volume MIC.Gain to apply to mic volume. Compreso tra 0,0 e 5,0.Ranges from 0.0 to 5.0. Supportato solo su HoloLens 2Only supported on HoloLens 2

Nota

È possibile modificare il valore predefinito di LoopbackGain o MicrophoneGain nel portale per dispositivi Windows passando alla pagina di acquisizione della realtà mista e modificando il dispositivo di scorrimento accanto alle rispettive impostazioni.You can change the default value of LoopbackGain or MicrophoneGain in the Windows Device Portal by going to the Mixed Reality Capture page and adjusting the slider next to their respective settings. Per impostazione predefinita, entrambe le impostazioni sono 1,0, ma possono essere impostate su qualsiasi valore compreso tra 0,0 e 5,0.Both settings default to 1.0, but can be set to any value between 0.0 and 5.0.

L'uso del portale per dispositivi Windows per configurare i valori di guadagno predefiniti è stato aggiunto con l'aggiornamento di giugno 2020 (Windows olografico, versione 2004 Build 19041,1106 e Windows olografico, versione 1903 Build 18362,1064).Using Windows Device Portal to configure the default gain values was added with the June 2020 update (Windows Holographic, version 2004 build 19041.1106 and Windows Holographic, version 1903 build 18362.1064).

Limitazioni di MRC simultaneeSimultaneous MRC limitations

Esistono alcune limitazioni relative a più app che accedono a MRC nello stesso momento.There are certain limitations around multiple apps accessing MRC at the same time.

Accesso alla fotocamera foto/videoPhoto/video camera access

La fotocamera Photo/video è limitata al numero di processi che possono accedervi nello stesso momento.The photo/video camera is limited to the number of processes that can access it at the same time. Durante la registrazione di un processo video o la creazione di una foto, qualsiasi altro processo non riuscirà ad acquisire la fotocamera foto/video.While a process is recording video or taking a photo any other process will fail to acquire the photo/video camera. Questo vale sia per l'acquisizione di realtà mista sia per l'acquisizione di foto/video standard.(this applies to both Mixed Reality Capture and standard photo/video capture)

Con HoloLens 2, un'app può usare la proprietà SharingMode di MediaCaptureInitializationSettings per indicare che desiderano eseguire SharedReadOnly se non necessitano di controllo esclusivo sulla fotocamera foto/video.With HoloLens 2, an app can use MediaCaptureInitializationSettings' SharingMode property to indicate that they want to run SharedReadOnly if they don't need exclusive control over the photo/video camera. In questo modo, la risoluzione e il framerate dell'acquisizione saranno limitati a ciò che altre app hanno configurato la fotocamera per fornire.Doing so means the resolution and framerate of the capture will be limited to what other apps have configured the camera to provide.

Accesso a foto/video della fotocamera MRC incorporatoBuilt-in MRC photo/video camera access

Funzionalità MRC incorporata in Windows 10 (tramite Cortana, menu Start, collegamenti hardware, Miracast, portale per dispositivi Windows):MRC functionality built into Windows 10 (via Cortana, Start Menu, hardware shortcuts, Miracast, Windows Device Portal):

  • Per impostazione predefinita, viene eseguito con ExclusiveControlWill run with ExclusiveControl by default

Tuttavia, il supporto è stato aggiunto a ogni sottosistema per operare in modalità condivisa:However, support has been added to each subsystem to operate in a shared mode:

  • Se un'app richiede l'accesso ExclusiveControl alla fotocamera Photo/video, la funzionalità MRC predefinita si interrompe automaticamente usando la fotocamera foto/video, in modo che la richiesta dell'app venga completataIf an app requests ExclusiveControl access to the photo/video camera, built-in MRC will automatically stop using the photo/video camera so the app's request will succeed
  • Se viene avviata la funzionalità MRC incorporata mentre un'app include ExclusiveControl, la funzionalità MRC predefinita verrà eseguita in modalità SharedReadOnlyIf built-in MRC is started while an app has ExclusiveControl, built-in MRC will run in SharedReadOnly mode

Questa funzionalità in modalità condivisa presenta alcune restrizioni:This shared mode functionality has certain restrictions:

  • Foto tramite Cortana, collegamenti hardware o menu Start: richiede l'aggiornamento di Windows 10 aprile 2018 (o versione successiva)Photo via Cortana, hardware shortcuts, or Start Menu: Requires the Windows 10 April 2018 Update (or later)
  • Video tramite Cortana, collegamenti hardware o menu Start: richiede l'aggiornamento di Windows 10 aprile 2018 (o versione successiva)Video via Cortana, hardware shortcuts, or Start Menu: Requires the Windows 10 April 2018 Update (or later)
  • Streaming MRC over Miracast: richiede l'aggiornamento di Windows 10 ottobre 2018 (o versione successiva)Streaming MRC over Miracast: Requires the Windows 10 October 2018 Update (or later)
  • Streaming di MRC sul portale per dispositivi Windows o tramite l'app complementare HoloLens: richiede HoloLens 2Streaming MRC over Windows Device Portal or via the HoloLens companion app: Requires HoloLens 2

Nota

La risoluzione e il framerate dell'interfaccia utente della fotocamera MRC integrata potrebbero essere ridotti dai valori normali quando un'altra app usa la fotocamera foto/video.The resolution and framerate of the built-in MRC camera UI might be reduced from its normal values when another app is using the photo/video camera.

Accesso a MRCMRC access

Con l'aggiornamento di Windows 10 aprile 2018, non esiste più una limitazione per più app che accedono al flusso MRC. Tuttavia, l'accesso alla videocamera Photo/video presenta ancora alcune limitazioni.With the Windows 10 April 2018 Update, there is no longer a limitation around multiple apps accessing the MRC stream (however, the access to the photo/video camera still has limitations).

In precedenza all'aggiornamento di Windows 10 aprile 2018, il registratore MRC personalizzato di un'app si escludono a vicenda con il sistema MRC (acquisizione di foto, acquisizione di video o flusso dal portale per dispositivi Windows).Previous to the Windows 10 April 2018 Update, an app's custom MRC recorder was mutually exclusive with system MRC (capturing photos, capturing videos, or streaming from the Windows Device Portal).

Vedere ancheSee also