1 /* 2 * Copyright (C) 2012 The Android Open Source Project 3 * 4 * Licensed under the Apache License, Version 2.0 (the "License"); 5 * you may not use this file except in compliance with the License. 6 * You may obtain a copy of the License at 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * Unless required by applicable law or agreed to in writing, software 11 * distributed under the License is distributed on an "AS IS" BASIS, 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13 * See the License for the specific language governing permissions and 14 * limitations under the License. 15 */ 16 17 package com.android.inputmethod.latin; 18 19 import com.android.inputmethod.latin.settings.SettingsValues; 20 21 import android.content.Context; 22 import android.media.AudioManager; 23 import android.os.Vibrator; 24 import android.view.HapticFeedbackConstants; 25 import android.view.View; 26 27 /** 28 * This class gathers audio feedback and haptic feedback functions. 29 * 30 * It offers a consistent and simple interface that allows LatinIME to forget about the 31 * complexity of settings and the like. 32 */ 33 public final class AudioAndHapticFeedbackManager { 34 private AudioManager mAudioManager; 35 private Vibrator mVibrator; 36 37 private SettingsValues mSettingsValues; 38 private boolean mSoundOn; 39 40 private static final AudioAndHapticFeedbackManager sInstance = 41 new AudioAndHapticFeedbackManager(); 42 getInstance()43 public static AudioAndHapticFeedbackManager getInstance() { 44 return sInstance; 45 } 46 AudioAndHapticFeedbackManager()47 private AudioAndHapticFeedbackManager() { 48 // Intentional empty constructor for singleton. 49 } 50 init(final Context context)51 public static void init(final Context context) { 52 sInstance.initInternal(context); 53 } 54 initInternal(final Context context)55 private void initInternal(final Context context) { 56 mAudioManager = (AudioManager) context.getSystemService(Context.AUDIO_SERVICE); 57 mVibrator = (Vibrator) context.getSystemService(Context.VIBRATOR_SERVICE); 58 } 59 performHapticAndAudioFeedback(final int code, final View viewToPerformHapticFeedbackOn)60 public void performHapticAndAudioFeedback(final int code, 61 final View viewToPerformHapticFeedbackOn) { 62 performHapticFeedback(viewToPerformHapticFeedbackOn); 63 performAudioFeedback(code); 64 } 65 hasVibrator()66 public boolean hasVibrator() { 67 return mVibrator != null && mVibrator.hasVibrator(); 68 } 69 vibrate(final long milliseconds)70 public void vibrate(final long milliseconds) { 71 if (mVibrator == null) { 72 return; 73 } 74 mVibrator.vibrate(milliseconds); 75 } 76 reevaluateIfSoundIsOn()77 private boolean reevaluateIfSoundIsOn() { 78 if (mSettingsValues == null || !mSettingsValues.mSoundOn || mAudioManager == null) { 79 return false; 80 } 81 return mAudioManager.getRingerMode() == AudioManager.RINGER_MODE_NORMAL; 82 } 83 performAudioFeedback(final int code)84 public void performAudioFeedback(final int code) { 85 // if mAudioManager is null, we can't play a sound anyway, so return 86 if (mAudioManager == null) { 87 return; 88 } 89 if (mSoundOn) { 90 final int sound; 91 switch (code) { 92 case Constants.CODE_DELETE: 93 sound = AudioManager.FX_KEYPRESS_DELETE; 94 break; 95 case Constants.CODE_ENTER: 96 sound = AudioManager.FX_KEYPRESS_RETURN; 97 break; 98 case Constants.CODE_SPACE: 99 sound = AudioManager.FX_KEYPRESS_SPACEBAR; 100 break; 101 default: 102 sound = AudioManager.FX_KEYPRESS_STANDARD; 103 break; 104 } 105 mAudioManager.playSoundEffect(sound, mSettingsValues.mKeypressSoundVolume); 106 } 107 } 108 performHapticFeedback(final View viewToPerformHapticFeedbackOn)109 public void performHapticFeedback(final View viewToPerformHapticFeedbackOn) { 110 if (!mSettingsValues.mVibrateOn) { 111 return; 112 } 113 if (mSettingsValues.mKeypressVibrationDuration < 0) { 114 // Go ahead with the system default 115 if (viewToPerformHapticFeedbackOn != null) { 116 viewToPerformHapticFeedbackOn.performHapticFeedback( 117 HapticFeedbackConstants.KEYBOARD_TAP, 118 HapticFeedbackConstants.FLAG_IGNORE_GLOBAL_SETTING); 119 } 120 return; 121 } 122 vibrate(mSettingsValues.mKeypressVibrationDuration); 123 } 124 onSettingsChanged(final SettingsValues settingsValues)125 public void onSettingsChanged(final SettingsValues settingsValues) { 126 mSettingsValues = settingsValues; 127 mSoundOn = reevaluateIfSoundIsOn(); 128 } 129 onRingerModeChanged()130 public void onRingerModeChanged() { 131 mSoundOn = reevaluateIfSoundIsOn(); 132 } 133 } 134