Merge "Remove unicode quotes in javadoc for AudioFocusRequest and MediaPlayer"...

 * 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>

 *

 * <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

 * 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>

 *

     * 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