/* * Copyright (C) 2018 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package com.android.systemui.statusbar; import android.annotation.NonNull; import android.annotation.Nullable; import android.media.AudioAttributes; import android.os.Process; import android.os.VibrationAttributes; import android.os.VibrationEffect; import android.os.Vibrator; import android.view.View; import androidx.annotation.VisibleForTesting; import com.android.systemui.dagger.SysUISingleton; import org.jetbrains.annotations.NotNull; import java.util.concurrent.Executor; import java.util.concurrent.Executors; import javax.inject.Inject; /** * A Helper class that offloads {@link Vibrator} calls to a different thread. * {@link Vibrator} makes blocking calls that may cause SysUI to ANR. * TODO(b/245528624): Use regular Vibrator instance once new APIs are available. */ @SysUISingleton public class VibratorHelper { private final Vibrator mVibrator; public static final VibrationAttributes TOUCH_VIBRATION_ATTRIBUTES = VibrationAttributes.createForUsage(VibrationAttributes.USAGE_TOUCH); private static final VibrationEffect BIOMETRIC_SUCCESS_VIBRATION_EFFECT = VibrationEffect.get(VibrationEffect.EFFECT_CLICK); private static final VibrationEffect BIOMETRIC_ERROR_VIBRATION_EFFECT = VibrationEffect.get(VibrationEffect.EFFECT_DOUBLE_CLICK); private static final VibrationAttributes HARDWARE_FEEDBACK_VIBRATION_ATTRIBUTES = VibrationAttributes.createForUsage(VibrationAttributes.USAGE_HARDWARE_FEEDBACK); private final Executor mExecutor; /** * Creates a vibrator helper on a new single threaded {@link Executor}. */ @Inject public VibratorHelper(@Nullable Vibrator vibrator) { this(vibrator, Executors.newSingleThreadExecutor()); } /** * Creates new vibrator helper on a specific {@link Executor}. */ @VisibleForTesting public VibratorHelper(@Nullable Vibrator vibrator, Executor executor) { mExecutor = executor; mVibrator = vibrator; } /** * @see Vibrator#vibrate(long) */ public void vibrate(final int effectId) { if (!hasVibrator()) { return; } mExecutor.execute(() -> mVibrator.vibrate(VibrationEffect.get(effectId, false /* fallback */), TOUCH_VIBRATION_ATTRIBUTES)); } /** * @see Vibrator#vibrate(int, String, VibrationEffect, String, VibrationAttributes) */ public void vibrate(int uid, String opPkg, @NonNull VibrationEffect vibe, String reason, @NonNull VibrationAttributes attributes) { if (!hasVibrator()) { return; } mExecutor.execute(() -> mVibrator.vibrate(uid, opPkg, vibe, reason, attributes)); } /** * @see Vibrator#vibrate(VibrationEffect, AudioAttributes) */ public void vibrate(@NonNull VibrationEffect effect, @NonNull AudioAttributes attributes) { if (!hasVibrator()) { return; } mExecutor.execute(() -> mVibrator.vibrate(effect, attributes)); } /** * @see Vibrator#vibrate(VibrationEffect) */ public void vibrate(@NotNull VibrationEffect effect) { if (!hasVibrator()) { return; } mExecutor.execute(() -> mVibrator.vibrate(effect)); } /** * @see Vibrator#hasVibrator() */ public boolean hasVibrator() { return mVibrator != null && mVibrator.hasVibrator(); } /** * @see Vibrator#cancel() */ public void cancel() { if (!hasVibrator()) { return; } mExecutor.execute(mVibrator::cancel); } /** * Perform vibration when biometric authentication success */ public void vibrateAuthSuccess(String reason) { vibrate(Process.myUid(), "com.android.systemui", BIOMETRIC_SUCCESS_VIBRATION_EFFECT, reason, HARDWARE_FEEDBACK_VIBRATION_ATTRIBUTES); } /** * Perform vibration when biometric authentication error */ public void vibrateAuthError(String reason) { vibrate(Process.myUid(), "com.android.systemui", BIOMETRIC_ERROR_VIBRATION_EFFECT, reason, HARDWARE_FEEDBACK_VIBRATION_ATTRIBUTES); } /** * Perform a vibration using a view and the one-way API with flags * @see View#performHapticFeedback(int feedbackConstant, int flags) */ public void performHapticFeedback(@NonNull View view, int feedbackConstant, int flags) { view.performHapticFeedback(feedbackConstant, flags); } /** * Perform a vibration using a view and the one-way API * @see View#performHapticFeedback(int feedbackConstant) */ public void performHapticFeedback(@NonNull View view, int feedbackConstant) { view.performHapticFeedback(feedbackConstant); } }