VideoView2.java revision 46377a9aaea75f5dfc3b9365142c6e65398e2afe
1e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim/* 2e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim * Copyright 2018 The Android Open Source Project 3e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim * 4e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim * Licensed under the Apache License, Version 2.0 (the "License"); 5e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim * you may not use this file except in compliance with the License. 6e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim * You may obtain a copy of the License at 7e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim * 8e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim * http://www.apache.org/licenses/LICENSE-2.0 9e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim * 10e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim * Unless required by applicable law or agreed to in writing, software 11e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim * distributed under the License is distributed on an "AS IS" BASIS, 12e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 13e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim * See the License for the specific language governing permissions and 14e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim * limitations under the License. 15e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 16e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 17e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Limpackage android.widget; 18e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 19e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Limimport android.annotation.IntDef; 20e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Limimport android.annotation.NonNull; 21e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Limimport android.annotation.Nullable; 22e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Limimport android.content.Context; 23e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Limimport android.media.AudioAttributes; 24de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kangimport android.media.AudioManager; 25af2a1ad069f2fefc162eede7556cd91288a91e8cSungsoo Limimport android.media.MediaPlayerBase; 2682af545ca64bff030697a0369e0301c03e8123ecSungsoo Limimport android.media.session.MediaController; 2746377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moonimport android.media.session.PlaybackState; 28e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Limimport android.media.update.ApiLoader; 29e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Limimport android.media.update.VideoView2Provider; 30e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Limimport android.media.update.ViewProvider; 31e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Limimport android.net.Uri; 3246377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moonimport android.os.Bundle; 33e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Limimport android.util.AttributeSet; 34e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Limimport android.view.KeyEvent; 35e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Limimport android.view.MotionEvent; 36e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 37e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Limimport java.lang.annotation.Retention; 38e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Limimport java.lang.annotation.RetentionPolicy; 39af2a1ad069f2fefc162eede7556cd91288a91e8cSungsoo Limimport java.util.List; 40e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Limimport java.util.Map; 41e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 42eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang// TODO: Use @link tag to refer MediaPlayer2 in docs once MediaPlayer2.java is submitted. Same to 43eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang// MediaSession2. 44eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang// TODO: change the reference from MediaPlayer to MediaPlayer2. 45e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim/** 46eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Displays a video file. VideoView2 class is a View class which is wrapping MediaPlayer2 so that 47eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * developers can easily implement a video rendering application. 48eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * 49eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <p> 50eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <em> Data sources that VideoView2 supports : </em> 51eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * VideoView2 can play video files and audio-only fiels as 52eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * well. It can load from various sources such as resources or content providers. The supported 53eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * media file formats are the same as MediaPlayer2. 54eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * 55eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <p> 56eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <em> View type can be selected : </em> 57eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * VideoView2 can render videos on top of TextureView as well as 58eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * SurfaceView selectively. The default is SurfaceView and it can be changed using 59eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * {@link #setViewType(int)} method. Using SurfaceView is recommended in most cases for saving 60eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * battery. TextureView might be preferred for supporting various UIs such as animation and 61eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * translucency. 62eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * 63eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <p> 64eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <em> Differences between {@link VideoView} class : </em> 65eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * VideoView2 covers and inherits the most of 66eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * VideoView's functionalities. The main differences are 67eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <ul> 68eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <li> VideoView2 inherits FrameLayout and renders videos using SurfaceView and TextureView 69eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * selectively while VideoView inherits SurfaceView class. 70eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <li> VideoView2 is integrated with MediaControlView2 and a default MediaControlView2 instance is 71eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * attached to VideoView2 by default. If a developer does not want to use the default 72eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * MediaControlView2, needs to set enableControlView attribute to false. For instance, 73eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <pre> 74eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <VideoView2 75eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * android:id="@+id/video_view" 76eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * xmlns:widget="http://schemas.android.com/apk/com.android.media.update" 77eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * widget:enableControlView="false" /> 78eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * </pre> 79eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * If a developer wants to attach a customed MediaControlView2, then set enableControlView attribute 80eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * to false and assign the customed media control widget using {@link #setMediaControlView2}. 81eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <li> VideoView2 is integrated with MediaPlayer2 while VideoView is integrated with MediaPlayer. 8282af545ca64bff030697a0369e0301c03e8123ecSungsoo Lim * <li> VideoView2 is integrated with MediaSession and so it responses with media key events. 8382af545ca64bff030697a0369e0301c03e8123ecSungsoo Lim * A VideoView2 keeps a MediaSession instance internally and connects it to a corresponding 84eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * MediaControlView2 instance. 85eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * </p> 86eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * </ul> 87eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * 88eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <p> 89eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <em> Audio focus and audio attributes : </em> 90eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * By default, VideoView2 requests audio focus with 91eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * {@link AudioManager#AUDIOFOCUS_GAIN}. Use {@link #setAudioFocusRequest(int)} to change this 92eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * behavior. The default {@link AudioAttributes} used during playback have a usage of 93eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * {@link AudioAttributes#USAGE_MEDIA} and a content type of 94eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * {@link AudioAttributes#CONTENT_TYPE_MOVIE}, use {@link #setAudioAttributes(AudioAttributes)} to 95eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * modify them. 96eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * 97eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <p> 98eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Note: VideoView2 does not retain its full state when going into the background. In particular, it 99eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * does not restore the current play state, play position, selected tracks. Applications should save 100eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * and restore these on their own in {@link android.app.Activity#onSaveInstanceState} and 101eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * {@link android.app.Activity#onRestoreInstanceState}. 102eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * 103e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim * @hide 104e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 105e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Limpublic class VideoView2 extends FrameLayout { 106eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang /** @hide */ 107e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim @IntDef({ 108e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim VIEW_TYPE_TEXTUREVIEW, 109e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim VIEW_TYPE_SURFACEVIEW 110e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim }) 111e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim @Retention(RetentionPolicy.SOURCE) 112e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public @interface ViewType {} 113eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang 114e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public static final int VIEW_TYPE_SURFACEVIEW = 1; 115e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public static final int VIEW_TYPE_TEXTUREVIEW = 2; 116e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 117e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim private final VideoView2Provider mProvider; 118e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 119e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public VideoView2(@NonNull Context context) { 120e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim this(context, null); 121e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 122e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 123e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public VideoView2(@NonNull Context context, @Nullable AttributeSet attrs) { 124e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim this(context, attrs, 0); 125e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 126e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 127e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public VideoView2(@NonNull Context context, @Nullable AttributeSet attrs, int defStyleAttr) { 128e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim this(context, attrs, defStyleAttr, 0); 129e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 130e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 131e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public VideoView2( 132e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim @NonNull Context context, @Nullable AttributeSet attrs, 133e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim int defStyleAttr, int defStyleRes) { 134e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim super(context, attrs, defStyleAttr, defStyleRes); 135e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 136de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang mProvider = ApiLoader.getProvider(context).createVideoView2(this, new SuperProvider(), 137de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang attrs, defStyleAttr, defStyleRes); 138e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 139e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 140e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 141e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim * @hide 142e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 143e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public VideoView2Provider getProvider() { 144e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim return mProvider; 145e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 146e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 147e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 148eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Sets MediaControlView2 instance. It will replace the previously assigned MediaControlView2 149eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * instance if any. 150eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * 151eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * @param mediaControlView a media control view2 instance. 152e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 153de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang public void setMediaControlView2(MediaControlView2 mediaControlView) { 154de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang mProvider.setMediaControlView2_impl(mediaControlView); 155de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang } 156de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang 157de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang /** 158eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Returns MediaControlView2 instance which is currently attached to VideoView2 by default or by 159eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * {@link #setMediaControlView2} method. 160de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang */ 161de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang public MediaControlView2 getMediaControlView2() { 162de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang return mProvider.getMediaControlView2_impl(); 163de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang } 164de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang 165e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 166e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 16782af545ca64bff030697a0369e0301c03e8123ecSungsoo Lim * Returns MediaController instance which is connected with MediaSession that VideoView2 is 16882af545ca64bff030697a0369e0301c03e8123ecSungsoo Lim * using. This method should be called when VideoView2 is attached to window, or it throws 16982af545ca64bff030697a0369e0301c03e8123ecSungsoo Lim * IllegalStateException, since internal MediaSession instance is not available until 17082af545ca64bff030697a0369e0301c03e8123ecSungsoo Lim * this view is attached to window. Please check {@link android.view.View#isAttachedToWindow} 17182af545ca64bff030697a0369e0301c03e8123ecSungsoo Lim * before calling this method. 17282af545ca64bff030697a0369e0301c03e8123ecSungsoo Lim * 17382af545ca64bff030697a0369e0301c03e8123ecSungsoo Lim * @throws IllegalStateException if interal MediaSession is not created yet. 174e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 17582af545ca64bff030697a0369e0301c03e8123ecSungsoo Lim public MediaController getMediaController() { 17682af545ca64bff030697a0369e0301c03e8123ecSungsoo Lim return mProvider.getMediaController_impl(); 177e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 178e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 179e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 180eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Returns the audio session ID. 181e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 182e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public int getAudioSessionId() { 183e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim return mProvider.getAudioSessionId_impl(); 184e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 185e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 186e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 187eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Starts rendering closed caption or subtitles if there is any. The first subtitle track will 188eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * be chosen by default if there multiple subtitle tracks exist. 189e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 190e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public void showSubtitle() { 191e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim mProvider.showSubtitle_impl(); 192e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 193e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 194e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 195eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Stops showing closed captions or subtitles. 196e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 197e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public void hideSubtitle() { 198e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim mProvider.hideSubtitle_impl(); 199e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 200e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 201efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon /** 202efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon * Sets full screen mode. 203efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon */ 204efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon public void setFullScreen(boolean fullScreen) { 205efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon mProvider.setFullScreen_impl(fullScreen); 206efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon } 207efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon 208e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 209de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * Sets playback speed. 210de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * 211de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * It is expressed as a multiplicative factor, where normal speed is 1.0f. If it is less than 212de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * or equal to zero, it will be just ignored and nothing will be changed. If it exceeds the 213de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * maximum speed that internal engine supports, system will determine best handling or it will 214de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * be reset to the normal speed 1.0f. 215de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * @param speed the playback speed. It should be positive. 216de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang */ 21782af545ca64bff030697a0369e0301c03e8123ecSungsoo Lim // TODO: Support this via MediaController2. 218de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang public void setSpeed(float speed) { 219de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang mProvider.setSpeed_impl(speed); 220de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang } 221de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang 222de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang /** 223de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * Sets which type of audio focus will be requested during the playback, or configures playback 224de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * to not request audio focus. Valid values for focus requests are 225de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * {@link AudioManager#AUDIOFOCUS_GAIN}, {@link AudioManager#AUDIOFOCUS_GAIN_TRANSIENT}, 226de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * {@link AudioManager#AUDIOFOCUS_GAIN_TRANSIENT_MAY_DUCK}, and 227de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * {@link AudioManager#AUDIOFOCUS_GAIN_TRANSIENT_EXCLUSIVE}. Or use 228de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * {@link AudioManager#AUDIOFOCUS_NONE} to express that audio focus should not be 229de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * requested when playback starts. You can for instance use this when playing a silent animation 230de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * through this class, and you don't want to affect other audio applications playing in the 231de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * background. 232de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * 233de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * @param focusGain the type of audio focus gain that will be requested, or 234af2a1ad069f2fefc162eede7556cd91288a91e8cSungsoo Lim * {@link AudioManager#AUDIOFOCUS_NONE} to disable the use audio focus during 235af2a1ad069f2fefc162eede7556cd91288a91e8cSungsoo Lim * playback. 236e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 237e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public void setAudioFocusRequest(int focusGain) { 238e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim mProvider.setAudioFocusRequest_impl(focusGain); 239e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 240e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 241e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 242de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * Sets the {@link AudioAttributes} to be used during the playback of the video. 243de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * 244de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * @param attributes non-null <code>AudioAttributes</code>. 245e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 246e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public void setAudioAttributes(@NonNull AudioAttributes attributes) { 247e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim mProvider.setAudioAttributes_impl(attributes); 248e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 249e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 250e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 251af2a1ad069f2fefc162eede7556cd91288a91e8cSungsoo Lim * Sets a remote player for handling playback of the selected route from MediaControlView2. 252af2a1ad069f2fefc162eede7556cd91288a91e8cSungsoo Lim * If this is not called, MediaCotrolView2 will not show the route button. 253af2a1ad069f2fefc162eede7556cd91288a91e8cSungsoo Lim * 254af2a1ad069f2fefc162eede7556cd91288a91e8cSungsoo Lim * @param routeCategories the list of media control categories in 255af2a1ad069f2fefc162eede7556cd91288a91e8cSungsoo Lim * {@link android.support.v7.media.MediaControlIntent} 256af2a1ad069f2fefc162eede7556cd91288a91e8cSungsoo Lim * @param player the player to handle the selected route. If null, a default 257af2a1ad069f2fefc162eede7556cd91288a91e8cSungsoo Lim * route player will be used. 258af2a1ad069f2fefc162eede7556cd91288a91e8cSungsoo Lim * @throws IllegalStateException if MediaControlView2 is not set. 259af2a1ad069f2fefc162eede7556cd91288a91e8cSungsoo Lim */ 260af2a1ad069f2fefc162eede7556cd91288a91e8cSungsoo Lim public void setRouteAttributes(@NonNull List<String> routeCategories, 261af2a1ad069f2fefc162eede7556cd91288a91e8cSungsoo Lim @Nullable MediaPlayerBase player) { 262af2a1ad069f2fefc162eede7556cd91288a91e8cSungsoo Lim mProvider.setRouteAttributes_impl(routeCategories, player); 263af2a1ad069f2fefc162eede7556cd91288a91e8cSungsoo Lim } 264af2a1ad069f2fefc162eede7556cd91288a91e8cSungsoo Lim 265af2a1ad069f2fefc162eede7556cd91288a91e8cSungsoo Lim /** 266de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * Sets video path. 267de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * 268de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * @param path the path of the video. 269e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 270e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public void setVideoPath(String path) { 271e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim mProvider.setVideoPath_impl(path); 272e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 273e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 274e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 275eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Sets video URI. 276eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * 277eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * @param uri the URI of the video. 278e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 279e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public void setVideoURI(Uri uri) { 280e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim mProvider.setVideoURI_impl(uri); 281e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 282e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 283e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 284eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Sets video URI using specific headers. 285eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * 286eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * @param uri the URI of the video. 287eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * @param headers the headers for the URI request. 288eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Note that the cross domain redirection is allowed by default, but that can be 289eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * changed with key/value pairs through the headers parameter with 290eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * "android-allow-cross-domain-redirect" as the key and "0" or "1" as the value 291eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * to disallow or allow cross domain redirection. 292e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 293e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public void setVideoURI(Uri uri, Map<String, String> headers) { 294e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim mProvider.setVideoURI_impl(uri, headers); 295e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 296e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 297e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 298eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Selects which view will be used to render video between SurfacView and TextureView. 299eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * 300eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * @param viewType the view type to render video 301eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <ul> 302eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <li>{@link #VIEW_TYPE_SURFACEVIEW} 303eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <li>{@link #VIEW_TYPE_TEXTUREVIEW} 304eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * </ul> 305e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 306e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public void setViewType(@ViewType int viewType) { 307e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim mProvider.setViewType_impl(viewType); 308e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 309e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 310e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 311eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Returns view type. 312eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * 313eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * @return view type. See {@see setViewType}. 314e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 315e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim @ViewType 316e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public int getViewType() { 317e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim return mProvider.getViewType_impl(); 318e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 319e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 320e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 32146377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon * Sets custom actions which will be shown as custom buttons in {@link MediaControlView2}. 32246377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon * 32346377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon * @param actionList A list of {@link PlaybackState.CustomAction}. The return value of 32446377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon * {@link PlaybackState.CustomAction#getIcon()} will be used to draw buttons 32546377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon * in {@link MediaControlView2}. 32646377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon * @param listener A listener to be called when a custom button is clicked. 32746377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon */ 32846377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon public void setCustomActions(List<PlaybackState.CustomAction> actionList, 32946377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon OnCustomActionListener listener) { 33046377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon mProvider.setCustomActions_impl(actionList, listener); 33146377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon } 33246377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon 33346377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon /** 334eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Registers a callback to be invoked when the media file is loaded and ready to go. 335eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * 336eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * @param l the callback that will be run. 337e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 338de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang public void setOnPreparedListener(OnPreparedListener l) { 339e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim mProvider.setOnPreparedListener_impl(l); 340e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 341e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 342e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 343eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Registers a callback to be invoked when the end of a media file has been reached during 344eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * playback. 345eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * 346eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * @param l the callback that will be run. 347e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 348de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang public void setOnCompletionListener(OnCompletionListener l) { 349e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim mProvider.setOnCompletionListener_impl(l); 350e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 351e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 352e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 353eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Registers a callback to be invoked when an error occurs during playback or setup. If no 354eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * listener is specified, or if the listener returned false, VideoView2 will inform the user of 355eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * any errors. 356eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * 357eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * @param l The callback that will be run 358e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 359de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang public void setOnErrorListener(OnErrorListener l) { 360e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim mProvider.setOnErrorListener_impl(l); 361e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 362e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 363e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 364eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Registers a callback to be invoked when an informational event occurs during playback or 365eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * setup. 366eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * 367eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * @param l The callback that will be run 368e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 369de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang public void setOnInfoListener(OnInfoListener l) { 370e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim mProvider.setOnInfoListener_impl(l); 371e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 372e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 373e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 374eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Registers a callback to be invoked when a view type change is done. 375eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * {@see #setViewType(int)} 376eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * @param l The callback that will be run 377e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 378e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public void setOnViewTypeChangedListener(OnViewTypeChangedListener l) { 379e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim mProvider.setOnViewTypeChangedListener_impl(l); 380e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 381e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 382e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 383efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon * Registers a callback to be invoked when the fullscreen mode should be changed. 384efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon */ 385efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon public void setFullScreenChangedListener(OnFullScreenChangedListener l) { 386efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon mProvider.setFullScreenChangedListener_impl(l); 387efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon } 388efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon 389efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon /** 390de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * Interface definition of a callback to be invoked when the viw type has been changed. 391e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 392e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public interface OnViewTypeChangedListener { 393e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim /** 394de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * Called when the view type has been changed. 395eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * @see #setViewType(int) 396eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * @param viewType 397eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <ul> 398eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <li>{@link #VIEW_TYPE_SURFACEVIEW} 399eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * <li>{@link #VIEW_TYPE_TEXTUREVIEW} 400eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * </ul> 401e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim */ 402e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim void onViewTypeChanged(@ViewType int viewType); 403e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 404e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 405de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang /** 406eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Interface definition of a callback to be invoked when the media source is ready for playback. 407de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang */ 408de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang public interface OnPreparedListener { 409de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang /** 410de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * Called when the media file is ready for playback. 411de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang */ 412de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang void onPrepared(); 413de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang } 414de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang 415de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang /** 416eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Interface definition for a callback to be invoked when playback of a media source has 417eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * completed. 418de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang */ 419de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang public interface OnCompletionListener { 420de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang /** 421de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * Called when the end of a media source is reached during playback. 422de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang */ 423de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang void onCompletion(); 424de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang } 425de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang 426de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang /** 427eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Interface definition of a callback to be invoked when there has been an error during an 428eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * asynchronous operation. 429de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang */ 430de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang public interface OnErrorListener { 431eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang // TODO: Redefine error codes. 432de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang /** 433de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * Called to indicate an error. 434eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * @param what the type of error that has occurred 435eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * @param extra an extra code, specific to the error. 436eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * @return true if the method handled the error, false if it didn't. 437eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * @see MediaPlayer#OnErrorListener 438de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang */ 439de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang boolean onError(int what, int extra); 440de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang } 441de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang 442de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang /** 443eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * Interface definition of a callback to be invoked to communicate some info and/or warning 444eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * about the media or its playback. 445de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang */ 446de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang public interface OnInfoListener { 447de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang /** 448de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * Called to indicate an info or a warning. 449de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * @param what the type of info or warning. 450de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang * @param extra an extra code, specific to the info. 451eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * 452eb78d511cb5b06e7c679a090fc13afd74ec15717Insun Kang * @see MediaPlayer#OnInfoListener 453de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang */ 454de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang void onInfo(int what, int extra); 455de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang } 456de16c4d3579238b49cd3a253e9905196120f9bf0Insun Kang 457efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon /** 458efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon * Interface definition of a callback to be invoked to inform the fullscreen mode is changed. 459efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon */ 460efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon public interface OnFullScreenChangedListener { 461efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon /** 462efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon * Called to indicate a fullscreen mode change. 463efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon */ 464efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon void onFullScreenChanged(boolean fullScreen); 465efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon } 466efeb45eabd6b9b2bcb8390e4140c615967c70ddaHyundo Moon 46746377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon /** 46846377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon * Interface definition of a callback to be invoked to inform that a custom action is performed. 46946377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon * 47046377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon * TODO: When MediaSession2 is ready, modify the method to match the signature. 47146377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon */ 47246377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon public interface OnCustomActionListener { 47346377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon /** 47446377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon * Called to indicate that a custom action is performed. 47546377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon * 47646377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon * @param action The action that was originally sent in the 47746377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon * {@link PlaybackState.CustomAction}. 47846377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon * @param extras Optional extras. 47946377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon */ 48046377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon void onCustomAction(String action, Bundle extras); 48146377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon } 48246377a9aaea75f5dfc3b9365142c6e65398e2afeHyundo Moon 483e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim @Override 484fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang protected void onAttachedToWindow() { 485fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang mProvider.onAttachedToWindow_impl(); 486fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang } 487fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang 488fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang @Override 489fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang protected void onDetachedFromWindow() { 490fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang mProvider.onDetachedFromWindow_impl(); 491fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang } 492fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang 493fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang @Override 494e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public CharSequence getAccessibilityClassName() { 495e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim return mProvider.getAccessibilityClassName_impl(); 496e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 497e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 498e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim @Override 499e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public boolean onTouchEvent(MotionEvent ev) { 500e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim return mProvider.onTouchEvent_impl(ev); 501e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 502e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 503e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim @Override 504e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public boolean onTrackballEvent(MotionEvent ev) { 505e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim return mProvider.onTrackballEvent_impl(ev); 506e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 507e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 508e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim @Override 509e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public boolean onKeyDown(int keyCode, KeyEvent event) { 510e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim return mProvider.onKeyDown_impl(keyCode, event); 511e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 512e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 513e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim @Override 514e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public void onFinishInflate() { 515e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim mProvider.onFinishInflate_impl(); 516e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 517e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 518e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim @Override 519e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public boolean dispatchKeyEvent(KeyEvent event) { 520e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim return mProvider.dispatchKeyEvent_impl(event); 521e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 522e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 523e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim @Override 524e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public void setEnabled(boolean enabled) { 525e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim mProvider.setEnabled_impl(enabled); 526e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 527e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 528e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim private class SuperProvider implements ViewProvider { 529e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim @Override 530fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang public void onAttachedToWindow_impl() { 531fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang VideoView2.super.onAttachedToWindow(); 532fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang } 533fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang 534fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang @Override 535fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang public void onDetachedFromWindow_impl() { 536fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang VideoView2.super.onDetachedFromWindow(); 537fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang } 538fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang 539fd3fdfdfedd0bf8227ce4e44c0d5e5182fe8f862Insun Kang @Override 540e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public CharSequence getAccessibilityClassName_impl() { 541e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim return VideoView2.super.getAccessibilityClassName(); 542e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 543e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 544e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim @Override 545e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public boolean onTouchEvent_impl(MotionEvent ev) { 546e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim return VideoView2.super.onTouchEvent(ev); 547e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 548e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 549e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim @Override 550e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public boolean onTrackballEvent_impl(MotionEvent ev) { 551e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim return VideoView2.super.onTrackballEvent(ev); 552e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 553e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 554e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim @Override 555e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public boolean onKeyDown_impl(int keyCode, KeyEvent event) { 556e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim return VideoView2.super.onKeyDown(keyCode, event); 557e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 558e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 559e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim @Override 560e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public void onFinishInflate_impl() { 561e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim VideoView2.super.onFinishInflate(); 562e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 563e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 564e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim @Override 565e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public boolean dispatchKeyEvent_impl(KeyEvent event) { 566e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim return VideoView2.super.dispatchKeyEvent(event); 567e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 568e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim 569e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim @Override 570e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim public void setEnabled_impl(boolean enabled) { 571e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim VideoView2.super.setEnabled(enabled); 572e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 573e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim } 574e3259049872ea9000b71e8f14d4237a75bc9d606Sungsoo Lim} 575