VideoView

public class VideoView
extends ViewGroup

java.lang.Object
↳	android.view.View
	↳	android.view.ViewGroup
		↳	androidx.media2.widget.VideoView

---

A high level view for media playback that can be integrated with either a SessionPlayer or a MediaController. Developers can easily implement a video rendering application using this class. By default, a MediaControlView is attached so the playback control buttons are displayed on top of VideoView.

Contents:

1. Using VideoView with SessionPlayer or MediaController
2. Using VideoView with MediaControlView
3. Choosing a view type
4. Comparison with android.widget.VideoView
5. Displaying Metadata

Using VideoView with SessionPlayer or MediaController

• For simple use cases that do not require communication with a MediaSession, apps need to create a player instance that extends SessionPlayer (e.g. MediaPlayer) and link it to this view by calling setPlayer(SessionPlayer).
• For more advanced use cases that require a MediaSession (e.g. handling media key events, integrating with other MediaSession apps as Assistant), apps need to create a MediaController that's attached to the MediaSession and link it to this view by calling setMediaController(MediaController).

Using VideoView with MediaControlView

VideoView is working with MediaControlView and a MediaControlView instance is attached to VideoView by default.

If you want to attach a custom MediaControlView, assign the custom media control widget using setMediaControlView(MediaControlView, long).

If you don't want to use MediaControlView, set the VideoView attribute R.attr.enableControlView to false.

Choosing a view type

VideoView can render videos on a TextureView or SurfaceView. The default is SurfaceView which can be changed by using the setViewType(int) method or by setting the R.attr.viewType attribute in the layout file.

SurfaceView is recommended in most cases for saving battery life. TextureView might be preferred for supporting various UIs such as animation and translucency.

Comparison with android.widget.VideoView

These are the main differences between the media2 VideoView widget and the older android widget:

• android.widget.VideoView creates a MediaPlayer instance internally and wraps playback APIs around it.

  androidx.media2.widget.VideoView does not create a player instance internally. Instead, either a SessionPlayer or a MediaController instance should be created externally and link to VideoView using setPlayer(SessionPlayer) or setMediaController(MediaController), respectively.

• android.widget.VideoView inherits from the SurfaceView class.

  androidx.media2.widget.VideoView inherits from ViewGroup and can render videos using SurfaceView or TextureView, depending on your choice.

• A VideoView can respond to media key events if you call setMediaController(MediaController) to link it to a MediaController that's connected to an active MediaSession.

Displaying Metadata

When you play music only (sound with no video), VideoView can display album art and other metadata by calling MediaItem.setMetadata(MediaMetadata). The following table shows the metadata displayed by the VideoView, and the default values assigned if the keys are not set:

Key	Default
MediaMetadata.METADATA_KEY_TITLE	R.string.mcv2_music_title_unknown_text
MediaMetadata.METADATA_KEY_ARTIST	R.string.mcv2_music_artist_unknown_text
MediaMetadata.METADATA_KEY_ALBUM_ART	R.drawable.media2_widget_ic_default_album_image

Note: VideoView does not retain its full state when going into the background. In particular, it does not save, and does not restore the current play state, play position, selected tracks. Applications should save and restore these on their own in Activity.onSaveInstanceState(Bundle) and Activity.onRestoreInstanceState(Bundle).

Attributes :

• R.attr.enableControlView
• R.attr.viewType

Example of attributes for a VideoView with TextureView and no attached control view:

 <androidx.media2.widget.VideoView
      android:id="@+id/video_view"
      widget:enableControlView="false"
      widget:viewType="textureView"
  />

Summary

Nested classes
interface	VideoView.OnViewTypeChangedListener Interface definition of a callback to be invoked when the view type has been changed.

Constants
int	VIEW_TYPE_SURFACEVIEW Indicates video is rendering on SurfaceView.
int	VIEW_TYPE_TEXTUREVIEW Indicates video is rendering on TextureView.

Inherited constants
From class android.view.ViewGroup int CLIP_TO_PADDING_MASK int FOCUS_AFTER_DESCENDANTS int FOCUS_BEFORE_DESCENDANTS int FOCUS_BLOCK_DESCENDANTS int LAYOUT_MODE_CLIP_BOUNDS int LAYOUT_MODE_OPTICAL_BOUNDS int PERSISTENT_ALL_CACHES int PERSISTENT_ANIMATION_CACHE int PERSISTENT_NO_CACHE int PERSISTENT_SCROLLING_CACHE
From class android.view.View int ACCESSIBILITY_LIVE_REGION_ASSERTIVE int ACCESSIBILITY_LIVE_REGION_NONE int ACCESSIBILITY_LIVE_REGION_POLITE int AUTOFILL_FLAG_INCLUDE_NOT_IMPORTANT_VIEWS String AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_DATE String AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_DAY String AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_MONTH String AUTOFILL_HINT_CREDIT_CARD_EXPIRATION_YEAR String AUTOFILL_HINT_CREDIT_CARD_NUMBER String AUTOFILL_HINT_CREDIT_CARD_SECURITY_CODE String AUTOFILL_HINT_EMAIL_ADDRESS String AUTOFILL_HINT_NAME String AUTOFILL_HINT_PASSWORD String AUTOFILL_HINT_PHONE String AUTOFILL_HINT_POSTAL_ADDRESS String AUTOFILL_HINT_POSTAL_CODE String AUTOFILL_HINT_USERNAME int