/* * Copyright (c) 2021 Auxio Project * MainFragment.kt is part of Auxio. * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . */ package org.oxycblt.auxio import android.os.Bundle import android.view.LayoutInflater import android.view.ViewTreeObserver import android.view.WindowInsets import androidx.activity.OnBackPressedCallback import androidx.core.view.ViewCompat import androidx.core.view.isInvisible import androidx.core.view.isVisible import androidx.core.view.updatePadding import androidx.fragment.app.activityViewModels import androidx.navigation.findNavController import androidx.navigation.fragment.findNavController import com.google.android.material.R as MR import com.google.android.material.bottomsheet.BackportBottomSheetBehavior import com.google.android.material.shape.MaterialShapeDrawable import com.google.android.material.transition.MaterialFadeThrough import com.leinardi.android.speeddial.SpeedDialOverlayLayout import dagger.hilt.android.AndroidEntryPoint import java.lang.reflect.Field import kotlin.math.max import kotlin.math.min import org.oxycblt.auxio.databinding.FragmentMainBinding import org.oxycblt.auxio.detail.DetailViewModel import org.oxycblt.auxio.detail.Show import org.oxycblt.auxio.home.HomeViewModel import org.oxycblt.auxio.home.Outer import org.oxycblt.auxio.list.ListViewModel import org.oxycblt.auxio.music.Music import org.oxycblt.auxio.music.Song import org.oxycblt.auxio.playback.OpenPanel import org.oxycblt.auxio.playback.PlaybackBottomSheetBehavior import org.oxycblt.auxio.playback.PlaybackViewModel import org.oxycblt.auxio.playback.queue.QueueBottomSheetBehavior import org.oxycblt.auxio.ui.DialogAwareNavigationListener import org.oxycblt.auxio.ui.ViewBindingFragment import org.oxycblt.auxio.util.collect import org.oxycblt.auxio.util.collectImmediately import org.oxycblt.auxio.util.context import org.oxycblt.auxio.util.coordinatorLayoutBehavior import org.oxycblt.auxio.util.getAttrColorCompat import org.oxycblt.auxio.util.getDimen import org.oxycblt.auxio.util.lazyReflectedField import org.oxycblt.auxio.util.logD import org.oxycblt.auxio.util.navigateSafe import org.oxycblt.auxio.util.systemBarInsetsCompat import org.oxycblt.auxio.util.unlikelyToBeNull /** * A wrapper around the home fragment that shows the playback fragment and high-level navigation. * * @author Alexander Capehart (OxygenCobalt) */ @AndroidEntryPoint class MainFragment : ViewBindingFragment(), ViewTreeObserver.OnPreDrawListener { private val detailModel: DetailViewModel by activityViewModels() private val homeModel: HomeViewModel by activityViewModels() private val listModel: ListViewModel by activityViewModels() private val playbackModel: PlaybackViewModel by activityViewModels() private var sheetBackCallback: SheetBackPressedCallback? = null private var detailBackCallback: DetailBackPressedCallback? = null private var selectionBackCallback: SelectionBackPressedCallback? = null private var speedDialBackCallback: SpeedDialBackPressedCallback? = null private var selectionNavigationListener: DialogAwareNavigationListener? = null private var lastInsets: WindowInsets? = null private var elevationNormal = 0f override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) enterTransition = MaterialFadeThrough() exitTransition = MaterialFadeThrough() } override fun onCreateBinding(inflater: LayoutInflater) = FragmentMainBinding.inflate(inflater) override fun onBindingCreated(binding: FragmentMainBinding, savedInstanceState: Bundle?) { super.onBindingCreated(binding, savedInstanceState) val playbackSheetBehavior = binding.playbackSheet.coordinatorLayoutBehavior as PlaybackBottomSheetBehavior val queueSheetBehavior = binding.queueSheet.coordinatorLayoutBehavior as QueueBottomSheetBehavior? elevationNormal = binding.context.getDimen(R.dimen.elevation_normal) // Currently all back press callbacks are handled in MainFragment, as it's not guaranteed // that instantiating these callbacks in their respective fragments would result in the // correct order. sheetBackCallback = SheetBackPressedCallback( playbackSheetBehavior = playbackSheetBehavior, queueSheetBehavior = queueSheetBehavior) val detailBackCallback = DetailBackPressedCallback(detailModel).also { detailBackCallback = it } val selectionBackCallback = SelectionBackPressedCallback(listModel).also { selectionBackCallback = it } val speedDialBackCallback = SpeedDialBackPressedCallback(homeModel).also { speedDialBackCallback = it } selectionNavigationListener = DialogAwareNavigationListener(listModel::dropSelection) // --- UI SETUP --- val context = requireActivity() binding.root.setOnApplyWindowInsetsListener { _, insets -> lastInsets = insets insets } // Send meaningful accessibility events for bottom sheets ViewCompat.setAccessibilityPaneTitle( binding.playbackSheet, context.getString(R.string.lbl_playback)) ViewCompat.setAccessibilityPaneTitle( binding.queueSheet, context.getString(R.string.lbl_queue)) if (queueSheetBehavior != null) { // In portrait mode, set up click listeners on the stacked sheets. logD("Configuring stacked bottom sheets") unlikelyToBeNull(binding.queueHandleWrapper).setOnClickListener { playbackModel.openQueue() } } else { // Dual-pane mode, manually style the static queue sheet. logD("Configuring dual-pane bottom sheet") binding.queueSheet.apply { // Emulate the elevated bottom sheet style. background = MaterialShapeDrawable.createWithElevationOverlay(context).apply { fillColor = context.getAttrColorCompat(MR.attr.colorSurface) elevation = context.getDimen(R.dimen.elevation_normal) } // Apply bar insets for the queue's RecyclerView to use. setOnApplyWindowInsetsListener { v, insets -> v.updatePadding(top = insets.systemBarInsetsCompat.top) insets } } } binding.mainScrim.setOnClickListener { homeModel.setSpeedDialOpen(false) } binding.sheetScrim.setOnClickListener { homeModel.setSpeedDialOpen(false) } // --- VIEWMODEL SETUP --- // This has to be done here instead of the playback panel to make sure that it's prioritized // by StateFlow over any detail fragment. // FIXME: This is a consequence of sharing events across several consumers. There has to be // a better way of doing this. collect(detailModel.toShow.flow, ::handleShow) collectImmediately(detailModel.editedPlaylist, detailBackCallback::invalidateEnabled) collectImmediately(homeModel.showOuter.flow, ::handleShowOuter) collectImmediately(homeModel.speedDialOpen, ::handleSpeedDialState) collectImmediately(listModel.selected, selectionBackCallback::invalidateEnabled) collectImmediately(playbackModel.song, ::updateSong) collectImmediately(playbackModel.openPanel.flow, ::handlePanel) } override fun onStart() { super.onStart() val binding = requireBinding() // Once we add the destination change callback, we will receive another initialization call, // so handle that by resetting the flag. requireNotNull(selectionNavigationListener) { "NavigationListener was not available" } .attach(binding.exploreNavHost.findNavController()) // Listener could still reasonably fire even if we clear the binding, attach/detach // our pre-draw listener our listener in onStart/onStop respectively. binding.playbackSheet.viewTreeObserver.addOnPreDrawListener(this@MainFragment) } override fun onResume() { super.onResume() // Override the back pressed listener so we can map back navigation to collapsing // navigation, navigation out of detail views, etc. We have to do this here in // onResume or otherwise the FragmentManager will have precedence. requireActivity().onBackPressedDispatcher.apply { addCallback(viewLifecycleOwner, requireNotNull(speedDialBackCallback)) addCallback(viewLifecycleOwner, requireNotNull(selectionBackCallback)) addCallback(viewLifecycleOwner, requireNotNull(detailBackCallback)) addCallback(viewLifecycleOwner, requireNotNull(sheetBackCallback)) } } override fun onStop() { super.onStop() val binding = requireBinding() requireNotNull(selectionNavigationListener) { "NavigationListener was not available" } .release(binding.exploreNavHost.findNavController()) binding.playbackSheet.viewTreeObserver.removeOnPreDrawListener(this) } override fun onDestroyBinding(binding: FragmentMainBinding) { super.onDestroyBinding(binding) speedDialBackCallback = null sheetBackCallback = null detailBackCallback = null selectionBackCallback = null selectionNavigationListener = null } override fun onPreDraw(): Boolean { // TODO: Due to draw caching even *this* isn't effective enough to avoid the bottom // sheets continually getting stuck. I need something with even more frequent updates, // or otherwise bottom sheets get stuck. // We overload CoordinatorLayout far too much to rely on any of it's typical // listener functionality. Just update all transitions before every draw. Should // probably be cheap enough. val binding = requireBinding() val playbackSheetBehavior = binding.playbackSheet.coordinatorLayoutBehavior as PlaybackBottomSheetBehavior val queueSheetBehavior = binding.queueSheet.coordinatorLayoutBehavior as QueueBottomSheetBehavior? val playbackRatio = max(playbackSheetBehavior.calculateSlideOffset(), 0f) if (playbackRatio > 0f && homeModel.speedDialOpen.value) { // Stupid hack to prevent you from sliding the sheet up without closing the speed // dial. Filtering out ACTION_MOVE events will cause back gestures to close the speed // dial, which is super finicky behavior. homeModel.setSpeedDialOpen(false) } val outPlaybackRatio = 1 - playbackRatio val halfOutRatio = min(playbackRatio * 2, 1f) val halfInPlaybackRatio = max(playbackRatio - 0.5f, 0f) * 2 if (queueSheetBehavior != null) { // Queue sheet available, the normal transition applies, but it now much be combined // with another transition where the playback panel disappears and the playback bar // appears as the queue sheet expands. val queueRatio = max(queueSheetBehavior.calculateSlideOffset(), 0f) val halfOutQueueRatio = min(queueRatio * 2, 1f) val halfInQueueRatio = max(queueRatio - 0.5f, 0f) * 2 binding.playbackBarFragment.alpha = max(1 - halfOutRatio, halfInQueueRatio) binding.playbackPanelFragment.alpha = min(halfInPlaybackRatio, 1 - halfOutQueueRatio) binding.queueFragment.alpha = queueRatio if (playbackModel.song.value != null) { // Playback sheet intercepts queue sheet touch events, prevent that from // occurring by disabling dragging whenever the queue sheet is expanded. playbackSheetBehavior.isDraggable = queueSheetBehavior.state == BackportBottomSheetBehavior.STATE_COLLAPSED } } else { // No queue sheet, fade normally based on the playback sheet binding.playbackBarFragment.alpha = 1 - halfOutRatio binding.playbackPanelFragment.alpha = halfInPlaybackRatio } // Fade out the content as the playback panel expands. // TODO: Replace with shadow? binding.exploreNavHost.apply { alpha = outPlaybackRatio // Prevent interactions when the content fully fades out. isInvisible = alpha == 0f } // Reduce playback sheet elevation as it expands. This involves both updating the // shadow elevation for older versions, and fading out the background drawable // containing the elevation overlay. binding.playbackSheet.translationZ = elevationNormal * outPlaybackRatio playbackSheetBehavior.sheetBackgroundDrawable.alpha = (outPlaybackRatio * 255).toInt() // Fade out the playback bar as the panel expands. binding.playbackBarFragment.apply { // Prevent interactions when the playback bar fully fades out. isInvisible = alpha == 0f // As the playback bar expands, we also want to subtly translate the bar to // align with the top inset. This results in both a smooth transition from the bar // to the playback panel's toolbar, but also a correctly positioned playback bar // for when the queue sheet expands. lastInsets?.let { translationY = it.systemBarInsetsCompat.top * halfOutRatio } } // Prevent interactions when the playback panel fully fades out. binding.playbackPanelFragment.isInvisible = binding.playbackPanelFragment.alpha == 0f binding.queueSheet.apply { // Queue sheet (not queue content) should fade out with the playback panel. alpha = halfInPlaybackRatio // Prevent interactions when the queue sheet fully fades out. binding.queueSheet.isInvisible = alpha == 0f } // Prevent interactions when the queue content fully fades out. binding.queueFragment.isInvisible = binding.queueFragment.alpha == 0f if (playbackModel.song.value == null) { // Sometimes lingering drags can un-hide the playback sheet even when we intend to // hide it, make sure we keep it hidden. tryHideAllSheets() } // Since the navigation listener is also reliant on the bottom sheets, we must also update // it every frame. requireNotNull(sheetBackCallback) { "SheetBackPressedCallback was not available" } .invalidateEnabled() return true } private fun handleShow(show: Show?) { when (show) { is Show.SongAlbumDetails, is Show.ArtistDetails, is Show.AlbumDetails -> playbackModel.openMain() is Show.SongDetails, is Show.SongArtistDecision, is Show.AlbumArtistDecision, is Show.GenreDetails, is Show.PlaylistDetails, null -> {} } } private fun handleShowOuter(outer: Outer?) { val directions = when (outer) { is Outer.Settings -> MainFragmentDirections.preferences() is Outer.About -> MainFragmentDirections.about() null -> return } findNavController().navigateSafe(directions) homeModel.showOuter.consume() } private fun handleSpeedDialState(open: Boolean) { requireNotNull(speedDialBackCallback) { "SpeedDialBackPressedCallback was not available" } .invalidateEnabled(open) requireBinding().mainScrim.isVisible = open requireBinding().sheetScrim.isVisible = open } private fun updateSong(song: Song?) { if (song != null) { tryShowSheets() } else { tryHideAllSheets() } } private fun handlePanel(panel: OpenPanel?) { if (panel == null) return logD("Trying to update panel to $panel") when (panel) { OpenPanel.MAIN -> tryClosePlaybackPanel() OpenPanel.PLAYBACK -> tryOpenPlaybackPanel() OpenPanel.QUEUE -> tryOpenQueuePanel() } playbackModel.openPanel.consume() } private fun tryOpenPlaybackPanel() { val binding = requireBinding() val playbackSheetBehavior = binding.playbackSheet.coordinatorLayoutBehavior as PlaybackBottomSheetBehavior if (playbackSheetBehavior.targetState == BackportBottomSheetBehavior.STATE_COLLAPSED) { // Playback sheet is not expanded and not hidden, we can expand it. logD("Expanding playback sheet") playbackSheetBehavior.state = BackportBottomSheetBehavior.STATE_EXPANDED return } val queueSheetBehavior = (binding.queueSheet.coordinatorLayoutBehavior ?: return) as QueueBottomSheetBehavior if (playbackSheetBehavior.state == BackportBottomSheetBehavior.STATE_EXPANDED && queueSheetBehavior.targetState == BackportBottomSheetBehavior.STATE_EXPANDED) { // Queue sheet and playback sheet is expanded, close the queue sheet so the // playback panel can shown. logD("Collapsing queue sheet") queueSheetBehavior.state = BackportBottomSheetBehavior.STATE_COLLAPSED } } private fun tryClosePlaybackPanel() { val binding = requireBinding() val playbackSheetBehavior = binding.playbackSheet.coordinatorLayoutBehavior as PlaybackBottomSheetBehavior if (playbackSheetBehavior.targetState == BackportBottomSheetBehavior.STATE_EXPANDED) { // Playback sheet (and possibly queue) needs to be collapsed. logD("Collapsing playback and queue sheets") val queueSheetBehavior = binding.queueSheet.coordinatorLayoutBehavior as QueueBottomSheetBehavior? playbackSheetBehavior.state = BackportBottomSheetBehavior.STATE_COLLAPSED queueSheetBehavior?.state = BackportBottomSheetBehavior.STATE_COLLAPSED } } private fun tryOpenQueuePanel() { val binding = requireBinding() val playbackSheetBehavior = binding.playbackSheet.coordinatorLayoutBehavior as PlaybackBottomSheetBehavior val queueSheetBehavior = (binding.queueSheet.coordinatorLayoutBehavior ?: return) as QueueBottomSheetBehavior if (playbackSheetBehavior.state == BackportBottomSheetBehavior.STATE_EXPANDED && queueSheetBehavior.targetState == BackportBottomSheetBehavior.STATE_COLLAPSED) { // Playback sheet is expanded and queue sheet is collapsed, we can expand it. queueSheetBehavior.state = BackportBottomSheetBehavior.STATE_EXPANDED } } private fun tryShowSheets() { val binding = requireBinding() val playbackSheetBehavior = binding.playbackSheet.coordinatorLayoutBehavior as PlaybackBottomSheetBehavior if (playbackSheetBehavior.targetState == BackportBottomSheetBehavior.STATE_HIDDEN) { logD("Unhiding and enabling playback sheet") val queueSheetBehavior = binding.queueSheet.coordinatorLayoutBehavior as QueueBottomSheetBehavior? // Queue sheet behavior is either collapsed or expanded, no hiding needed queueSheetBehavior?.isDraggable = true playbackSheetBehavior.apply { // Make sure the view is draggable, at least until the draw checks kick in. isDraggable = true state = BackportBottomSheetBehavior.STATE_COLLAPSED } } } private fun tryHideAllSheets() { val binding = requireBinding() val playbackSheetBehavior = binding.playbackSheet.coordinatorLayoutBehavior as PlaybackBottomSheetBehavior if (playbackSheetBehavior.targetState != BackportBottomSheetBehavior.STATE_HIDDEN) { val queueSheetBehavior = binding.queueSheet.coordinatorLayoutBehavior as QueueBottomSheetBehavior? logD("Hiding and disabling playback and queue sheets") // Make both bottom sheets non-draggable so the user can't halt the hiding event. queueSheetBehavior?.apply { isDraggable = false state = BackportBottomSheetBehavior.STATE_COLLAPSED } playbackSheetBehavior.apply { isDraggable = false state = BackportBottomSheetBehavior.STATE_HIDDEN } } } private class SheetBackPressedCallback( private val playbackSheetBehavior: PlaybackBottomSheetBehavior<*>, private val queueSheetBehavior: QueueBottomSheetBehavior<*>? ) : OnBackPressedCallback(false) { override fun handleOnBackPressed() { // If expanded, collapse the queue sheet first. if (queueSheetShown()) { unlikelyToBeNull(queueSheetBehavior).state = BackportBottomSheetBehavior.STATE_COLLAPSED logD("Collapsed queue sheet") return } // If expanded, collapse the playback sheet next. if (playbackSheetShown()) { playbackSheetBehavior.state = BackportBottomSheetBehavior.STATE_COLLAPSED logD("Collapsed playback sheet") return } } fun invalidateEnabled() { isEnabled = queueSheetShown() || playbackSheetShown() } private fun playbackSheetShown() = playbackSheetBehavior.targetState != BackportBottomSheetBehavior.STATE_COLLAPSED && playbackSheetBehavior.targetState != BackportBottomSheetBehavior.STATE_HIDDEN private fun queueSheetShown() = queueSheetBehavior != null && playbackSheetBehavior.state == BackportBottomSheetBehavior.STATE_EXPANDED && queueSheetBehavior.targetState != BackportBottomSheetBehavior.STATE_COLLAPSED } private class DetailBackPressedCallback(private val detailModel: DetailViewModel) : OnBackPressedCallback(false) { override fun handleOnBackPressed() { if (detailModel.dropPlaylistEdit()) { logD("Dropped playlist edits") } } fun invalidateEnabled(playlistEdit: List?) { isEnabled = playlistEdit != null } } private inner class SelectionBackPressedCallback(private val listModel: ListViewModel) : OnBackPressedCallback(false) { override fun handleOnBackPressed() { if (listModel.dropSelection()) { logD("Dropped selection") } } fun invalidateEnabled(selection: List) { isEnabled = selection.isNotEmpty() } } private inner class SpeedDialBackPressedCallback(private val homeModel: HomeViewModel) : OnBackPressedCallback(false) { override fun handleOnBackPressed() { if (homeModel.speedDialOpen.value) { homeModel.setSpeedDialOpen(false) } } fun invalidateEnabled(open: Boolean) { isEnabled = open } } private companion object { val SPEED_DIAL_OVERLAY_ANIMATION_DURATION_FIELD: Field by lazyReflectedField(SpeedDialOverlayLayout::class, "mAnimationDuration") } }