Capture de Réalité Mixte pour les développeursMixed reality capture for developers

Notes

Pour obtenir des conseils sur une nouvelle fonctionnalité MRC pour HoloLens 2, voir rendu à partir de l’appareil photo PV ci-dessous.See Render from the PV camera below for guidance on a new MRC capability for HoloLens 2.

Comme un utilisateur peut prendre à tout moment une photo ou une vidéo MRC ( Mixed Reality capture ), vous devez garder à l’esprit quelques points lorsque vous développez votre application.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. Cela comprend les meilleures pratiques pour la qualité visuelle MRC et la réponse aux modifications du système pendant la capture des MRCs.This includes best practices for MRC visual quality and being responsive to system changes while MRCs are being captured.

Les développeurs peuvent également intégrer en toute transparence la capture de réalité mixte et l’insertion dans leurs applications.Developers can also seamlessly integrate mixed reality capture and insertion into their apps.

La MRC sur HoloLens (première génération) prend en charge les vidéos et les photos jusqu’à 720p, tandis que la MRC sur HoloLens 2 prend en charge les vidéos jusqu’à 1080p et les photos jusqu’à 4 Ko.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.

L’importance de la qualité du MRCThe importance of quality MRC

Les photos et vidéos capturées en réalité mixte sont probablement la première exposition d’un utilisateur de votre application.Mixed reality captured photos and videos are likely the first exposure a user will have of your app. Le fait que des captures d’écran de réalité mixte sur votre page Microsoft Store ou d’autres utilisateurs partagent des MRCs sur des réseaux sociaux.Whether as mixed reality screenshots on your Microsoft Store page or from other users sharing MRCs on social networks. Vous pouvez utiliser la fonction MRC pour faire la démonstration de votre application, éduquer les utilisateurs, encourager les utilisateurs à partager leurs interactions avec le monde mixte et pour la recherche des utilisateurs et la résolution des problèmes.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.

Impact de la MRC sur votre applicationHow MRC impacts your app

Activation de la MRC dans votre applicationEnabling MRC in your app

Par défaut, une application n’a rien à faire pour permettre aux utilisateurs d’effectuer des captures de réalité mixte.By default, an app does not have to do anything to enable users to take mixed reality captures.

Activation de l’alignement amélioré pour la MRC dans votre applicationEnabling improved alignment for MRC in your app

Par défaut, la capture de la réalité mixte combine la sortie holographique de l’oeil droit avec l’appareil photo/vidéo (PV).By default, mixed reality capture combines the right eye's holographic output with the photo/video (PV) camera. Ces deux sources sont combinées à l’aide du point de focus défini par l’application immersif en cours d’exécution.These two sources are combined using the focus point set by the currently running immersive app.

Cela signifie que les hologrammes en dehors du plan de focus ne s’alignent pas de la même manière (en raison de la distance physique entre la caméra va et l’affichage à droite).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).

Définir le point de focusSet the focus point

Les applications immersives (sur HoloLens) doivent définir le point de focalisation de leur plan de stabilisation.Immersive apps (on HoloLens) should set the focus point of where they want their stabilization plane to be. Cela garantit l’alignement optimal dans le casque et dans la capture de réalité mixte.This ensures the best alignment in both the headset and in mixed reality capture.

Si un point de focus n’est pas défini, le plan de stabilisation prend par défaut la valeur de deux mètres.If a focus point is not set, the stabilization plane will default to two meters.

Rendre à partir de l’appareil photo PV (abonnement)Render from the PV camera (opt-in)

HoloLens 2 ajoute la possibilité pour une application immersif de s' afficher à partir de l’appareil photo PV pendant l’exécution de la capture de la réalité mixte.HoloLens 2 adds the ability for an immersive app to render from the PV camera while mixed reality capture is running. Pour vous assurer que l’application prend en charge le rendu supplémentaire correctement, l’application doit accepter cette fonctionnalité.To ensure the app supports the additional render correctly, the app has to opt-in to this functionality.

