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