/* * Copyright (C) 2018 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.display; import android.content.Context; import android.content.res.Configuration; import android.os.Bundle; import android.os.SystemClock; import android.view.Choreographer; import android.view.LayoutInflater; import android.view.View; import android.view.ViewGroup; import android.view.accessibility.AccessibilityEvent; import android.widget.SeekBar; import android.widget.SeekBar.OnSeekBarChangeListener; import android.widget.TextView; import androidx.viewpager.widget.ViewPager; import androidx.viewpager.widget.ViewPager.OnPageChangeListener; import com.android.settings.R; import com.android.settings.SettingsPreferenceFragment; import com.android.settings.widget.DotsPageIndicator; import com.android.settings.widget.LabeledSeekBar; /** * Preference fragment shows a preview and a seek bar to adjust a specific settings. */ public abstract class PreviewSeekBarPreferenceFragment extends SettingsPreferenceFragment { /** List of entries corresponding the settings being set. */ protected String[] mEntries; /** Index of the entry corresponding to initial value of the settings. */ protected int mInitialIndex; /** Index of the entry corresponding to current value of the settings. */ protected int mCurrentIndex; private ViewPager mPreviewPager; private PreviewPagerAdapter mPreviewPagerAdapter; private DotsPageIndicator mPageIndicator; private TextView mLabel; private LabeledSeekBar mSeekBar; private View mLarger; private View mSmaller; private static final long MIN_COMMIT_INTERVAL_MS = 800; private long mLastCommitTime; private class onPreviewSeekBarChangeListener implements OnSeekBarChangeListener { private static final long CHANGE_BY_SEEKBAR_DELAY_MS = 100; private static final long CHANGE_BY_BUTTON_DELAY_MS = 300; private boolean mSeekByTouch; private boolean mIsChanged; private long mCommitDelayMs; private final Choreographer.FrameCallback mCommit = f -> { commit(); mLastCommitTime = SystemClock.elapsedRealtime(); }; @Override public void onProgressChanged(SeekBar seekBar, int progress, boolean fromUser) { if (mCurrentIndex == progress) { mIsChanged = false; return; } mIsChanged = true; setPreviewLayer(progress, false); if (mSeekByTouch) { mCommitDelayMs = CHANGE_BY_SEEKBAR_DELAY_MS; } else { mCommitDelayMs = CHANGE_BY_BUTTON_DELAY_MS; commitOnNextFrame(); } } @Override public void onStartTrackingTouch(SeekBar seekBar) { mSeekByTouch = true; } @Override public void onStopTrackingTouch(SeekBar seekBar) { mSeekByTouch = false; if (!mIsChanged) { return; } if (mPreviewPagerAdapter.isAnimating()) { mPreviewPagerAdapter.setAnimationEndAction(this::commitOnNextFrame); } else { commitOnNextFrame(); } } private void commitOnNextFrame() { if (SystemClock.elapsedRealtime() - mLastCommitTime < MIN_COMMIT_INTERVAL_MS) { mCommitDelayMs += MIN_COMMIT_INTERVAL_MS; } final Choreographer choreographer = Choreographer.getInstance(); choreographer.removeFrameCallback(mCommit); choreographer.postFrameCallbackDelayed(mCommit, mCommitDelayMs); } } @Override public void onSaveInstanceState(Bundle outState) { super.onSaveInstanceState(outState); outState.putLong("mLastCommitTime", mLastCommitTime); } @Override public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { if (savedInstanceState != null) { mLastCommitTime = savedInstanceState.getLong("mLastCommitTime"); } final View root = super.onCreateView(inflater, container, savedInstanceState); final ViewGroup listContainer = root.findViewById(android.R.id.list_container); listContainer.removeAllViews(); final View content = inflater.inflate(getActivityLayoutResId(), listContainer, false); listContainer.addView(content); mLabel = content.findViewById(R.id.current_label); // The maximum SeekBar value always needs to be non-zero. If there's // only one available value, we'll handle this by disabling the // seek bar. final int max = Math.max(1, mEntries.length - 1); mSeekBar = content.findViewById(R.id.seek_bar); mSeekBar.setLabels(mEntries); mSeekBar.setMax(max); mSmaller = content.findViewById(R.id.smaller); mSmaller.setOnClickListener(v -> { final int progress = mSeekBar.getProgress(); if (progress > 0) { mSeekBar.setProgress(progress - 1, true); } }); mLarger = content.findViewById(R.id.larger); mLarger.setOnClickListener(v -> { final int progress = mSeekBar.getProgress(); if (progress < mSeekBar.getMax()) { mSeekBar.setProgress(progress + 1, true); } }); if (mEntries.length == 1) { // The larger and smaller buttons will be disabled when we call // setPreviewLayer() later in this method. mSeekBar.setEnabled(false); } final Context context = getContext(); final Configuration origConfig = context.getResources().getConfiguration(); final boolean isLayoutRtl = origConfig.getLayoutDirection() == View.LAYOUT_DIRECTION_RTL; Configuration[] configurations = new Configuration[mEntries.length]; for (int i = 0; i < mEntries.length; ++i) { configurations[i] = createConfig(origConfig, i); } final int[] previews = getPreviewSampleResIds(); mPreviewPager = content.findViewById(R.id.preview_pager); mPreviewPagerAdapter = new PreviewPagerAdapter(context, isLayoutRtl, previews, configurations); mPreviewPager.setAdapter(mPreviewPagerAdapter); mPreviewPager.setCurrentItem(isLayoutRtl ? previews.length - 1 : 0); mPreviewPager.addOnPageChangeListener(mPreviewPageChangeListener); mPageIndicator = content.findViewById(R.id.page_indicator); if (previews.length > 1) { mPageIndicator.setViewPager(mPreviewPager); mPageIndicator.setVisibility(View.VISIBLE); mPageIndicator.setOnPageChangeListener(mPageIndicatorPageChangeListener); } else { mPageIndicator.setVisibility(View.GONE); } setPreviewLayer(mInitialIndex, false); return root; } @Override public void onStart() { super.onStart(); // Set SeekBar listener here to avoid onProgressChanged() is called // during onRestoreInstanceState(). mSeekBar.setProgress(mCurrentIndex); mSeekBar.setOnSeekBarChangeListener(new onPreviewSeekBarChangeListener()); } @Override public void onStop() { super.onStop(); mSeekBar.setOnSeekBarChangeListener(null); } /** Resource id of the layout for this preference fragment. */ protected abstract int getActivityLayoutResId(); /** Resource id of the layout that defines the contents inside preview screen. */ protected abstract int[] getPreviewSampleResIds(); /** * Creates new configuration based on the current position of the SeekBar. */ protected abstract Configuration createConfig(Configuration origConfig, int index); /** * Persists the selected value and sends a configuration change. */ protected abstract void commit(); private void setPreviewLayer(int index, boolean animate) { mLabel.setText(mEntries[index]); mSmaller.setEnabled(index > 0); mLarger.setEnabled(index < mEntries.length - 1); setPagerIndicatorContentDescription(mPreviewPager.getCurrentItem()); mPreviewPagerAdapter.setPreviewLayer(index, mCurrentIndex, mPreviewPager.getCurrentItem(), animate); mCurrentIndex = index; } private void setPagerIndicatorContentDescription(int position) { mPageIndicator.setContentDescription( getString(R.string.preview_page_indicator_content_description, position + 1, getPreviewSampleResIds().length)); } private OnPageChangeListener mPreviewPageChangeListener = new OnPageChangeListener() { @Override public void onPageScrollStateChanged(int state) { // Do nothing. } @Override public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) { // Do nothing. } @Override public void onPageSelected(int position) { mPreviewPager.sendAccessibilityEvent(AccessibilityEvent.TYPE_ANNOUNCEMENT); } }; private OnPageChangeListener mPageIndicatorPageChangeListener = new OnPageChangeListener() { @Override public void onPageScrollStateChanged(int state) { // Do nothing. } @Override public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) { // Do nothing. } @Override public void onPageSelected(int position) { setPagerIndicatorContentDescription(position); } }; }