Le rendu à partir de la caméra va offre les améliorations suivantes par rapport à l’expérience MRC par défaut :Render from the PV camera offers the following improvements over the default MRC experience:

  • L’alignement de l’hologramme sur votre environnement physique et les mains (pour les interactions proches) doivent être exacts à toutes les distances, au lieu d’avoir un décalage à des distances autres que le point de focus, comme vous pouvez le voir dans la MRC par défaut.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’oeil droit du casque n’est pas compromis, car il ne sera pas utilisé pour afficher les hologrammes de la sortie 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.

Il existe trois étapes pour activer le rendu à partir de l’appareil photo PV :There are three steps to enable rendering from the PV camera:

  1. Activer PhotoVideoCamera HolographicViewConfigurationEnable the PhotoVideoCamera HolographicViewConfiguration
  2. Gérer le rendu HolographicCamera supplémentaireHandle the additional HolographicCamera render
  3. Vérifier les nuanceurs et le rendu du code correctement à partir de ce HolographicCamera supplémentaireVerify your shaders and code render correctly from this additional HolographicCamera
Activer le HolographicViewConfiguration PhotoVideoCamera dans DirectXEnable the PhotoVideoCamera HolographicViewConfiguration in DirectX

Pour s’abonner au rendu à partir de l’appareil photo PV, une application active simplement le HolographicViewConfigurationde 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;
}
Gérer le rendu HolographicCamera supplémentaire dans DirectXHandle the additional HolographicCamera render in DirectX

Lorsque l’application a choisi d’effectuer le rendu à partir de l’appareil photo PV et que la capture de la réalité mixte démarre :When the app has opt-in to render from the PV camera and mixed reality capture starts:

  1. L’événement CameraAdded de HolographicSpace se déclenche.HolographicSpace's CameraAdded event will fire. Cet événement peut être différé si l’application ne peut pas gérer l’appareil photo pour l’instant.This event can be deferred if the app cannot handle the camera at this time.
  2. Une fois que l’événement est terminé (et qu’il n’y a aucun différé en suspens), le HolographicCamera apparaît dans la liste AddedCameras suivante du HolographicFrame.Once the event has completed (and there are no outstanding deferrals) the HolographicCamera will appear in the next HolographicFrame's AddedCameras list.

Quand la capture de la réalité mixte s’arrête (ou si l’application désactive la configuration de la vue alors que la capture de la réalité mixte est en cours d’exécution) : le HolographicCamera s’affiche dans la liste RemovedCameras du HolographicFrame suivant et l’événement CameraRemoved du HolographicSpace est déclenché.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.

Une propriété ViewConfiguration a été ajoutée à HolographicCamera pour aider à identifier la configuration à laquelle une caméra appartient.A ViewConfiguration property has been added to HolographicCamera to help identify the configuration a camera belongs to.

Activer le HolographicViewConfiguration PhotoVideoCamera dans UnityEnable the PhotoVideoCamera HolographicViewConfiguration in Unity

Notes

Cela nécessite Unity 2018.4.13 F1, Unity 2019.3.0 F1ou plus récent.This requires Unity 2018.4.13f1, Unity 2019.3.0f1, or newer.

Pour accepter le rendu à partir de l’appareil photo PV, lorsque vous utilisez la boîte à outils de la réalité mixte, activez le fournisseur de paramètres d’appareil photo Windows Mixed Reality et vérifiez le paramètre rendu à partir d’une caméra va .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.

Si vous n’utilisez pas la boîte à outils de réalité mixte, vous pouvez utiliser un composant pour vous abonner manuellement comme décrit ci-dessus pour DirectX.If you're not using the Mixed Reality Toolkit, you can use a component to manually opt-in as described above for DirectX.

Gérer le rendu HolographicCamera supplémentaire dans UnityHandle the additional HolographicCamera render in Unity

Cette opération est effectuée automatiquement par Unity.This is done for you automatically by Unity.

Activer le HolographicViewConfiguration PhotoVideoCamera dans UnrealEnable the PhotoVideoCamera HolographicViewConfiguration in Unreal

Notes

Cela nécessite Unreal Engine 4.25 ou ultérieur.This requires Unreal Engine 4.25 or newer.

Pour choisir le rendu à partir de l’appareil photo/vidéo :To opt-in to rendering from the PV Camera:

  1. Appelez SetEnabledMixedRealityCamera et ResizeMixedRealityCameraCall SetEnabledMixedRealityCamera and ResizeMixedRealityCamera
    • Utilisez les valeurs de taille Size X et Size Y pour définir les dimensions de la vidéo.Use the Size X and Size Y values to set the video dimensions.

