fuchsia.settings.policy

失败

一般内部故障。

UNKNOWN_POLICY

指定的政策 ID 未知。

如果另一个客户端在 Get 调用和 RemovePolicy 调用之间移除了某项政策，则可能会发生这种情况。

INVALID_POLICY

指定的政策与现有政策冲突。

如果另一个客户端在 Get 调用和 AddPolicy 调用之间添加了政策，则可能会发生这种情况。

最高

将音频流的最大值限制在特定级别。

最大音量限制对 fuchsia.settings.Audio 的客户端是透明的。客户端始终能够将音量设置为 1.0（最大），以免用户因无法将音量设置为最大而感到困惑。内部音量会传达给 AudioCore，以设置实际的音量，该音量将始终被限制在指定的最大值。

在外部，音量百分比将始终是政策允许的上限的百分比。例如，如果最大限制设置为 0.8，则将音量设置为 1.0 的客户端会在内部转换为 0.8。外部音量为 0.5 在内部会调整为 0.4。

如果存在音量下限，则外部音量下限将等于音量下限除以最大音量。例如，如果音量上限是 0.8，音量下限为 0.2，则可能的最低外部音量为 0.25，因为 0.2 是 0.8 的 25%。最小范围对客户端不透明，以防止音量为 0%，但仍能听到音频。

MIN

将音频流的最小值限制在特定级别。

如果在添加此政策时，音量低于指定的最低级别，系统会自动将音量调高到指定的最小值。将音量设置为低于最低音量的调用不会失败，但实际音量将高于指定的最低音量。

请注意，最小音量限制是对内部“true”音量的限制。如果设置了最大音量政策，fuchsia.settings.Audio 的客户端看到的最小值会更高。如需了解详情，请参阅 MAX 体积转换文档。

1

此政策的唯一标识符。

从 AddPolicy 返回，并且也由 RemovePolicy 使用。

2

此政策的参数。

1

此属性所控制的设置的独特之处。

只有一个属性可以控制任何给定目标。

2

此属性的可用转换类型列表。

3

此媒体资源的有效政策列表。

1

介于 0.0 和 1.0（含）之间的卷。

1

此参数应包含在 MIN 转换中，并指定将音频流限制到的音量。

2

此参数应包含在 MAX 转换中，并指定将音频流限制到的音量。

1

可应用政策的音频流。