WebAPI/PresentationAPI
From MozillaWiki
< WebAPI
Introduction
Presentation API enables web content to access external presentation-type displays and use them for presenting web content. With this API, web page can initiate and control an presentation request.
For retrieving available devices information, please refer to Presentation Device Info API.
Specification
Use case
See Use Cases and Requirements
Interface
- For 1-UA user agent, three preferences "dom.presentation.enabled", "dom.presentation.controller.enabled", and "dom.presentation.receiver.enabled" need to be set to true.
- For 2-UAs controlling user agent, two preferences "dom.presentation.enabled" and "dom.presentation.controller.enabled" need to be set to true.
- For 2-UAs receiving user agent, two preferences "dom.presentation.enabled" and "dom.presentation.receiver.enabled" need to be set to true.
Presentation
- WebIDL
- No UI support for defaultRequest.
PresentationRequest
- WebIDL
- support URL with http:// protocol scheme to open web page in private browsing mode
- support URL with app:// protocol scheme to launch an packaged app installed on target B2G device
- only available in controlling browsing context
PresentationReceiver
- WebIDL
- only available in receiving browsing context
- many-to-one session is not supported yet. bug 1195605 (NEW)
PresentationConnection
PresentationConnectionList
- WebIDL
- only available in receiving browsing context
PresentationAvailability
- WebIDL
- only available in controlling browsing context
Architecture
Here is the high-level architecture overview of Presentation API.
WebIDL Implementation
- Provide the WebAPI interface
- Detail at WebAPI/PresentationAPI:WebIDL_Implementation
Core Service
- Maintain the session state and app-to-app transportation channel
- Handle the session setup / reconnect / terminate procedure
- Live in chrome process
- except for DataChannelTransportBuilder and DataChannelTransport
- Detail at WebAPI/PresentationAPI:CoreService
Device Manager
- Load registered device provider at start-up automatically
- Provide device list and firing availability event
- Live in chrome process
Device Provider
- Implement device discovery mechanism
- Handle control channel setup procedure
- Live in chrome process
Browser/System UI Glue
- Handle device selection and application launch
- Live in chrome process
Development Plan
Basic Functionalities
- Stage 1: Enable 2-UAs mode on Firefox OS, for privilege apps only.
- Implement Presentation API (Bug 1069230 (RESOLVED) and Bug 1148307 (RESOLVED))
- Provide MDNS provider on Firefox OS (Bug 1115480 (RESOLVED))
- Provide device selection/configuration UI on Firefox OS (Bug 1161440 (RESOLVED))
- The initial version of UI should be simple without detailed security design, but keep pref off after check-in
- pref on after security team confirmation.
- Stage 2: Integrated with media fling on Firefox for Android.
- Provide MDNS provider on Firefox for Android. (Bug 1158029 (RESOLVED))
- Add Presentation Device as a fling service device. (Bug 1129785 (RESOLVED))
- Stage 3: Enable 1-UAs mode on Firefox OS for HDMI display.
- Enable multi-window for HDMI (Bug 1116089 (RESOLVED))
- Implement HDMI device provider (Bug 1208417 (RESOLVED))
- Make Gaia use presentation API (Bug 1235124 (RESOLVED))
- Stage 4: Enable 1-UAs mode in HTTPS web pages on Firefox For Android.
- Enable 1-UA mode for Chromecast (Bug 1252788 (ON GOING)).
- Provide device selection/configuration UI on Firefox for Android (Bug 1232105 (RESOLVED)).
- Change permission model for Presentation API (Bug 1278205 (RESOLVED)).
- Stage 5: Enable in HTTPS web pages for Firefox desktop.
- Provide MDNS provider on all supported desktop platforms
- Windows (Bug 1239909 (NEW))
- Linux (Bug 1225736 (NEW))
- Mac OSX (Bug 1225726 (RESOLVED))
- Provide device selection/configuration UI on Firefox (Bug 1289974 (ON GOING)).
- Provide MDNS provider on all supported desktop platforms
Advanced Functionalities
- Enable 1-UA mode for DIAL app to increase device compatibility
- Support different URL scheme, e.g. data, file
- Support multiple session (n:1) to support wider user scenario, e.g. multi-player game. (Bug 1195605 (NEW))