Troisième caméra

Gérer le rendu HolographicCamera supplémentaire dans inréelHandle the additional HolographicCamera render in Unreal

Cette opération est effectuée automatiquement par inréel.This is done for you automatically by Unreal.

Vérifier que les nuanceurs et le code prennent en charge des caméras supplémentairesVerify shaders and code support additional cameras

Exécutez une capture de la réalité mixte et vérifiez l’alignement inhabituel, le contenu manquant ou les problèmes de performances.Run a mixed reality capture and check for unusual alignment, missing content, or performance issues. Mettez à jour les nuanceurs et le code comme il convient.Update shaders and code as appropriate.

Si certaines scènes ne peuvent pas prendre en charge le rendu sur une caméra supplémentaire, vous pouvez désactiver les HolographicViewConfiguration du PhotoVideoCamera.If there are certain scenes that cannot support rendering to an additional camera, you can disable the PhotoVideoCamera's HolographicViewConfiguration during them.

Désactivation de la MRC dans votre applicationDisabling MRC in your app

application 2D2D app

les applications 2D peuvent choisir de masquer leur contenu visuel lorsque la capture de la réalité mixte s’exécute :2D apps can choose to have their visual content obscured when mixed reality capture is running by:

Application immersifImmersive app

Les applications immersives peuvent choisir d’exclure leur contenu visuel de la capture de la réalité mixte en :Immersive apps can choose to have their visual content excluded from mixed reality capture by:

Clavier du mot de passePassword Keyboard

Avec la mise à jour de Windows 10 mai 2019, le contenu visuel est automatiquement exclu de la capture de la réalité mixte lorsqu’un mot de passe ou un clavier de code confidentiel est visible.With the Windows 10 May 2019 Update, visual content is automatically excluded from mixed reality capture when a password or pin keyboard is visible.

Savoir quand la MRC est activeKnowing when MRC is active

La classe AppCapture peut être utilisée par une application pour savoir quand la capture de la réalité mixte du système est en cours d’exécution (audio ou vidéo).The AppCapture class can be used by an app to know when system mixed reality capture is running (for either audio or video).

Notes

L’API GetForCurrentView de AppCapture peut retourner la valeur null si la capture de la réalité mixte n’est pas disponible sur l’appareil.AppCapture's GetForCurrentView API can return null if mixed reality capture isn't available on the device. Il est également important de supprimer l’inscription de l’événement CapturingChanged lorsque votre application est suspendue, sinon, la désactivation de l’événement peut être bloquée.It's also important to de-register the CapturingChanged event when your app is suspended, otherwise MRC can get into a blocked state.

Meilleures pratiques (spécifiques à HoloLens)Best practices (HoloLens-specific)

La MRC est censée fonctionner sans travail supplémentaire des développeurs, mais il existe quelques éléments à connaître pour fournir la meilleure expérience de capture de la réalité mixte de votre application.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 utilise le canal alpha de l’hologramme pour mélanger avec l’image de l' appareil photoMRC uses the hologram’s alpha channel to blend with the camera imagery

L’étape la plus importante consiste à s’assurer que votre application est déclassée au noir transparent au lieu d’être vidée en noir opaque.The most important step is to make sure your app is clearing to transparent black instead of clearing to opaque black. Dans Unity, cette opération est effectuée par défaut avec le MixedRealityToolkit, mais si vous effectuez un développement dans non Unity, vous devrez peut-être modifier une seule ligne.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.

Voici certains des artefacts que vous pouvez voir dans la MRC si votre application n’est pas dépendante du noir transparent :Here are some of the artifacts you might see in MRC if your app is not clearing to transparent black:

Exemples d’échecs: bords noirs autour du contenu (ne pas effacer jusqu’au noir transparent)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

Exemples d’échecs: la scène d’arrière-plan complète de l’hologramme s’affiche en noir.Example Failures: The entire background scene of the hologram appears black. La définition d’une valeur alpha d’arrière-plan de 1 produit un arrière-plan noirSetting a background alpha value of 1 results in a black background

La définition d’une valeur alpha d’arrière-plan de 1 produit un arrière-plan noir

