diff --git a/media/java/android/media/AudioAttributes.java b/media/java/android/media/AudioAttributes.java index 19354e0a67145..7dd4b10c5fbf3 100644 --- a/media/java/android/media/AudioAttributes.java +++ b/media/java/android/media/AudioAttributes.java @@ -335,6 +335,10 @@ public final class AudioAttributes implements Parcelable { /** * Flag defining a behavior where the audibility of the sound will be ensured by the system. + * To ensure sound audibility, the system only uses built-in speakers or wired headphones + * and specifically excludes wireless audio devices. + *

Note this flag should only be used for sounds subject to regulatory behaviors in some + * countries, such as for camera shutter sound, and not for routing behaviors. */ public final static int FLAG_AUDIBILITY_ENFORCED = 0x1 << 0; /**