← Back to branch summary

~xavi-garcia-mena/indicator-sound/bluetooth-icons-bug-1415480

« back to all changes in this revision

Viewing changes to data/com.canonical.indicator.sound.gschema.xml

When showing a "Loud volumes can damage your hearing" confirmation warning, clamp the volume until the user hits "OK". Fixes: #1481913
Approved by: Antti Kaijanmäki, PS Jenkins bot

Show diffs side-by-side

added added

removed removed

Lines of Context:
data/com.canonical.indicator.sound.gschema.xml
42
42
 
43
43
    <!-- VOLUME -->
44
44
 
45
 
    <key name="high-volume-warning-enabled" type="b">
 
45
    <key name="warning-volume-enabled" type="b">
46
46
      <default>true</default>
47
 
      <summary>Whether or not to show the a volume warning.</summary>
48
 
      <description>
49
 
        Whether or not to show the a volume warning when the volume exceeds some level while headphones are plugged in.
50
 
      </description>
51
 
    </key>
52
 
    <key name="high-volume-acknowledgment-ttl" type="i">
53
 
      <default>1200</default>
54
 
      <summary>How often, in hours, a user's high volume confirmation should be remembered.</summary>
55
 
      <description>
56
 
        After a user confirms that they want to listen at a higher volume, subsequent volume
57
 
        changes do not need to re-trigger a warning until this interval has passed.
58
 
        For example, EU standard EN 60950-1/Al2 cites "The acknowledgement does not need to
59
 
        be repeated more than once every 20 h of cumulative listening time."
60
 
      </description>
61
 
    </key>
62
 
    <key name="high-volume-level" type="d">
63
 
      <default>0.75</default>
64
 
      <summary>Volume level that triggers a high volume warning. [0.0..1.0]</summary><!-- FIXME: decibels would be better -->
65
 
      <description>
66
 
        When high volume warnings are enabled, a warning will be shown when
67
 
        the volume level is raised past this level.
68
 
      </description>
69
 
    </key>
70
 
<!-- FIXME: not used yet, needs to be worked into the service.max_volume property wrt allow_amplified_volume .
71
 
     Also, decibels would be better here
72
 
    <key name="maximum-volume" type="d">
73
 
      <default>1.0</default>
74
 
      <summary>Maximum volume level, [0.0..1.0]</summary>
75
 
      <description>
76
 
        Maximum volume level, [0.0..1.0]
77
 
      </description>
78
 
    </key>
79
 
-->
 
47
      <summary>Whether or not to show high volume warnings.</summary>
 
48
      <description>
 
49
        If enabled on a device, a confirmation dialog will be presented to the user if
 
50
        (a) something is plugged into the headphone jack (ie, no warnings for speaker volumes) AND
 
51
        (b) media is playing (ie, no warnings for ringtone volumes) AND
 
52
        (c) the user attempts to set the volume higher than warning-volume-decibels AND
 
53
        (d) the user has not indicated approval in the last warning-volume-approval-ttl seconds.
 
54
      </description>
 
55
    </key>
 
56
    <key name="warning-volume-confirmation-ttl" type="i">
 
57
      <default>72000</default>
 
58
      <summary>How many seconds a user's warning-volume approval should be remembered.</summary>
 
59
      <description>
 
60
        How long to remember a user's approval of the confirmation dialog discussed in the
 
61
        description of 'warning-volume-enabled'.
 
62
        
 
63
        The default value (72,000 seconds) corresponds to the 20 hours suggested by
 
64
        EU standard EN 60950-1/Al2: “The acknowledgement does not need to be repeated
 
65
        more than once every 20 h of cumulative listening time.”        
 
66
      </description>
 
67
    </key>
 
68
    <key name="warning-volume-decibels" type="d">
 
69
      <default>-8.0</default>
 
70
      <summary>Volume level that triggers a high volume warning.</summary>
 
71
      <description>
 
72
        Volume level that triggers a high volume warning.
 
73
        See warning-volume-enabled for details.
 
74
      </description>
 
75
    </key>
 
76
 
 
77
    <key name="normal-volume-decibels" type="d">
 
78
      <default>0</default>
 
79
      <summary>Normal output volume.</summary>
 
80
      <description>
 
81
        The maximum volume when com.ubuntu.sound's 'allow-amplified-volume' setting is disabled.
 
82
 
 
83
        To conform with EU standard EN 60950-1/Al2, this value should never be
 
84
        set to a dB that causes headphone sound output to exceed 100 dBA, nor
 
85
        electric output to exceed 150 mV.
 
86
 
 
87
        The default value (0) corresponds to PulseAudio's PA_VOLUME_NORM.
 
88
      </description>
 
89
    </key>
 
90
 
 
91
    <key name="amplified-volume-decibels" type="d">
 
92
      <default>11</default>
 
93
      <summary>Output volume to use when com.ubuntu.sound's 'allow-amplified-volume' setting is enabled.</summary>
 
94
      <description>
 
95
        The maximum volume when com.ubuntu.sound's 'allow-amplified-volume' setting is enabled.
 
96
 
 
97
        To conform with EU standard EN 60950-1/Al2, this value should never be
 
98
        set to a dB that causes headphone sound output to exceed 100 dBA, nor
 
99
        electric output to exceed 150 mV.
 
100
 
 
101
        The default value (11) corresponds to PulseAudio's PA_VOLUME_UI_MAX.
 
102
      </description>
 
103
    </key>
80
104
 
81
105
  </schema>
82
106
</schemalist>