Résultat attendu: les hologrammes apparaissent correctement fusionnés avec le monde réel (résultat attendu en cas d’effacement au noir transparent)Expected Result: Holograms appear properly blended with the real-world (expected result if clearing to transparent black)

Résultat attendu en cas d’effacement au noir transparent

Solution:Solution:

  • Modifiez tout le contenu affiché en noir opaque pour avoir une valeur alpha de 0.Change any content that is showing up as opaque black to have an alpha value of 0.
  • Assurez-vous que l’application est en mode d’effacement transparent noir.Ensure that the app is clearing to transparent black.
  • La valeur par défaut Unity est Clear pour être désactivée automatiquement avec MixedRealityToolkit, mais s’il s’agit d’une application non Unity, vous devez modifier la couleur utilisée avec 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(). Vous souhaitez vous assurer que vous vous dépassez du noir transparent (0, 0, 0, 0) au lieu du noir opaque (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).

Vous pouvez maintenant ajuster les valeurs alpha de vos ressources si vous le souhaitez, mais cela n’est généralement pas nécessaire.You can now tune the alpha values of your assets if you’d like, but typically don’t need to. La plupart du temps, MRCs semble prêt à l’emploi.Most of the time, MRCs will look good out of the box. MRC suppose une alpha prémultipliée.MRC assumes pre-multiplied alpha. Les valeurs alpha n’affectent que la capture MRC.The alpha values will only affect the MRC capture.

Ce qui se passe lorsque la MRC est activée sur HoloLensWhat to expect when MRC is enabled on HoloLens

Les éléments suivants s’appliquent à la fois à HoloLens (première génération) et à HoloLens 2, sauf indication contraire :The following apply to both HoloLens (first-generation) and HoloLens 2, unless otherwise noted:

  • Le système limite l’application au rendu 30Hz.The system will throttle the application to 30Hz rendering. Cela crée de l’espace pour l’exécution de la MRC afin que l’application n’ait pas besoin de conserver une réserve de budget constante et qu’elle corresponde à la fréquence d’enregistrement de l’enregistrement vidéo MRC de 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
  • Le contenu de l’hologramme dans le bon œil de l’appareil peut sembler « Spark » lors de l’enregistrement/de la diffusion en continu MRC : le texte peut devenir plus difficile à lire et les bords de l’hologramme peuvent apparaître plus dentelés (l’activation d’un rendu de troisième appareil photo sur HoloLens 2 évite ce compromis)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)
  • Les photos et vidéos MRC respectent le point de focalisation de l’application si l’application l’a activée, ce qui permet de s’assurer que les hologrammes sont correctement positionnés.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. Pour les vidéos, le point de focalisation est lissé, de sorte que les hologrammes peuvent paraître lentement en place si la profondeur du point de focalisation change de façon significative.For videos, the Focus Point is smoothed so holograms may appear to slowly drift into place if the Focus Point depth changes significantly. Les hologrammes qui se trouvent à des profondeurs différents du point de focalisation peuvent apparaître dans le monde réel (Voir l’exemple ci-dessous où le point de focus est défini à 2 mètres, mais l’hologramme est positionné à 1 mètre).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).

Les hologrammes à 2 mètres sont parfaitement inscrits au monde entier.

Intégration de la fonctionnalité MRC à partir de votre applicationIntegrating MRC functionality from within your app

Votre application de réalité mixte peut initier la capture de photos ou de vidéos MRC à partir de l’application, et le contenu capturé est mis à la disposition de votre application sans être stocké dans le « rouleau de caméra » de l’appareil.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." Vous pouvez créer un enregistreur MRC personnalisé ou tirer parti de l’interface utilisateur de capture d’appareil photo intégrée.You can create a custom MRC recorder or take advantage of built-in camera capture UI.

MRC avec l’interface utilisateur de l’appareil photo intégréMRC with built-in camera UI

Les développeurs peuvent utiliser l' API d’interface utilisateur de capture de l’appareil photo pour obtenir une photo ou une vidéo de réalité mixte capturée par l’utilisateur avec quelques lignes de code.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.

