• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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.settingslib.widget.TwoTargetPreference.ICON_SIZE_MEDIUM;
23 
24 import android.accessibilityservice.AccessibilityServiceInfo;
25 import android.app.settings.SettingsEnums;
26 import android.content.ComponentName;
27 import android.content.Context;
28 import android.content.pm.ServiceInfo;
29 import android.graphics.Color;
30 import android.graphics.drawable.Drawable;
31 import android.os.Bundle;
32 import android.text.TextUtils;
33 import android.view.LayoutInflater;
34 import android.view.View;
35 import android.view.ViewGroup;
36 import android.view.accessibility.AccessibilityManager;
37 
38 import androidx.annotation.VisibleForTesting;
39 import androidx.preference.Preference;
40 import androidx.recyclerview.widget.RecyclerView;
41 
42 import com.android.settings.R;
43 import com.android.settings.dashboard.DashboardFragment;
44 import com.android.settingslib.RestrictedPreference;
45 
46 import com.google.android.setupcompat.template.FooterBarMixin;
47 import com.google.android.setupdesign.GlifPreferenceLayout;
48 
49 import java.util.List;
50 
51 /**
52  * Activity with the accessibility settings specific to Setup Wizard.
53  */
54 public class AccessibilitySettingsForSetupWizard extends DashboardFragment
55         implements Preference.OnPreferenceChangeListener {
56     private static final String TAG = "AccessibilitySettingsForSetupWizard";
57 
58     // Preferences.
59     private static final String DISPLAY_MAGNIFICATION_PREFERENCE =
60             "screen_magnification_preference";
61     private static final String SCREEN_READER_PREFERENCE = "screen_reader_preference";
62     private static final String SELECT_TO_SPEAK_PREFERENCE = "select_to_speak_preference";
63 
64     // Package names and service names used to identify screen reader and SelectToSpeak services.
65     @VisibleForTesting
66     static final String SCREEN_READER_PACKAGE_NAME = "com.google.android.marvin.talkback";
67     @VisibleForTesting
68     static final String SCREEN_READER_SERVICE_NAME =
69             "com.google.android.marvin.talkback.TalkBackService";
70     @VisibleForTesting
71     static final String SELECT_TO_SPEAK_PACKAGE_NAME = "com.google.android.marvin.talkback";
72     @VisibleForTesting
73     static final String SELECT_TO_SPEAK_SERVICE_NAME =
74             "com.google.android.accessibility.selecttospeak.SelectToSpeakService";
75 
76     // Preference controls.
77     protected Preference mDisplayMagnificationPreference;
78     protected RestrictedPreference mScreenReaderPreference;
79     protected RestrictedPreference mSelectToSpeakPreference;
80 
81     @Override
getMetricsCategory()82     public int getMetricsCategory() {
83         return SettingsEnums.SUW_ACCESSIBILITY;
84     }
85 
86     @Override
onViewCreated(View view, Bundle savedInstanceState)87     public void onViewCreated(View view, Bundle savedInstanceState) {
88         super.onViewCreated(view, savedInstanceState);
89 
90         if (view instanceof GlifPreferenceLayout) {
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                     () -> {
101                         setResult(RESULT_CANCELED);
102                         finish();
103                     });
104         }
105     }
106 
107     @Override
onCreateRecyclerView(LayoutInflater inflater, ViewGroup parent, Bundle savedInstanceState)108     public RecyclerView onCreateRecyclerView(LayoutInflater inflater, ViewGroup parent,
109             Bundle savedInstanceState) {
110         if (parent instanceof GlifPreferenceLayout) {
111             final GlifPreferenceLayout layout = (GlifPreferenceLayout) parent;
112             return layout.onCreateRecyclerView(inflater, parent, savedInstanceState);
113         }
114         return super.onCreateRecyclerView(inflater, parent, savedInstanceState);
115     }
116 
117     @Override
onCreate(Bundle icicle)118     public void onCreate(Bundle icicle) {
119         super.onCreate(icicle);
120         mDisplayMagnificationPreference = findPreference(DISPLAY_MAGNIFICATION_PREFERENCE);
121         mScreenReaderPreference = findPreference(SCREEN_READER_PREFERENCE);
122         mSelectToSpeakPreference = findPreference(SELECT_TO_SPEAK_PREFERENCE);
123     }
124 
125     @Override
onResume()126     public void onResume() {
127         super.onResume();
128         updateAccessibilityServicePreference(mScreenReaderPreference,
129                 SCREEN_READER_PACKAGE_NAME, SCREEN_READER_SERVICE_NAME);
130         updateAccessibilityServicePreference(mSelectToSpeakPreference,
131                 SELECT_TO_SPEAK_PACKAGE_NAME, SELECT_TO_SPEAK_SERVICE_NAME);
132         configureMagnificationPreferenceIfNeeded(mDisplayMagnificationPreference);
133     }
134 
135     @Override
onActivityCreated(Bundle savedInstanceState)136     public void onActivityCreated(Bundle savedInstanceState) {
137         super.onActivityCreated(savedInstanceState);
138         setHasOptionsMenu(false);
139     }
140 
141     @Override
onPreferenceChange(Preference preference, Object newValue)142     public boolean onPreferenceChange(Preference preference, Object newValue) {
143         return false;
144     }
145 
146     @Override
onPreferenceTreeClick(Preference preference)147     public boolean onPreferenceTreeClick(Preference preference) {
148         if (mDisplayMagnificationPreference == preference) {
149             Bundle extras = mDisplayMagnificationPreference.getExtras();
150             extras.putBoolean(AccessibilitySettings.EXTRA_LAUNCHED_FROM_SUW, true);
151         }
152 
153         return super.onPreferenceTreeClick(preference);
154     }
155 
156     @Override
getPreferenceScreenResId()157     protected int getPreferenceScreenResId() {
158         return R.xml.accessibility_settings_for_setup_wizard;
159     }
160 
161     @Override
getLogTag()162     protected String getLogTag() {
163         return TAG;
164     }
165 
166     /**
167      * Returns accessibility service info by given package name and service name.
168      *
169      * @param packageName Package of accessibility service
170      * @param serviceName Class of accessibility service
171      * @return {@link AccessibilityServiceInfo} instance if available, null otherwise.
172      */
findService(String packageName, String serviceName)173     private AccessibilityServiceInfo findService(String packageName, String serviceName) {
174         final AccessibilityManager manager =
175                 getActivity().getSystemService(AccessibilityManager.class);
176         final List<AccessibilityServiceInfo> accessibilityServices =
177                 manager.getInstalledAccessibilityServiceList();
178         for (AccessibilityServiceInfo info : accessibilityServices) {
179             ServiceInfo serviceInfo = info.getResolveInfo().serviceInfo;
180             if (TextUtils.equals(packageName, serviceInfo.packageName)
181                     && TextUtils.equals(serviceName, serviceInfo.name)) {
182                 return info;
183             }
184         }
185 
186         return null;
187     }
188 
updateAccessibilityServicePreference(RestrictedPreference preference, String packageName, String serviceName)189     private void updateAccessibilityServicePreference(RestrictedPreference preference,
190             String packageName, String serviceName) {
191         final AccessibilityServiceInfo info = findService(packageName, serviceName);
192         if (info == null) {
193             getPreferenceScreen().removePreference(preference);
194             return;
195         }
196 
197         final ServiceInfo serviceInfo = info.getResolveInfo().serviceInfo;
198         final Drawable icon = info.getResolveInfo().loadIcon(getPackageManager());
199         preference.setIcon(getAdaptiveIcon(getContext(), icon, Color.WHITE));
200         preference.setIconSize(ICON_SIZE_MEDIUM);
201         final String title = info.getResolveInfo().loadLabel(getPackageManager()).toString();
202         preference.setTitle(title);
203         final ComponentName componentName =
204                 new ComponentName(serviceInfo.packageName, serviceInfo.name);
205         preference.setKey(componentName.flattenToString());
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