1 /* 2 * Copyright (C) 2015 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.settings.accessibility; 18 19 import static android.app.Activity.RESULT_CANCELED; 20 21 import static com.android.settings.Utils.getAdaptiveIcon; 22 import static com.android.settings.accessibility.AccessibilityUtil.AccessibilityServiceFragmentType.VOLUME_SHORTCUT_TOGGLE; 23 import static com.android.settingslib.widget.TwoTargetPreference.ICON_SIZE_MEDIUM; 24 25 import android.accessibilityservice.AccessibilityServiceInfo; 26 import android.app.settings.SettingsEnums; 27 import android.content.ComponentName; 28 import android.content.Context; 29 import android.content.pm.ServiceInfo; 30 import android.graphics.Color; 31 import android.graphics.drawable.Drawable; 32 import android.os.Bundle; 33 import android.text.TextUtils; 34 import android.view.LayoutInflater; 35 import android.view.View; 36 import android.view.ViewGroup; 37 import android.view.accessibility.AccessibilityManager; 38 39 import androidx.annotation.VisibleForTesting; 40 import androidx.preference.Preference; 41 import androidx.recyclerview.widget.RecyclerView; 42 43 import com.android.settings.R; 44 import com.android.settings.dashboard.DashboardFragment; 45 import com.android.settingslib.RestrictedPreference; 46 47 import com.google.android.setupcompat.template.FooterBarMixin; 48 import com.google.android.setupdesign.GlifPreferenceLayout; 49 50 import java.util.List; 51 52 /** 53 * Activity with the accessibility settings specific to Setup Wizard. 54 */ 55 public class AccessibilitySettingsForSetupWizard extends DashboardFragment 56 implements Preference.OnPreferenceChangeListener { 57 private static final String TAG = "AccessibilitySettingsForSetupWizard"; 58 59 // Preferences. 60 private static final String DISPLAY_MAGNIFICATION_PREFERENCE = 61 "screen_magnification_preference"; 62 private static final String SCREEN_READER_PREFERENCE = "screen_reader_preference"; 63 private static final String SELECT_TO_SPEAK_PREFERENCE = "select_to_speak_preference"; 64 65 // Package names and service names used to identify screen reader and SelectToSpeak services. 66 @VisibleForTesting 67 static final String SCREEN_READER_PACKAGE_NAME = "com.google.android.marvin.talkback"; 68 @VisibleForTesting 69 static final String SCREEN_READER_SERVICE_NAME = 70 "com.google.android.marvin.talkback.TalkBackService"; 71 @VisibleForTesting 72 static final String SELECT_TO_SPEAK_PACKAGE_NAME = "com.google.android.marvin.talkback"; 73 @VisibleForTesting 74 static final String SELECT_TO_SPEAK_SERVICE_NAME = 75 "com.google.android.accessibility.selecttospeak.SelectToSpeakService"; 76 77 // Preference controls. 78 protected Preference mDisplayMagnificationPreference; 79 protected RestrictedPreference mScreenReaderPreference; 80 protected RestrictedPreference mSelectToSpeakPreference; 81 82 @Override getMetricsCategory()83 public int getMetricsCategory() { 84 return SettingsEnums.SUW_ACCESSIBILITY; 85 } 86 87 @Override onViewCreated(View view, Bundle savedInstanceState)88 public void onViewCreated(View view, Bundle savedInstanceState) { 89 super.onViewCreated(view, savedInstanceState); 90 91 final GlifPreferenceLayout layout = (GlifPreferenceLayout) view; 92 final String title = getContext().getString(R.string.vision_settings_title); 93 final String description = getContext().getString(R.string.vision_settings_description); 94 final Drawable icon = getContext().getDrawable(R.drawable.ic_accessibility_visibility); 95 AccessibilitySetupWizardUtils.updateGlifPreferenceLayout(getContext(), layout, title, 96 description, icon); 97 98 final FooterBarMixin mixin = layout.getMixin(FooterBarMixin.class); 99 AccessibilitySetupWizardUtils.setPrimaryButton(getContext(), mixin, R.string.done, () -> { 100 setResult(RESULT_CANCELED); 101 finish(); 102 }); 103 } 104 105 @Override onCreateRecyclerView(LayoutInflater inflater, ViewGroup parent, Bundle savedInstanceState)106 public RecyclerView onCreateRecyclerView(LayoutInflater inflater, ViewGroup parent, 107 Bundle savedInstanceState) { 108 final GlifPreferenceLayout layout = (GlifPreferenceLayout) parent; 109 return layout.onCreateRecyclerView(inflater, parent, savedInstanceState); 110 } 111 112 @Override onCreate(Bundle icicle)113 public void onCreate(Bundle icicle) { 114 super.onCreate(icicle); 115 mDisplayMagnificationPreference = findPreference(DISPLAY_MAGNIFICATION_PREFERENCE); 116 mScreenReaderPreference = findPreference(SCREEN_READER_PREFERENCE); 117 mSelectToSpeakPreference = findPreference(SELECT_TO_SPEAK_PREFERENCE); 118 } 119 120 @Override onResume()121 public void onResume() { 122 super.onResume(); 123 updateAccessibilityServicePreference(mScreenReaderPreference, 124 SCREEN_READER_PACKAGE_NAME, SCREEN_READER_SERVICE_NAME, 125 VolumeShortcutToggleScreenReaderPreferenceFragmentForSetupWizard.class.getName()); 126 updateAccessibilityServicePreference(mSelectToSpeakPreference, 127 SELECT_TO_SPEAK_PACKAGE_NAME, SELECT_TO_SPEAK_SERVICE_NAME, 128 VolumeShortcutToggleSelectToSpeakPreferenceFragmentForSetupWizard.class.getName()); 129 configureMagnificationPreferenceIfNeeded(mDisplayMagnificationPreference); 130 } 131 132 @Override onActivityCreated(Bundle savedInstanceState)133 public void onActivityCreated(Bundle savedInstanceState) { 134 super.onActivityCreated(savedInstanceState); 135 setHasOptionsMenu(false); 136 } 137 138 @Override onPreferenceChange(Preference preference, Object newValue)139 public boolean onPreferenceChange(Preference preference, Object newValue) { 140 return false; 141 } 142 143 @Override onPreferenceTreeClick(Preference preference)144 public boolean onPreferenceTreeClick(Preference preference) { 145 if (mDisplayMagnificationPreference == preference) { 146 Bundle extras = mDisplayMagnificationPreference.getExtras(); 147 extras.putBoolean(AccessibilitySettings.EXTRA_LAUNCHED_FROM_SUW, true); 148 } 149 150 return super.onPreferenceTreeClick(preference); 151 } 152 153 @Override getPreferenceScreenResId()154 protected int getPreferenceScreenResId() { 155 return R.xml.accessibility_settings_for_setup_wizard; 156 } 157 158 @Override getLogTag()159 protected String getLogTag() { 160 return TAG; 161 } 162 163 /** 164 * Returns accessibility service info by given package name and service name. 165 * 166 * @param packageName Package of accessibility service 167 * @param serviceName Class of accessibility service 168 * @return {@link AccessibilityServiceInfo} instance if available, null otherwise. 169 */ findService(String packageName, String serviceName)170 private AccessibilityServiceInfo findService(String packageName, String serviceName) { 171 final AccessibilityManager manager = 172 getActivity().getSystemService(AccessibilityManager.class); 173 final List<AccessibilityServiceInfo> accessibilityServices = 174 manager.getInstalledAccessibilityServiceList(); 175 for (AccessibilityServiceInfo info : accessibilityServices) { 176 ServiceInfo serviceInfo = info.getResolveInfo().serviceInfo; 177 if (TextUtils.equals(packageName, serviceInfo.packageName) 178 && TextUtils.equals(serviceName, serviceInfo.name)) { 179 return info; 180 } 181 } 182 183 return null; 184 } 185 updateAccessibilityServicePreference(RestrictedPreference preference, String packageName, String serviceName, String targetFragment)186 private void updateAccessibilityServicePreference(RestrictedPreference preference, 187 String packageName, String serviceName, String targetFragment) { 188 final AccessibilityServiceInfo info = findService(packageName, serviceName); 189 if (info == null) { 190 getPreferenceScreen().removePreference(preference); 191 return; 192 } 193 194 final ServiceInfo serviceInfo = info.getResolveInfo().serviceInfo; 195 final Drawable icon = info.getResolveInfo().loadIcon(getPackageManager()); 196 preference.setIcon(getAdaptiveIcon(getContext(), icon, Color.WHITE)); 197 preference.setIconSize(ICON_SIZE_MEDIUM); 198 final String title = info.getResolveInfo().loadLabel(getPackageManager()).toString(); 199 preference.setTitle(title); 200 final ComponentName componentName = 201 new ComponentName(serviceInfo.packageName, serviceInfo.name); 202 preference.setKey(componentName.flattenToString()); 203 if (AccessibilityUtil.getAccessibilityServiceFragmentType(info) == VOLUME_SHORTCUT_TOGGLE) { 204 preference.setFragment(targetFragment); 205 } 206 207 // Update the extras. 208 final Bundle extras = preference.getExtras(); 209 extras.putParcelable(AccessibilitySettings.EXTRA_COMPONENT_NAME, componentName); 210 211 extras.putString(AccessibilitySettings.EXTRA_PREFERENCE_KEY, 212 preference.getKey()); 213 extras.putString(AccessibilitySettings.EXTRA_TITLE, title); 214 215 final String description = info.loadDescription(getPackageManager()); 216 extras.putString(AccessibilitySettings.EXTRA_SUMMARY, description); 217 218 extras.putInt(AccessibilitySettings.EXTRA_ANIMATED_IMAGE_RES, info.getAnimatedImageRes()); 219 220 final String htmlDescription = info.loadHtmlDescription(getPackageManager()); 221 extras.putString(AccessibilitySettings.EXTRA_HTML_DESCRIPTION, htmlDescription); 222 } 223 configureMagnificationPreferenceIfNeeded(Preference preference)224 private static void configureMagnificationPreferenceIfNeeded(Preference preference) { 225 final Context context = preference.getContext(); 226 preference.setFragment( 227 ToggleScreenMagnificationPreferenceFragmentForSetupWizard.class.getName()); 228 final Bundle extras = preference.getExtras(); 229 MagnificationGesturesPreferenceController 230 .populateMagnificationGesturesPreferenceExtras(extras, context); 231 } 232 } 233