Merge "Remove unicode quotes in javadoc for AudioFocusRequest and MediaPlayer" into udc-qpr-dev
This commit is contained in:
committed by
Android (Google) Code Review
commit
6e83117bff
@@ -39,8 +39,8 @@ import android.os.Looper;
|
||||
* but there is only one the user would really listen to (focus on), while the other plays in
|
||||
* the background. An example of this is driving directions being spoken while music plays at
|
||||
* a reduced volume (a.k.a. ducking).
|
||||
* <p>When an application requests audio focus, it expresses its intention to “own” audio focus to
|
||||
* play audio. Let’s review the different types of focus requests, the return value after a request,
|
||||
* <p>When an application requests audio focus, it expresses its intention to "own" audio focus to
|
||||
* play audio. Let's review the different types of focus requests, the return value after a request,
|
||||
* and the responses to a loss.
|
||||
* <p class="note">Note: applications should not play anything until granted focus.</p>
|
||||
*
|
||||
@@ -51,7 +51,7 @@ import android.os.Looper;
|
||||
* <li>{@link AudioManager#AUDIOFOCUS_GAIN} expresses the fact that your application is now the
|
||||
* sole source of audio that the user is listening to. The duration of the audio playback is
|
||||
* unknown, and is possibly very long: after the user finishes interacting with your application,
|
||||
* (s)he doesn’t expect another audio stream to resume. Examples of uses of this focus gain are
|
||||
* (s)he doesn't expect another audio stream to resume. Examples of uses of this focus gain are
|
||||
* for music playback, for a game or a video player.</li>
|
||||
*
|
||||
* <li>{@link AudioManager#AUDIOFOCUS_GAIN_TRANSIENT} is for a situation when you know your
|
||||
@@ -60,20 +60,20 @@ import android.os.Looper;
|
||||
* for playing an alarm, or during a VoIP call. The playback is known to be finite: the alarm will
|
||||
* time-out or be dismissed, the VoIP call has a beginning and an end. When any of those events
|
||||
* ends, and if the user was listening to music when it started, the user expects music to resume,
|
||||
* but didn’t wish to listen to both at the same time.</li>
|
||||
* but didn't wish to listen to both at the same time.</li>
|
||||
*
|
||||
* <li>{@link AudioManager#AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK}: this focus request type is similar
|
||||
* to {@code AUDIOFOCUS_GAIN_TRANSIENT} for the temporary aspect of the focus request, but it also
|
||||
* expresses the fact during the time you own focus, you allow another application to keep playing
|
||||
* at a reduced volume, “ducked”. Examples are when playing driving directions or notifications,
|
||||
* it’s ok for music to keep playing, but not loud enough that it would prevent the directions to
|
||||
* be hard to understand. A typical attenuation by the “ducked” application is a factor of 0.2f
|
||||
* at a reduced volume, "ducked". Examples are when playing driving directions or notifications,
|
||||
* it's ok for music to keep playing, but not loud enough that it would prevent the directions to
|
||||
* be hard to understand. A typical attenuation by the "ducked" application is a factor of 0.2f
|
||||
* (or -14dB), that can for instance be applied with {@code MediaPlayer.setVolume(0.2f)} when
|
||||
* using this class for playback.</li>
|
||||
*
|
||||
* <li>{@link AudioManager#AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE} is also for a temporary request,
|
||||
* but also expresses that your application expects the device to not play anything else. This is
|
||||
* typically used if you are doing audio recording or speech recognition, and don’t want for
|
||||
* typically used if you are doing audio recording or speech recognition, and don't want for
|
||||
* examples notifications to be played by the system during that time.</li>
|
||||
* </ul>
|
||||
*
|
||||
|
||||
@@ -1057,7 +1057,7 @@ public class MediaPlayer extends PlayerBase
|
||||
* this API to pass the cookies as a list of HttpCookie. If the app has not installed
|
||||
* a CookieHandler already, this API creates a CookieManager and populates its CookieStore with
|
||||
* the provided cookies. If the app has installed its own handler already, this API requires the
|
||||
* handler to be of CookieManager type such that the API can update the manager’s CookieStore.
|
||||
* handler to be of CookieManager type such that the API can update the manager's CookieStore.
|
||||
*
|
||||
* <p><strong>Note</strong> that the cross domain redirection is allowed by default,
|
||||
* but that can be changed with key/value pairs through the headers parameter with
|
||||
|
||||
Reference in New Issue
Block a user