Cette API lance l’interface utilisateur de la caméra MRC intégrée, à partir de laquelle l’utilisateur peut prendre une photo ou une vidéo, et retourne la capture obtenue à votre application.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. Si vous souhaitez créer votre propre interface utilisateur d’appareil photo ou si vous avez besoin d’un accès de niveau inférieur au flux de capture, vous pouvez créer un enregistreur de capture de réalité mixte personnalisé.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.

Création d’un enregistreur MRC personnaliséCreating a custom MRC recorder

Bien que l’utilisateur puisse toujours déclencher une photo ou une vidéo à l’aide du service de capture MRC du système, une application peut souhaiter créer une application de caméra personnalisée, mais inclure des hologrammes dans le flux de l’appareil photo comme 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. Cela permet à l’application de lancer des captures pour le compte de l’utilisateur, de créer une interface utilisateur d’enregistrement personnalisée ou de personnaliser les paramètres MRC pour nommer quelques exemples.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 ajoute une caméra MRC personnalisée à l’aide des effets MRCHoloStudio adds a custom MRC camera using MRC effects

HoloStudio ajoute une caméra MRC personnalisée à l’aide des effets MRC

Les applications Unity doivent voir Locatable_camera_in_Unity pour la propriété pour activer les hologrammes.Unity Applications should see Locatable_camera_in_Unity for the property to enable holograms.

D’autres applications peuvent le faire à l’aide des API de capture Windows Media pour contrôler l’appareil photo et ajouter un effet de vidéo et d’audio MRC pour inclure les hologrammes virtuels et l’audio de l’application dans les images et les vidéos.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.

Les applications ont deux options pour ajouter l’effet :Applications have two options to add the effect:

Notes

L’espace de noms Windows. Media. MixedRealityCapture n’est pas reconnu par Visual Studio, mais les chaînes sont toujours valides.The Windows.Media.MixedRealityCapture namespace will not be recognized by Visual Studio, but the strings are still valid.

Effet vidéo MRC (Windows. Media. MixedRealityCapture. MixedRealityCaptureVideoEffect)MRC Video Effect (Windows.Media.MixedRealityCapture.MixedRealityCaptureVideoEffect)

Nom de la propriétéProperty Name TypeType Valeur par défautDefault Value DescriptionDescription
StreamTypeStreamType UINT32 (MediaStreamType)UINT32 (MediaStreamType) 1 (VideoRecord)1 (VideoRecord) Décrivez le flux de capture pour lequel cet effet est utilisé.Describe which capture stream this effect is used for. L’audio n’est pas disponible.Audio is not available.
HologramCompositionEnabledHologramCompositionEnabled booleanboolean trueTRUE Indicateur permettant d’activer ou de désactiver les hologrammes dans la capture vidéo.Flag to enable or disable holograms in video capture.
RecordingIndicatorEnabledRecordingIndicatorEnabled booleanboolean trueTRUE Indicateur permettant d’activer ou de désactiver l’indicateur d’enregistrement à l’écran pendant la capture d’hologramme.Flag to enable or disable recording indicator on screen during hologram capturing.
VideoStabilizationEnabledVideoStabilizationEnabled booleanboolean falseFALSE Indicateur d’activation ou de désactivation de la stabilisation vidéo optimisée par le dispositif de suivi HoloLens.Flag to enable or disable video stabilization powered by the HoloLens tracker.
VideoStabilizationBufferLengthVideoStabilizationBufferLength UINT32UINT32 00 Définissez le nombre de frames d’historique utilisés pour la stabilisation vidéo.Set how many historical frames are used for video stabilization. 0 est une latence de 0 et presque « gratuit » du point de vue de l’alimentation et des performances.0 is 0-latency and nearly "free" from a power and performance perspective. 15 est recommandé pour une qualité optimale (au prix de 15 trames de latence et de mémoire).15 is recommended for highest quality (at the cost of 15 frames of latency and memory).
GlobalOpacityCoefficientGlobalOpacityCoefficient floatfloat 0,9 (HoloLens) 1,0 (casque immersif)0.9 (HoloLens) 1.0 (Immersive headset) Définissez le coefficient d’opacité globale de l’hologramme dans une plage allant de 0,0 (entièrement transparent) à 1,0 (entièrement opaque).Set global opacity coefficient of hologram in range from 0.0 (fully transparent) to 1.0 (fully opaque).
BlankOnProtectedContentBlankOnProtectedContent booleanboolean falseFALSE Indicateur d’activation ou de désactivation du retour d’un frame vide si une application UWP 2d présente un contenu protégé.Flag to enable or disable returning an empty frame if there is a 2d UWP app showing protected content. Si cet indicateur a la valeur false et qu’une application UWP 2D affiche du contenu protégé, l’application UWP 2D est remplacée par une texture de contenu protégé dans le casque et dans la capture de la réalité mixte.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 Indicateur permettant d’activer ou de désactiver l’indication du maillage de zone masqué et du contenu voisin de l’appareil photo holographique.Flag to enable or disable showing the holographic camera's hidden area mesh and neighboring content.
En-dessousOutputSize TailleSize 0, 00, 0 Définissez la taille de sortie souhaitée après rognage pour la stabilisation vidéo.Set the desired output size after cropping for video stabilization. Une taille de rognage par défaut est choisie si 0 ou si une taille de sortie non valide est spécifiée.A default crop size is chosen if 0 or an invalid output size is specified.
PreferredHologramPerspectivePreferredHologramPerspective UINT32UINT32 Rendre à partir des paramètres de l’appareil photo dans le portail des appareils WindowsRender from Camera setting in the Windows Device Portal Énumération utilisée pour indiquer la configuration de vue d’appareil photo holographique à capturer : 0 (affichage) signifie que l’application n’est pas invitée à effectuer le rendu à partir de la caméra photo/vidéo, 1 (PhotoVideoCamera) demande à l’application de s’afficher à partir de la caméra photo/vidéo (si l’application la prend en charge).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). Pris en charge uniquement sur HoloLens 2Only supported on HoloLens 2

