app_Settings/src/com/android/settings/gestures/OneHandedSettingsUtils.java

/*
 * Copyright (C) 2020 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 com.android.settings.gestures;

import android.content.ContentResolver;
import android.content.Context;
import android.database.ContentObserver;
import android.net.Uri;
import android.os.Handler;
import android.os.Looper;
import android.provider.Settings;

/**
 * The Util to query one-handed mode settings config
 */
public class OneHandedSettingsUtils {

    public enum OneHandedTimeout {
        NEVER(0), SHORT(4), MEDIUM(8), LONG(12);

        private final int mValue;

        OneHandedTimeout(int value) {
            this.mValue = value;
        }

        public int getValue() {
            return mValue;
        }
    }

    private final Context mContext;
    private final SettingsObserver mSettingsObserver;

    OneHandedSettingsUtils(Context context) {
        mContext = context;
        mSettingsObserver = new SettingsObserver(new Handler(Looper.getMainLooper()));
    }

    /**
     * Get one-handed mode enable or disable flag from Settings provider.
     *
     * @param context App context
     * @return enable or disable one-handed mode flag.
     */
    public static boolean isOneHandedModeEnabled(Context context) {
        return Settings.Secure.getInt(context.getContentResolver(),
                Settings.Secure.ONE_HANDED_MODE_ENABLED, 0) == 1;
    }

    /**
     * Set one-handed mode enable or disable flag to Settings provider.
     *
     * @param context App context
     * @param enable enable or disable one-handed mode.
     */
    public static void setSettingsOneHandedModeEnabled(Context context, boolean enable) {
        Settings.Secure.putInt(context.getContentResolver(),
                Settings.Secure.ONE_HANDED_MODE_ENABLED, enable ? 1 : 0);
    }

    /**
     * Get enabling taps app to exit one-handed mode flag from Settings provider.
     *
     * @param context App context
     * @return enable or disable taps app to exit.
     */
    public static boolean getSettingsTapsAppToExit(Context context) {
        return Settings.Secure.getInt(context.getContentResolver(),
                Settings.Secure.TAPS_APP_TO_EXIT, 1) == 1;
    }

    /**
     * Set enabling taps app to exit one-handed mode flag to Settings provider.
     *
     * @param context App context
     * @param enable  enable or disable when taping app to exit one-handed mode.
     */
    public static boolean setSettingsTapsAppToExit(Context context, boolean enable) {
        return Settings.Secure.putInt(context.getContentResolver(),
                Settings.Secure.TAPS_APP_TO_EXIT, enable ? 1 : 0);
    }

    /**
     * Get one-handed mode timeout value from Settings provider.
     *
     * @param context App context
     * @return timeout value in seconds.
     */
    public static int getSettingsOneHandedModeTimeout(Context context) {
        return Settings.Secure.getInt(context.getContentResolver(),
                Settings.Secure.ONE_HANDED_MODE_TIMEOUT,
                OneHandedTimeout.MEDIUM.getValue() /* default MEDIUM(8) by UX */);
    }

    /**
     * Set one-handed mode timeout value to Settings provider.
     *
     * @param context App context
     * @param timeout timeout in seconds for exiting one-handed mode.
     */
    public static void setSettingsOneHandedModeTimeout(Context context, int timeout) {
        Settings.Secure.putInt(context.getContentResolver(),
                Settings.Secure.ONE_HANDED_MODE_TIMEOUT, timeout);
    }

    /**
     * Register callback for observing Settings.Secure.ONE_HANDED_MODE_ENABLED state.
     * @param callback for state changes
     */
    public void registerToggleAwareObserver(TogglesCallback callback) {
        mSettingsObserver.observe();
        mSettingsObserver.setCallback(callback);
    }

    /**
     * Unregister callback for observing Settings.Secure.ONE_HANDED_MODE_ENABLED state.
     */
    public void unregisterToggleAwareObserver() {
        final ContentResolver resolver = mContext.getContentResolver();
        resolver.unregisterContentObserver(mSettingsObserver);
    }

    private final class SettingsObserver extends ContentObserver {
        private TogglesCallback mCallback;

        private final Uri mOneHandedEnabledAware = Settings.Secure.getUriFor(
                Settings.Secure.ONE_HANDED_MODE_ENABLED);

        SettingsObserver(Handler handler) {
            super(handler);
        }

        private void setCallback(TogglesCallback callback) {
            mCallback = callback;
        }

        public void observe() {
            final ContentResolver resolver = mContext.getContentResolver();
            resolver.registerContentObserver(mOneHandedEnabledAware, true, this);
        }

        @Override
        public void onChange(boolean selfChange, Uri uri) {
            if (mCallback != null) mCallback.onChange(uri);
        }
    }

    /**
     * An interface for when Settings.Secure key state changes.
     */
    public interface TogglesCallback {
        /**
         * Callback method for Settings.Secure key state changes.
         * @param uri
         */
        void onChange(Uri uri);
    }
}