Class StyledPlayerView

  • All Implemented Interfaces:
    Drawable.Callback, AccessibilityEventSource, KeyEvent.Callback, ViewManager, ViewParent, AdViewProvider

    public class StyledPlayerView
    extends FrameLayout
    implements AdViewProvider
    A high level view for Player media playbacks. It displays video, subtitles and album art during playback, and displays playback controls using a StyledPlayerControlView.

    A StyledPlayerView can be customized by setting attributes (or calling corresponding methods), or overriding drawables.

    Attributes

    The following attributes can be set on a StyledPlayerView when used in a layout XML file:
    • use_artwork - Whether artwork is used if available in audio streams.
    • default_artwork - Default artwork to use if no artwork available in audio streams.
    • use_controller - Whether the playback controls can be shown.
    • hide_on_touch - Whether the playback controls are hidden by touch events.
    • auto_show - Whether the playback controls are automatically shown when playback starts, pauses, ends, or fails. If set to false, the playback controls can be manually operated with showController() and hideController().
    • hide_during_ads - Whether the playback controls are hidden during ads. Controls are always shown during ads if they are enabled and the player is paused.
    • show_buffering - Whether the buffering spinner is displayed when the player is buffering. Valid values are never, when_playing and always.
    • resize_mode - Controls how video and album art is resized within the view. Valid values are fit, fixed_width, fixed_height, fill and zoom.
    • surface_type - The type of surface view used for video playbacks. Valid values are surface_view, texture_view, spherical_gl_surface_view, video_decoder_gl_surface_view and none. Using none is recommended for audio only applications, since creating the surface can be expensive. Using surface_view is recommended for video applications. Note, TextureView can only be used in a hardware accelerated window. When rendered in software, TextureView will draw nothing.
      • Corresponding method: None
      • Default: surface_view
    • shutter_background_color - The background color of the exo_shutter view.
    • keep_content_on_player_reset - Whether the currently displayed video frame or media artwork is kept visible when the player is reset.
    • All attributes that can be set on StyledPlayerControlView and DefaultTimeBar can also be set on a StyledPlayerView, and will be propagated to the inflated StyledPlayerControlView unless the layout is overridden to specify a custom exo_controller.

    Overriding drawables

    The drawables used by StyledPlayerControlView (with its default layout file) can be overridden by drawables with the same names defined in your application. See the StyledPlayerControlView documentation for a list of drawables that can be overridden.
    • Field Detail

      • SHOW_BUFFERING_NEVER

        public static final int SHOW_BUFFERING_NEVER
        The buffering view is never shown.
        See Also:
        Constant Field Values
      • SHOW_BUFFERING_ALWAYS

        public static final int SHOW_BUFFERING_ALWAYS
        The buffering view is always shown when the player is in the buffering state.
        See Also:
        Constant Field Values
    • Constructor Detail

      • StyledPlayerView

        public StyledPlayerView​(Context context)
      • StyledPlayerView

        public StyledPlayerView​(Context context,
                                @Nullable
                                AttributeSet attrs)
      • StyledPlayerView

        public StyledPlayerView​(Context context,
                                @Nullable
                                AttributeSet attrs,
                                int defStyleAttr)
    • Method Detail

      • switchTargetView

        public static void switchTargetView​(Player player,
                                            @Nullable
                                            StyledPlayerView oldPlayerView,
                                            @Nullable
                                            StyledPlayerView newPlayerView)
        Switches the view targeted by a given Player.
        Parameters:
        player - The player whose target view is being switched.
        oldPlayerView - The old view to detach from the player.
        newPlayerView - The new view to attach to the player.
      • getPlayer

        @Nullable
        public Player getPlayer()
        Returns the player currently set on this view, or null if no player is set.
      • setPlayer

        public void setPlayer​(@Nullable
                              Player player)
        Sets the Player to use.

        To transition a Player from targeting one view to another, it's recommended to use switchTargetView(Player, StyledPlayerView, StyledPlayerView) rather than this method. If you do wish to use this method directly, be sure to attach the player to the new view before calling setPlayer(null) to detach it from the old one. This ordering is significantly more efficient and may allow for more seamless transitions.

        Parameters:
        player - The Player to use, or null to detach the current player. Only players which are accessed on the main thread are supported ( player.getApplicationLooper() == Looper.getMainLooper()).
      • setVisibility

        public void setVisibility​(int visibility)
        Overrides:
        setVisibility in class View
      • getUseArtwork

        public boolean getUseArtwork()
        Returns whether artwork is displayed if present in the media.
      • setUseArtwork

        public void setUseArtwork​(boolean useArtwork)
        Sets whether artwork is displayed if present in the media.
        Parameters:
        useArtwork - Whether artwork is displayed.
      • getDefaultArtwork

        @Nullable
        public Drawable getDefaultArtwork()
        Returns the default artwork to display.
      • setDefaultArtwork

        public void setDefaultArtwork​(@Nullable
                                      Drawable defaultArtwork)
        Sets the default artwork to display if useArtwork is true and no artwork is present in the media.
        Parameters:
        defaultArtwork - the default artwork to display
      • getUseController

        public boolean getUseController()
        Returns whether the playback controls can be shown.
      • setUseController

        public void setUseController​(boolean useController)
        Sets whether the playback controls can be shown. If set to false the playback controls are never visible and are disconnected from the player.

        This call will update whether the view is clickable. After the call, the view will be clickable if playback controls can be shown or if the view has a registered click listener.

        Parameters:
        useController - Whether the playback controls can be shown.
      • setShutterBackgroundColor

        public void setShutterBackgroundColor​(@ColorInt
                                              int color)
        Sets the background color of the exo_shutter view.
        Parameters:
        color - The background color.
      • setKeepContentOnPlayerReset

        public void setKeepContentOnPlayerReset​(boolean keepContentOnPlayerReset)
        Sets whether the currently displayed video frame or media artwork is kept visible when the player is reset. A player reset is defined to mean the player being re-prepared with different media, the player transitioning to unprepared media or an empty list of media items, or the player being replaced or cleared by calling setPlayer(Player).

        If enabled, the currently displayed video frame or media artwork will be kept visible until the player set on the view has been successfully prepared with new media and loaded enough of it to have determined the available tracks. Hence enabling this option allows transitioning from playing one piece of media to another, or from using one player instance to another, without clearing the view's content.

        If disabled, the currently displayed video frame or media artwork will be hidden as soon as the player is reset. Note that the video frame is hidden by making exo_shutter visible. Hence the video frame will not be hidden if using a custom layout that omits this view.

        Parameters:
        keepContentOnPlayerReset - Whether the currently displayed video frame or media artwork is kept visible when the player is reset.
      • setShowBuffering

        public void setShowBuffering​(@com.google.android.exoplayer2.ui.StyledPlayerView.ShowBuffering int showBuffering)
        Sets whether a buffering spinner is displayed when the player is in the buffering state. The buffering spinner is not displayed by default.
        Parameters:
        showBuffering - The mode that defines when the buffering spinner is displayed. One of SHOW_BUFFERING_NEVER, SHOW_BUFFERING_WHEN_PLAYING and SHOW_BUFFERING_ALWAYS.
      • setCustomErrorMessage

        public void setCustomErrorMessage​(@Nullable
                                          CharSequence message)
        Sets a custom error message to be displayed by the view. The error message will be displayed permanently, unless it is cleared by passing null to this method.
        Parameters:
        message - The message to display, or null to clear a previously set message.
      • dispatchMediaKeyEvent

        public boolean dispatchMediaKeyEvent​(KeyEvent event)
        Called to process media key events. Any KeyEvent can be passed but only media key events will be handled. Does nothing if playback controls are disabled.
        Parameters:
        event - A key event.
        Returns:
        Whether the key event was handled.
      • isControllerFullyVisible

        public boolean isControllerFullyVisible()
        Returns whether the controller is currently fully visible.
      • showController

        public void showController()
        Shows the playback controls. Does nothing if playback controls are disabled.

        The playback controls are automatically hidden during playback after {getControllerShowTimeoutMs()}. They are shown indefinitely when playback has not started yet, is paused, has ended or failed.

      • hideController

        public void hideController()
        Hides the playback controls. Does nothing if playback controls are disabled.
      • getControllerShowTimeoutMs

        public int getControllerShowTimeoutMs()
        Returns the playback controls timeout. The playback controls are automatically hidden after this duration of time has elapsed without user input and with playback or buffering in progress.
        Returns:
        The timeout in milliseconds. A non-positive value will cause the controller to remain visible indefinitely.
      • setControllerShowTimeoutMs

        public void setControllerShowTimeoutMs​(int controllerShowTimeoutMs)
        Sets the playback controls timeout. The playback controls are automatically hidden after this duration of time has elapsed without user input and with playback or buffering in progress.
        Parameters:
        controllerShowTimeoutMs - The timeout in milliseconds. A non-positive value will cause the controller to remain visible indefinitely.
      • getControllerHideOnTouch

        public boolean getControllerHideOnTouch()
        Returns whether the playback controls are hidden by touch events.
      • setControllerHideOnTouch

        public void setControllerHideOnTouch​(boolean controllerHideOnTouch)
        Sets whether the playback controls are hidden by touch events.
        Parameters:
        controllerHideOnTouch - Whether the playback controls are hidden by touch events.
      • getControllerAutoShow

        public boolean getControllerAutoShow()
        Returns whether the playback controls are automatically shown when playback starts, pauses, ends, or fails. If set to false, the playback controls can be manually operated with showController() and hideController().
      • setControllerAutoShow

        public void setControllerAutoShow​(boolean controllerAutoShow)
        Sets whether the playback controls are automatically shown when playback starts, pauses, ends, or fails. If set to false, the playback controls can be manually operated with showController() and hideController().
        Parameters:
        controllerAutoShow - Whether the playback controls are allowed to show automatically.
      • setControllerHideDuringAds

        public void setControllerHideDuringAds​(boolean controllerHideDuringAds)
        Sets whether the playback controls are hidden when ads are playing. Controls are always shown during ads if they are enabled and the player is paused.
        Parameters:
        controllerHideDuringAds - Whether the playback controls are hidden when ads are playing.
      • setShowRewindButton

        public void setShowRewindButton​(boolean showRewindButton)
        Sets whether the rewind button is shown.
        Parameters:
        showRewindButton - Whether the rewind button is shown.
      • setShowFastForwardButton

        public void setShowFastForwardButton​(boolean showFastForwardButton)
        Sets whether the fast forward button is shown.
        Parameters:
        showFastForwardButton - Whether the fast forward button is shown.
      • setShowPreviousButton

        public void setShowPreviousButton​(boolean showPreviousButton)
        Sets whether the previous button is shown.
        Parameters:
        showPreviousButton - Whether the previous button is shown.
      • setShowNextButton

        public void setShowNextButton​(boolean showNextButton)
        Sets whether the next button is shown.
        Parameters:
        showNextButton - Whether the next button is shown.
      • setRepeatToggleModes

        public void setRepeatToggleModes​(@RepeatToggleModes
                                         @com.google.android.exoplayer2.util.RepeatModeUtil.RepeatToggleModes int repeatToggleModes)
        Sets which repeat toggle modes are enabled.
        Parameters:
        repeatToggleModes - A set of RepeatModeUtil.RepeatToggleModes.
      • setShowShuffleButton

        public void setShowShuffleButton​(boolean showShuffleButton)
        Sets whether the shuffle button is shown.
        Parameters:
        showShuffleButton - Whether the shuffle button is shown.
      • setShowSubtitleButton

        public void setShowSubtitleButton​(boolean showSubtitleButton)
        Sets whether the subtitle button is shown.
        Parameters:
        showSubtitleButton - Whether the subtitle button is shown.
      • setShowVrButton

        public void setShowVrButton​(boolean showVrButton)
        Sets whether the vr button is shown.
        Parameters:
        showVrButton - Whether the vr button is shown.
      • setShowMultiWindowTimeBar

        public void setShowMultiWindowTimeBar​(boolean showMultiWindowTimeBar)
        Sets whether the time bar should show all windows, as opposed to just the current one.
        Parameters:
        showMultiWindowTimeBar - Whether to show all windows.
      • setExtraAdGroupMarkers

        public void setExtraAdGroupMarkers​(@Nullable
                                           long[] extraAdGroupTimesMs,
                                           @Nullable
                                           boolean[] extraPlayedAdGroups)
        Sets the millisecond positions of extra ad markers relative to the start of the window (or timeline, if in multi-window mode) and whether each extra ad has been played or not. The markers are shown in addition to any ad markers for ads in the player's timeline.
        Parameters:
        extraAdGroupTimesMs - The millisecond timestamps of the extra ad markers to show, or null to show no extra ad markers.
        extraPlayedAdGroups - Whether each ad has been played, or null to show no extra ad markers.
      • getVideoSurfaceView

        @Nullable
        public View getVideoSurfaceView()
        Gets the view onto which video is rendered. This is a:
        • SurfaceView by default, or if the surface_type attribute is set to surface_view.
        • TextureView if surface_type is texture_view.
        • SphericalGLSurfaceView if surface_type is spherical_gl_surface_view.
        • VideoDecoderGLSurfaceView if surface_type is video_decoder_gl_surface_view.
        • null if surface_type is none.
        Returns:
        The SurfaceView, TextureView, SphericalGLSurfaceView, VideoDecoderGLSurfaceView or null.
      • getOverlayFrameLayout

        @Nullable
        public FrameLayout getOverlayFrameLayout()
        Gets the overlay FrameLayout, which can be populated with UI elements to show on top of the player.
        Returns:
        The overlay FrameLayout, or null if the layout has been customized and the overlay is not present.
      • getSubtitleView

        @Nullable
        public SubtitleView getSubtitleView()
        Gets the SubtitleView.
        Returns:
        The SubtitleView, or null if the layout has been customized and the subtitle view is not present.
      • performClick

        public boolean performClick()
        Overrides:
        performClick in class View
      • onResume

        public void onResume()
        Should be called when the player is visible to the user, if the surface_type extends GLSurfaceView. It is the counterpart to onPause().

        This method should typically be called in Activity.onStart(), or Activity.onResume() for API versions <= 23.

      • onPause

        public void onPause()
        Should be called when the player is no longer visible to the user, if the surface_type extends GLSurfaceView. It is the counterpart to onResume().

        This method should typically be called in Activity.onStop(), or Activity.onPause() for API versions <= 23.

      • onContentAspectRatioChanged

        protected void onContentAspectRatioChanged​(@Nullable
                                                   AspectRatioFrameLayout contentFrame,
                                                   float aspectRatio)
        Called when there's a change in the desired aspect ratio of the content frame. The default implementation sets the aspect ratio of the content frame to the specified value.
        Parameters:
        contentFrame - The content frame, or null.
        aspectRatio - The aspect ratio to apply.
      • getAdOverlayInfos

        public List<AdOverlayInfo> getAdOverlayInfos()
        Description copied from interface: AdViewProvider
        Returns a list of AdOverlayInfo instances describing views that are on top of the ad view group, but that are essential for controlling playback and should be excluded from ad viewability measurements.

        Each view must be either a fully transparent overlay (for capturing touch events), or a small piece of transient UI that is essential to the user experience of playback (such as a button to pause/resume playback or a transient full-screen or cast button). For more information see the documentation for your ads loader.

        Specified by:
        getAdOverlayInfos in interface AdViewProvider