diff --git a/core/java/android/os/Vibrator.java b/core/java/android/os/Vibrator.java index 7f0d6349f57fd..fb3230093f24d 100644 --- a/core/java/android/os/Vibrator.java +++ b/core/java/android/os/Vibrator.java @@ -519,7 +519,8 @@ public abstract class Vibrator { } /** - * Query whether the vibrator supports all the given effects. + * Query whether the vibrator supports all the given effects. If no argument is provided this + * method will always return {@link #VIBRATION_EFFECT_SUPPORT_YES}. * *

If an effect is not supported, the system may still automatically fall back to a simpler * vibration instead, which is not optimised for the specific device, however vibration isn't @@ -541,7 +542,8 @@ public abstract class Vibrator { *

Use {@link #areEffectsSupported(int...)} to get individual results for each effect. * * @param effectIds Which effects to query for. - * @return Whether all the effects are natively supported by the device. + * @return Whether all specified effects are natively supported by the device. Empty query + * defaults to {@link #VIBRATION_EFFECT_SUPPORT_YES}. */ @VibrationEffectSupport public final int areAllEffectsSupported( @@ -590,7 +592,8 @@ public abstract class Vibrator { } /** - * Query whether the vibrator supports all of the given primitives. + * Query whether the vibrator supports all of the given primitives. If no argument is provided + * this method will always return {@code true}. * *

If a primitive is not supported by the device, then no vibration will occur if * it is played. @@ -598,7 +601,7 @@ public abstract class Vibrator { *

Use {@link #arePrimitivesSupported(int...)} to get individual results for each primitive. * * @param primitiveIds Which primitives to query for. - * @return Whether all specified primitives are supported. + * @return Whether all specified primitives are supported. Empty query defaults to {@code true}. */ public final boolean areAllPrimitivesSupported( @NonNull @VibrationEffect.Composition.PrimitiveType int... primitiveIds) {