|
1 /* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ |
|
2 /* This Source Code Form is subject to the terms of the Mozilla Public |
|
3 * License, v. 2.0. If a copy of the MPL was not distributed with this |
|
4 * file, You can obtain one at http://mozilla.org/MPL/2.0/. |
|
5 */ |
|
6 |
|
7 interface AudioChannelManager : EventTarget { |
|
8 /** |
|
9 * Indicates whether the headphones are plugged in or not. |
|
10 */ |
|
11 readonly attribute boolean headphones; |
|
12 |
|
13 /** |
|
14 * Fired when the headphones are plugged or unplugged. |
|
15 * |
|
16 * When the headphones are unplugged, we may start playing audio through the |
|
17 * system's speakers. Similarly, when headphones are plugged in, we may |
|
18 * switch audio from speakers to headphones. |
|
19 * |
|
20 * If audio is currently playing in this window or in one of its children, we |
|
21 * will fire this event before we switch the audio output from headphones to |
|
22 * speakers (or vice versa). This allows you to, for example, pause your |
|
23 * window's audio when the headphones are unplugged. |
|
24 */ |
|
25 attribute EventHandler onheadphoneschange; |
|
26 |
|
27 /** |
|
28 * Indicates which audio channel is used to adjust volume when pressing HW |
|
29 * volume keys. |
|
30 */ |
|
31 attribute DOMString volumeControlChannel; |
|
32 }; |