aboutsummaryrefslogtreecommitdiff
path: root/data/com.canonical.indicator.sound.gschema.xml
blob: 84088830ff123fa6a2172411286a9c735d83c8e4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
<schemalist>
  <schema id="com.canonical.indicator.sound" path="/com/canonical/indicator/sound/" gettext-domain="indicator-sound">
    <key name="blacklisted-media-players" type="as">
      <summary>A list of applications blacklisted from the sound menu</summary>
      <default>[]</default>
      <description>
        Each media player which abides by the MPRIS2 spec will automatically appear in the menu.
        This array should contain the desktop file names (minus .desktop suffix) of applications which
        do not want to be included in the sound menu.
      </description>
    </key>
    <key name="interested-media-players" type="as">
      <summary>A list of applications which at some point have registered with the sound menu</summary>
      <default>[]</default>
      <description>
        Each media player which abides by the MPRIS2 spec will automatically appear in the menu.
        This array should contain the desktop file names (minus .desktop suffix) of applications which
        have at some point appeared in the menU. This allows the menu remember and display offlined applications.
      </description>
    </key>
    <key name="preferred-media-players" type="as">
      <summary>A list of applications that will have player controls visible all the time</summary>
      <default>[ 'rhythmbox' ]</default>
      <description>
        A list of applications that will have player controls visible all the time
      </description>
    </key>
    <key name="global-mute" type="b">
      <default>false</default>
      <summary>Initial setting for global mute (mute all) on the menu </summary>
      <description>
        On start up volume should not be muted.
      </description>
    </key>
    <key name="visible" type="b">
      <default>true</default>
      <summary>Whether or not to show the sound indicator in the menu bar.</summary>
      <description>
        Whether or not to show the sound indicator in the menu bar.
      </description>
    </key>

    <!-- VOLUME -->

    <key name="warning-volume-enabled" type="b">
      <default>true</default>
      <summary>Whether or not to show high volume warnings.</summary>
      <description>
        If enabled on a device, a confirmation dialog will be presented to the user if
        (a) something is plugged into the headphone jack (ie, no warnings for speaker volumes) AND
        (b) media is playing (ie, no warnings for ringtone volumes) AND
        (c) the user attempts to set the volume higher than warning-volume-decibels AND
        (d) the user has not indicated approval in the last warning-volume-approval-ttl seconds.
      </description>
    </key>
    <key name="warning-volume-confirmation-ttl" type="i">
      <default>72000</default>
      <summary>How many seconds a user's warning-volume approval should be remembered.</summary>
      <description>
        How long to remember a user's approval of the confirmation dialog discussed in the
        description of 'warning-volume-enabled'.
        
        The default value (72,000 seconds) corresponds to the 20 hours suggested by
        EU standard EN 60950-1/Al2: “The acknowledgement does not need to be repeated
        more than once every 20 h of cumulative listening time.”	
      </description>
    </key>
    <key name="warning-volume-decibels" type="d">
      <default>-8.0</default>
      <summary>Volume level that triggers a high volume warning.</summary>
      <description>
        Volume level that triggers a high volume warning.
        See warning-volume-enabled for details.
      </description>
    </key>

    <key name="normal-volume-decibels" type="d">
      <default>0</default>
      <summary>Normal output volume.</summary>
      <description>
        The maximum volume when com.ubuntu.sound's 'allow-amplified-volume' setting is disabled.

        To conform with EU standard EN 60950-1/Al2, this value should never be
        set to a dB that causes headphone sound output to exceed 100 dBA, nor
        electric output to exceed 150 mV.

        The default value (0) corresponds to PulseAudio's PA_VOLUME_NORM.
      </description>
    </key>

    <key name="amplified-volume-decibels" type="d">
      <default>11</default>
      <summary>Output volume to use when com.ubuntu.sound's 'allow-amplified-volume' setting is enabled.</summary>
      <description>
        The maximum volume when com.ubuntu.sound's 'allow-amplified-volume' setting is enabled.

        To conform with EU standard EN 60950-1/Al2, this value should never be
        set to a dB that causes headphone sound output to exceed 100 dBA, nor
        electric output to exceed 150 mV.

        The default value (11) corresponds to PulseAudio's PA_VOLUME_UI_MAX.
      </description>
    </key>

    <key name="last-running-player" type="s">
      <default>""</default>
      <summary>Stores which was the last running music player.</summary>
      <description>
        To make the last running player persistent and be able to set its playback controls
        we store which was the last player running id.

        The default value ("") corresponds to no player.
      </description>
    </key>

  </schema>
</schemalist>