Notes

Vous pouvez modifier la valeur par défaut de PreferredHologramPerspective dans le portail de périphériques Windows en accédant à la page de capture de la réalité mixte et en désactivez afficher à partir de l’appareil photo.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. La valeur par défaut est 1 (PhotoVideoCamera), mais elle peut être désactivée pour lui attribuer la valeur 0 (affichage).The setting defaults to 1 (PhotoVideoCamera), but can be unchecked to set it to 0 (Display).

La valeur par défaut de PreferredHologramPerspective était 0 (affichage) avant la mise à jour du 2020 juin (windows holographique, version 2004 Build 19041,1106 et windows holographique, version 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).

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

Nom de la propriétéProperty Name TypeType Valeur par défautDefault Value DescriptionDescription
MixerModeMixerMode UINT32UINT32 2 (MIC et système audio)2 (Mic and System audio) Énumération utilisée pour indiquer les sources audio à utiliser : 0 (MIC audio uniquement), 1 (système audio uniquement), 2 (MIC et système audio)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 Paramètre de gain audio de l’application dans le portail des appareils WindowsApp Audio Gain setting in the Windows Device Portal Gain à appliquer au volume audio système.Gain to apply to system audio volume. Les plages sont comprises entre 0,0 et 5,0.Ranges from 0.0 to 5.0. Pris en charge uniquement sur HoloLens 2Only supported on HoloLens 2
MicrophoneGainMicrophoneGain floatfloat Paramètre de gain audio MIC dans le portail d’appareils WindowsMic Audio Gain setting in the Windows Device Portal Gain à appliquer au volume Mic.Gain to apply to mic volume. Les plages sont comprises entre 0,0 et 5,0.Ranges from 0.0 to 5.0. Pris en charge uniquement sur HoloLens 2Only supported on HoloLens 2

Notes

Vous pouvez modifier la valeur par défaut de LoopbackGain ou MicrophoneGain dans le portail de périphériques Windows en accédant à la page de capture de la réalité mixte et en réglant le curseur en regard de leurs paramètres respectifs.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. Les deux paramètres ont par défaut la valeur 1,0, mais peuvent être définis sur n’importe quelle valeur comprise entre 0,0 et 5,0.Both settings default to 1.0, but can be set to any value between 0.0 and 5.0.

L’utilisation du portail d’appareils Windows pour configurer les valeurs par défaut a été ajoutée avec la mise à jour de juin 2020 (Windows holographique, version 2004 Build 19041,1106 et Windows holographique, version 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).

Limitations de la MRC simultanéeSimultaneous MRC limitations

