/* * Copyright (C) 2009 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 android.view.accessibility; import android.accessibilityservice.AccessibilityServiceInfo; import android.annotation.NonNull; import android.content.Context; import android.content.pm.ServiceInfo; import android.view.IWindow; import android.view.View; import java.util.Collections; import java.util.List; /** * System level service that serves as an event dispatch for {@link AccessibilityEvent}s. * Such events are generated when something notable happens in the user interface, * for example an {@link android.app.Activity} starts, the focus or selection of a * {@link android.view.View} changes etc. Parties interested in handling accessibility * events implement and register an accessibility service which extends * {@code android.accessibilityservice.AccessibilityService}. * * @see AccessibilityEvent * @see android.content.Context#getSystemService */ @SuppressWarnings("UnusedDeclaration") public final class AccessibilityManager { private static AccessibilityManager sInstance = new AccessibilityManager(null, null, 0); /** * Listener for the accessibility state. */ public interface AccessibilityStateChangeListener { /** * Called back on change in the accessibility state. * * @param enabled Whether accessibility is enabled. */ public void onAccessibilityStateChanged(boolean enabled); } /** * Listener for the system touch exploration state. To listen for changes to * the touch exploration state on the device, implement this interface and * register it with the system by calling * {@link #addTouchExplorationStateChangeListener}. */ public interface TouchExplorationStateChangeListener { /** * Called when the touch exploration enabled state changes. * * @param enabled Whether touch exploration is enabled. */ public void onTouchExplorationStateChanged(boolean enabled); } /** * Listener for the system high text contrast state. To listen for changes to * the high text contrast state on the device, implement this interface and * register it with the system by calling * {@link #addHighTextContrastStateChangeListener}. */ public interface HighTextContrastChangeListener { /** * Called when the high text contrast enabled state changes. * * @param enabled Whether high text contrast is enabled. */ public void onHighTextContrastStateChanged(boolean enabled); } private final IAccessibilityManagerClient.Stub mClient = new IAccessibilityManagerClient.Stub() { public void setState(int state) { } public void notifyServicesStateChanged() { } public void setRelevantEventTypes(int eventTypes) { } }; /** * Get an AccessibilityManager instance (create one if necessary). * */ public static AccessibilityManager getInstance(Context context) { return sInstance; } /** * Create an instance. * * @param context A {@link Context}. */ public AccessibilityManager(Context context, IAccessibilityManager service, int userId) { } public IAccessibilityManagerClient getClient() { return mClient; } /** * Returns if the {@link AccessibilityManager} is enabled. * * @return True if this {@link AccessibilityManager} is enabled, false otherwise. */ public boolean isEnabled() { return false; } /** * Returns if the touch exploration in the system is enabled. * * @return True if touch exploration is enabled, false otherwise. */ public boolean isTouchExplorationEnabled() { return true; } /** * Returns if the high text contrast in the system is enabled. *

* Note: You need to query this only if you application is * doing its own rendering and does not rely on the platform rendering pipeline. *

* */ public boolean isHighTextContrastEnabled() { return false; } /** * Sends an {@link AccessibilityEvent}. */ public void sendAccessibilityEvent(AccessibilityEvent event) { } /** * Requests interruption of the accessibility feedback from all accessibility services. */ public void interrupt() { } /** * Returns the {@link ServiceInfo}s of the installed accessibility services. * * @return An unmodifiable list with {@link ServiceInfo}s. */ @Deprecated public List getAccessibilityServiceList() { return Collections.emptyList(); } public List getInstalledAccessibilityServiceList() { return Collections.emptyList(); } /** * Returns the {@link AccessibilityServiceInfo}s of the enabled accessibility services * for a given feedback type. * * @param feedbackTypeFlags The feedback type flags. * @return An unmodifiable list with {@link AccessibilityServiceInfo}s. * * @see AccessibilityServiceInfo#FEEDBACK_AUDIBLE * @see AccessibilityServiceInfo#FEEDBACK_GENERIC * @see AccessibilityServiceInfo#FEEDBACK_HAPTIC * @see AccessibilityServiceInfo#FEEDBACK_SPOKEN * @see AccessibilityServiceInfo#FEEDBACK_VISUAL */ public List getEnabledAccessibilityServiceList( int feedbackTypeFlags) { return Collections.emptyList(); } /** * Registers an {@link AccessibilityStateChangeListener} for changes in * the global accessibility state of the system. * * @param listener The listener. * @return True if successfully registered. */ public boolean addAccessibilityStateChangeListener( AccessibilityStateChangeListener listener) { return true; } public boolean removeAccessibilityStateChangeListener( AccessibilityStateChangeListener listener) { return true; } /** * Registers a {@link TouchExplorationStateChangeListener} for changes in * the global touch exploration state of the system. * * @param listener The listener. * @return True if successfully registered. */ public boolean addTouchExplorationStateChangeListener( @NonNull TouchExplorationStateChangeListener listener) { return true; } /** * Unregisters a {@link TouchExplorationStateChangeListener}. * * @param listener The listener. * @return True if successfully unregistered. */ public boolean removeTouchExplorationStateChangeListener( @NonNull TouchExplorationStateChangeListener listener) { return true; } /** * Registers a {@link HighTextContrastChangeListener} for changes in * the global high text contrast state of the system. * * @param listener The listener. * @return True if successfully registered. * */ public boolean addHighTextContrastStateChangeListener( @NonNull HighTextContrastChangeListener listener) { return true; } /** * Unregisters a {@link HighTextContrastChangeListener}. * * @param listener The listener. * @return True if successfully unregistered. * */ public boolean removeHighTextContrastStateChangeListener( @NonNull HighTextContrastChangeListener listener) { return true; } /** * Sets the current state and notifies listeners, if necessary. * * @param stateFlags The state flags. */ private void setStateLocked(int stateFlags) { } public int addAccessibilityInteractionConnection(IWindow windowToken, IAccessibilityInteractionConnection connection) { return View.NO_ID; } public void removeAccessibilityInteractionConnection(IWindow windowToken) { } }