WebVR API

Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.

Brouillon
Cette page n'est pas terminée.

Attention, la traduction de cette page n'est pas terminée. De plus, la documentation de l'API WebVR est en cours de mise à jour pour couvrir la version v1.0, par conséquent certaines des ses informations vont être obsolètes. Contactez chrisdavidmills si vous avez des questions à propos de cette documentation.

Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

WebVR fournit un support pour les dispositifs de réalité virtuelle - par exemple pour les casques de réalité virtuelle comme l'Oculus Rift - aux applications Web, permettant aux développeurs de traduire les informations de position et de mouvement de l'appareil en mouvements autour d'une scène 3D. Cela a de nombreuses applications très intéressantes, des visites de produits virtuels aux applications de formation interactive en passant par des jeux en première personne dans un environnement immersif.

Concepts et usage

Sketch of a person in a chair with wearing goggles labelled "Head mounted display (HMD)" facing a monitor with a webcam labelled "Position sensor"

Tous les périphériques de réalité virtuelle connectés à votre ordinateur seront donné grâce à la méthode Navigator.getVRDisplays(). Cela retournera un tableau d'objets représentant les périphériques, qui auront l'héritage de l'objet VRDevice — généralement un casque de réalité virtuelle renverra deux périphériques — le casque lui-même, représenté par HMDVRDevice, et la caméra capteur de position qui suit la position de votre tête, représenté par PositionSensorVRDevice.

L'objet PositionSensorVRDevice contient la méthode getState(), qui retourne un objet VRPositionState — cela représente l'état du capteur à un timecode donné, et inclus les propriétés avec des données utiles tel que la vélocité, l'accélération et l'orientation, utiles pour mettre à jour le rendu de la scène pour chaque image en accord avec le mouvement du casque de réalité virtuelle.

La méthode HMDVRDevice.getEyeParameters() retourne un objet VREyeParameters, qui peut être utilisé pour obtenir l'information du champ de vision — combien le casque de réalité virtuel peut afficher de la scène. Le VREyeParameters.currentFieldOfView retourne un objet VRFieldOfView qui contient quatre angles décrivant le champ de vision actuel depuis le point central. Vous pouvez aussi changer le champ de vision en utilisant HMDVRDevice.setFieldOfView().

WebVR Interfaces

VRDisplay
Représente un périphérique de réalité virtuelle supporté par cette API. Il inclut des informations générales comme les IDs et des descriptions de l'appareil, ainsi que des méthodes pour commencer à présenter une scène VR, récupérer les paramètres visuels, les capacités d'affichage et d'autres fonctionnalités importantes.
VRDisplayCapabilities
Décrit les capacités d'un appareil VRDisplay — ses fonctionalités peuvent être utilisée pour tester les capacités du périphérique, par exemple peut-il retourner l'information de position.
VRPose
Représente l'état de la position à un timecode donné (qui inclut l'orientation, la position, la vélocité et l'accélération).
VREyeParameters
Donne accès à l'ensemble des informations requises pour faire le rendu d'une scene pour l'oeil indiqué, dont les informations de champ de vision.
VRFieldOfView
Représente le champ de vision actuel définit par quatre angles décrivant la vue depuis le point central.
VRLayer
Représente un calque d'un objet VRDisplay.
VRStageParameters
Représente les données décrivant l'espace physique disponible pour les périphériques de réalité virtuelle pouvant offrir une expérience dans une piàce réelle.

Extensions to other interfaces

Gamepad.displayId Lecture seule
Retourne l'ID VRDisplay.displayId du périphérique VRDisplay associé — l'appareil de réalité virtuelle où la manette de jeu contrôle la scene affichée.
Navigator.activeVRDisplays Lecture seule
Retourne un tableau contenant tous les périphériques (objet VRDisplay) qui sont actifs (quand VRDisplay.ispresenting est à true).
Navigator.getVRDisplays()
Retourne un tableau contenant tous les périphériques (objet VRDisplay) disponibles qui sont connectés à l'ordinateur.
Window.onvrdisplayconnected
Represents an event handler that will run when a compatible VR device has been connected to the computer (when the vrdisplayconnected event fires).
Window.onvrdisplaydisconnected
Represents an event handler that will run when a compatible VR device has been disconnected from the computer (when the vrdisplaydisconnected event fires).
Window.onvrdisplaypresentchange
represents an event handler that will run when the presenting state of a VR device changes — i.e. goes from presenting to not presenting, or vice versa (when the onvrdisplaypresentchange event fires).

Examples

You can find a number of examples at these Github repos:

  • A-Frame: Open source web framework for building VR experiences. Many examples.
  • mdn/webvr-tests: Simple demos built to illiustrate basic feature usage.
  • MozVR team: More advanced demos, the WebVR spec source, and more!

Specifications

Specification Status Comment
WebVR Brouillon de l'éditeur Initial definition

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support Pas de support (Oui) Pas de support Pas de support Pas de support
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile Chrome for Android Samsung Internet for GearVR
Basic support Pas de support (Oui) Pas de support Pas de support Pas de support Pas de support (Oui)
 

See also

  • webvr.info - Up-to-date information about WebVR, browser setup, and community.
  • Is WebVR Ready? - Up-to-date information about WebVR browser support (including experimental builds).
  • MozVr.com — demos, downloads, and other resources from the Mozilla VR team.
  • A-Frame — a web framework for building VR experiences (with HTML), from the Mozilla VR team.
  • Console Game on Web — a collection of interesting game concept demos, some of which include WebVR.
  • threejs-vr-boilerplate — a very useful starter template for writing WebVR apps into.
  • Oculus Rift homepage

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : DavidLibeau
 Dernière mise à jour par : DavidLibeau,