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

這項政策的專屬 ID。

從 AddPolicy 傳回，同時也由 RemovePolicy 傳回。

2

這項政策的參數。

1

此資源所控制設定的獨特部分。

任何指定的目標只能由一個資源控制。

2

這個屬性的可用轉換類型清單。

3

這項資源的有效政策清單。

1

介於 0.0 到 1.0 (含) 之間的磁碟區。

1

此參數應包含在 MIN 轉換中，並指定要限制音訊串流的音量等級。

2

此參數應包含在 MAX 轉換中，並指定音訊串流的音量層級。

1

可以套用政策的音訊串流。