1306420 - [webvr] Deprecate some WebVR 1.0 functions and interfaces in VRDisplay.webidl

Status: RESOLVED WONTFIX

(Core :: Graphics, defect)

Description

[:kip (Kearwood Gilbert)]

WebVR 1.1 introduces some new functions to enable use of a wider range of VR and AR hardware.  These functions replace some functions defined with WebVR 1.0.

We will support both the WebVR 1.0 and WebVR 1.1 equivalent functions until they are no longer widely in use.

To ensure users choose the WebVR 1.1 versions in new code, we will mark the deprecated functions and interfaces in the webidl:

interface VRFieldOfView
attribute VREyeParameters.fieldOfView
function VRDisplay.GetPose

Comment 1

[:kip (Kearwood Gilbert)]

The procedure for deprecating WebIDL bindings:

https://developer.mozilla.org/en-US/docs/Mozilla/WebIDL_bindings#Deprecatedtag

Comment 2

[:kip (Kearwood Gilbert)]

Attachment: Bug 1306420 - [webvr] Deprecate some WebVR 1.0 functions and interfaces in VRDisplay.webidl

Review commit: https://reviewboard.mozilla.org/r/86434/diff/#index_header
See other reviews: https://reviewboard.mozilla.org/r/86434/

Comment 3

[:kip (Kearwood Gilbert)]

https://treeherder.mozilla.org/#/jobs?repo=try&revision=9af9280629d3

Comment 4

[:kip (Kearwood Gilbert)]

Comment on attachment 8801776 [details]
Bug 1306420 - [webvr] Deprecate some WebVR 1.0 functions and interfaces in VRDisplay.webidl

Review request updated; see interdiff: https://reviewboard.mozilla.org/r/86434/diff/1-2/

Comment 5

[:kip (Kearwood Gilbert)]

Comment on attachment 8801776 [details]
Bug 1306420 - [webvr] Deprecate some WebVR 1.0 functions and interfaces in VRDisplay.webidl

Review request updated; see interdiff: https://reviewboard.mozilla.org/r/86434/diff/2-3/

Comment 6

[:kip (Kearwood Gilbert)]

There will be little benefit to dumping deprecation warnings to the console for these deprecated methods, as recently the decision has been made that the WebVR 2.0 API will intentionally break backwards compatibility with other functions, including the ones that the deprecation warnings would advise be used.

We will continue to support the deprecated methods for WebVR 1.1 until WebVR 2.0 is ready to ship.  The plan is to use a system add-on to provide a polyfill for the WebVR 1.1 API on top of the WebVR 2.0 API.  Other browser vendors have expressed interest in sharing this polyfill to ease the transition.  This polyfill would produce deprecation warnings when active.

I'll mark this bug as resolved.