Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 4fd2aa3c authored by Jean-Michel Trivi's avatar Jean-Michel Trivi Committed by Automerger Merge Worker
Browse files

Merge "Spatializer: document state getters when feature is unsupported" into... 

Merge "Spatializer: document state getters when feature is unsupported" into sc-v2-dev am: 2f645f23

Original change: https://googleplex-android-review.googlesource.com/c/platform/frameworks/base/+/16040116

Change-Id: Ib696a1ee204814123e09c81949056b633ccd1889
parents 3978711f 2f645f23

media/java/android/media/Spatializer.java

+7 −2
Original line number Original line Diff line number Diff line
@@ -63,7 +63,9 @@ public class Spatializer { 
    /**

    /**

     * Returns whether spatialization is enabled or not.

     * Returns whether spatialization is enabled or not.

     * A false value can originate for instance from the user electing to

     * A false value can originate for instance from the user electing to

     * disable the feature.<br>

     * disable the feature, or when the feature is not supported on the device (indicated

     * by {@link #getImmersiveAudioLevel()} returning {@link #SPATIALIZER_IMMERSIVE_LEVEL_NONE}).

     * <br>

     * Note that this state reflects a platform-wide state of the "desire" to use spatialization,

     * Note that this state reflects a platform-wide state of the "desire" to use spatialization,

     * but availability of the audio processing is still dictated by the compatibility between

     * but availability of the audio processing is still dictated by the compatibility between

     * the effect and the hardware configuration, as indicated by {@link #isAvailable()}.

     * the effect and the hardware configuration, as indicated by {@link #isAvailable()}.
@@ -85,7 +87,10 @@ public class Spatializer { 
     * incompatible with sound spatialization, such as playback on a monophonic speaker.<br>

     * incompatible with sound spatialization, such as playback on a monophonic speaker.<br>

     * Note that spatialization can be available, but disabled by the user, in which case this

     * Note that spatialization can be available, but disabled by the user, in which case this

     * method would still return {@code true}, whereas {@link #isEnabled()}

     * method would still return {@code true}, whereas {@link #isEnabled()}

     * would return {@code false}.

     * would return {@code false}.<br>

     * Also when the feature is not supported on the device (indicated

     * by {@link #getImmersiveAudioLevel()} returning {@link #SPATIALIZER_IMMERSIVE_LEVEL_NONE}),

     * the return value will be false.

     * @return {@code true} if the spatializer effect is available and capable

     * @return {@code true} if the spatializer effect is available and capable

     *         of processing the audio for the current configuration of the device,

     *         of processing the audio for the current configuration of the device,

     *         {@code false} otherwise.

     *         {@code false} otherwise.