Certaines restrictions s’imposent pour plusieurs applications qui accèdent à MRC en même temps.There are certain limitations around multiple apps accessing MRC at the same time.

Accès à la photo/caméra vidéoPhoto/video camera access

La caméra photo/vidéo est limitée au nombre de processus qui peuvent y accéder en même temps.The photo/video camera is limited to the number of processes that can access it at the same time. Lorsqu’un processus enregistre une vidéo ou prend une photo, tout autre processus ne parvient pas à acquérir l’appareil photo/vidéo.While a process is recording video or taking a photo any other process will fail to acquire the photo/video camera. (cela s’applique à la fois à la capture de réalité mixte et à la capture de photos/vidéos standard)(this applies to both Mixed Reality Capture and standard photo/video capture)

Avec HoloLens 2, une application peut utiliser la propriété MediaCaptureInitializationSettings' SharingMode pour indiquer qu’elle souhaite exécuter SharedReadOnly si elle n’a pas besoin d’un contrôle exclusif sur la caméra photo/vidéo.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. Cela signifie que la résolution et la fréquence d’images de la capture se limitent à ce que les autres applications ont configurées pour la caméra.Doing so means the resolution and framerate of the capture will be limited to what other apps have configured the camera to provide.

Accès intégré à la caméra photo/vidéo MRCBuilt-in MRC photo/video camera access

Fonctionnalité MRC intégrée à Windows 10 (via Cortana, menu Démarrer, raccourcis matériels, Miracast, portail de périphériques Windows) :MRC functionality built into Windows 10 (via Cortana, Start Menu, hardware shortcuts, Miracast, Windows Device Portal):

  • S’exécutera avec ExclusiveControl par défautWill run with ExclusiveControl by default

Toutefois, une prise en charge a été ajoutée à chaque sous-système pour fonctionner en mode partagé :However, support has been added to each subsystem to operate in a shared mode:

  • Si une application demande un accès ExclusiveControl à la caméra photo/vidéo, la MRC intégrée arrête automatiquement l’utilisation de la caméra photo/vidéo pour que la demande de l’application aboutisse.If 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
  • Si la MRC intégrée est démarrée alors qu’une application dispose d’un ExclusiveControl, la MRC intégrée s’exécutera en mode SharedReadOnlyIf built-in MRC is started while an app has ExclusiveControl, built-in MRC will run in SharedReadOnly mode

Cette fonctionnalité du mode partagé présente certaines restrictions :This shared mode functionality has certain restrictions:

  • Photo via Cortana, les raccourcis matériels ou le menu Démarrer : requiert la mise à jour 2018 d’avril de Windows 10 (ou version ultérieure)Photo via Cortana, hardware shortcuts, or Start Menu: Requires the Windows 10 April 2018 Update (or later)
  • Vidéo via Cortana, les raccourcis matériels ou le menu Démarrer : requiert la mise à jour 2018 de Windows 10 avril (ou version ultérieure)Video via Cortana, hardware shortcuts, or Start Menu: Requires the Windows 10 April 2018 Update (or later)
  • Streaming MRC sur Miracast : requiert la mise à jour 2018 de Windows 10 octobre (ou version ultérieure)Streaming MRC over Miracast: Requires the Windows 10 October 2018 Update (or later)
  • Diffusion en continu de la MRC sur le portail de périphériques Windows ou via l’application auxiliaire HoloLens : requiert HoloLens 2Streaming MRC over Windows Device Portal or via the HoloLens companion app: Requires HoloLens 2

Notes

La résolution et la cadence de l’interface utilisateur de la caméra MRC intégrée peuvent être réduites par rapport à leurs valeurs normales lorsqu’une autre application utilise la caméra photo/vidéo.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.

Accès MRCMRC access

Avec la mise à jour 2018 d’avril de Windows 10, il n’existe plus de limitation concernant plusieurs applications qui accèdent au flux MRC (Toutefois, l’accès à la caméra photo/vidéo présente toujours des limites).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).

Avant la mise à jour 2018 de Windows 10 avril, l’enregistreur MRC personnalisé d’une application était mutuellement exclusif avec la MRC du système (capture de photos, capture de vidéos ou diffusion en continu à partir du portail de périphériques 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).

Voir aussiSee also