From e8fb9cb844539f421a7600ad60644eb9a3e9869b Mon Sep 17 00:00:00 2001 From: Jean-Michel Trivi Date: Wed, 30 Jun 2021 09:13:27 -0700 Subject: [PATCH] AudioAttributes FLAG_AUDIBILITY_ENFORCED javadoc update More documentation on the behavior of FLAG_AUDIBILITY_ENFORCED and its intended use. Bug: 190612108 Test: make doc-comment-check-docs Change-Id: Ib982e1185c02e0f55024e6cae6bb18896a994ae3 --- media/java/android/media/AudioAttributes.java | 4 ++++ 1 file changed, 4 insertions(+) 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; /**