Window : évènement vrdisplayactivate
Obsolète
Évitez d'utiliser cette fonctionnalité dans de nouveaux projets. Development of the WebVR API halted in favor of WebXR. Cette fonctionnalité peut être candidate à la suppression des standards web ou des navigateurs.
Envisagez d'utiliser plutôt les fonctionnalités suivantes : WebXR.
Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.
L'évènement vrdisplayactivate de l'API WebVR est déclenché lorsqu'un affichage VR peut être présenté, par exemple si un HMD a été déplacé pour le sortir du mode veille, ou réveillé en le mettant sur la tête.
Note : Cet évènement faisait partie de l'ancienne API WebVR (angl.). Il a été remplacé par l'API WebXR Device (angl.).
Cet évènement n'est pas annulable et ne se propage pas.
Syntaxe
Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété de gestionnaire d'évènement.
addEventListener("vrdisplayactivate", (event) => { })
onvrdisplayactivate = (event) => { }
Type d'évènement
Un objet VRDisplayEvent. Hérite de Event.
Exemples
Vous pouvez utiliser l'évènement vrdisplayactivate dans une méthode addEventListener :
window.addEventListener("vrdisplayactivate", () => {
info.textContent = "Affichage activé.";
reportDisplays();
});
Ou utilisez la propriété de gestionnaire d'évènement onvrdisplayactivate :
window.onvrdisplayactivate = () => {
info.textContent = "Affichage activé.";
reportDisplays();
};
Spécifications
Cet évènement faisait partie de l'ancienne API WebVR (angl.) qui a été remplacée par l'API WebXR Device (angl.). Il n'est plus en voie de devenir un standard.
Jusqu'à ce que tous les navigateurs aient implémenté la nouvelle API WebXR Device (angl.), il est recommandé de s'appuyer sur des cadriciels, comme A-Frame (angl.), Babylon.js (angl.), ou Three.js (angl.), ou sur une prothèse d'émulation (angl.), pour développer des applications WebXR qui fonctionnent sur tous les navigateurs. Consultez le guide de portage de WebVR vers WebXR (angl.) de Meta pour plus d'informations.