1606782 - Keep media controller's life cycle as the same as its corresponding top-level browsing context

Status: RESOLVED FIXED

(Core :: Audio/Video: Playback, task, P2)

Description

[Alastor Wu [:alwu]]

As each media controller corresponds to a tab (a browsing context tree), so the controller's life cycle should be equal to the tab. Currently we use the top-level browsing context to represent a tab, so when that browsing context is being destroyed, we should also destroy the corresponding media controller.

That can fix some problems,

(1) to make sure all controllers in MediaControlSerivce are valid
We add media controller to the service when it becomes active, and remove it from the service when it becomes inactive.

However, in order to inactivate a controller, we need to receive the notification from the content process, which is used to update the controlled media number. But this notification might fail to sent in some cases [1]. If the corresponding browsing context has been discarded, then we couldn't receive the correct update to remove the media controller from the service.

Therefore, if the life of media controller is controlled by its corresponding context, then we can ensure to remove the controller from the service when the browsing context is going to be destroyed.

[1] https://searchfox.org/mozilla-central/rev/053826b10f838f77c27507e5efecc96e34718541/dom/media/mediacontrol/MediaControlUtils.cpp#56-58

(2) to avoid unneccesary creation and destruction of the media controller
Currently the controller would be destroyed when it become inactive (no controlled media existing), and it might be recreated again later if we have other new created controlled media.

We should reuse same media controller all the time until the tab is going to be destroyed.

(3) to support the implementation of bug1592037

In order to support adding metadata on the media controller, we have to keep media controller alive even if we don't start any controlled media. Current implementation can only keep media controller alive when it has controlled media, but the metadata can be set before having any controlled media.

Therefore, we have to change the controller's life cycle in order to store metadata before any controlled media starts.

Comment 1

[Alastor Wu [:alwu]]

Attachment: Bug 1606782 - part1 : rename controller related functions and member to emphasize that only active controller would be added into the controller list in the service.

Comment 2

[Alastor Wu [:alwu]]

Attachment: Bug 1606782 - part2 : create media controller via canonical browsing context.

Comment 3

[Alastor Wu [:alwu]]

Attachment: Bug 1606782 - part2 : introduce the concept of main controller.

Comment 4

[Alastor Wu [:alwu]]

Attachment: Bug 1606782 - part4 : make audio focus manager independent from other components.

Comment 5

[Alastor Wu [:alwu]]

Attachment: Bug 1606782 - part5 : handle audio competing first

Comment 6

[Alastor Wu [:alwu]]

Attachment: Bug 1606782 - part3 : replace assertion with returning result of register/unregister controller

We should ensure that controllers has been removed from the service when it destroys. Therefore, we remove the assertion in MediaControlService::RegisterActiveMediaController() and MediaControlService::UnregisterActiveMediaController(), and return the result to allow caller to know if it has been registered or unregistered or not in order to do error handling or add assertions.

Comment 7

[Pulsebot]

Pushed by [e-mail]:
https://hg.mozilla.org/integration/autoland/rev/1b9a35a629b3
part1 : rename controller related functions and member to emphasize that only active controller would be added into the controller list in the service. r=chunmin,bryce
https://hg.mozilla.org/integration/autoland/rev/f41cb58b7afc
part2 : create media controller via canonical browsing context. r=chunmin,nika
https://hg.mozilla.org/integration/autoland/rev/45684b8d59e1
part3 : replace assertion with returning result of register/unregister controller r=chunmin,bryce
https://hg.mozilla.org/integration/autoland/rev/20e34fd5fa51
part4 : make audio focus manager independent from other components. r=chunmin,bryce
https://hg.mozilla.org/integration/autoland/rev/4e4e597e9281
part5 : handle audio competing first r=chunmin,bryce

Comment 8

[Oana Pop-Rus]

https://hg.mozilla.org/mozilla-central/rev/1b9a35a629b3
https://hg.mozilla.org/mozilla-central/rev/f41cb58b7afc
https://hg.mozilla.org/mozilla-central/rev/45684b8d59e1
https://hg.mozilla.org/mozilla-central/rev/20e34fd5fa51
https://hg.mozilla.org/mozilla-central/rev/4e4e597e9281