Использование API YouTube для встраивания видео в приложение Android

Реагирование на события воспроизведения и изменения состояния

В приложении вам может потребоваться предпринять некоторые действия в зависимости от событий проигрывателя YouTube, таких как буферизация, воспроизведение, пауза, поиск и остановка. Возможно, вы захотите показать пользователю сообщение или наложить вид на проигрыватель на другой вид, как только воспроизведение видео останавливается или заканчивается.

YouTubePlayer имеет следующие определения интерфейса для прослушивания таких событий:
— YouTubePlayer.PlayerStateChangeListener — Определение интерфейса для обратных вызовов, которые вызываются при изменении состояния проигрывателя высокого уровня.
— YouTubePlayer.PlaybackEventListener — Определение интерфейса для обратных вызовов, которые вызываются при возникновении событий воспроизведения видео.
— YouTubePlayer.OnFullscreenListener — определение интерфейса для обратных вызовов, которые вызываются, когда проигрыватель переключается между полноэкранным режимом включения или выключения, либо из-за нажатия пользователем кнопки полноэкранного setFullscreen(boolean) , либо из-за вызова setFullscreen(boolean) .
— YouTubePlayer.PlaylistEventListener — определение интерфейса для обратных вызовов, которые вызываются при возникновении событий, связанных со списками воспроизведения.

Мы рассмотрим первые два для этого приложения.

Добавьте следующий метод в класс MainActivity .

 private void showMessage (String message) { Toast.makeText( this , message, Toast.LENGTH_LONG).show(); } 

Это создаст Toast с сообщением, переданным в функцию. Это избавит нас от написания похожих строк кода.

Затем добавьте следующие два подкласса в класс MainActivity .

 private final class MyPlaybackEventListener implements YouTubePlayer . PlaybackEventListener { @Override public void onPlaying () { // Called when playback starts, either due to user action or call to play(). showMessage( "Playing" ); } @Override public void onPaused () { // Called when playback is paused, either due to user action or call to pause(). showMessage( "Paused" ); } @Override public void onStopped () { // Called when playback stops for a reason other than being paused. showMessage( "Stopped" ); } @Override public void onBuffering ( boolean b) { // Called when buffering starts or ends. } @Override public void onSeekTo ( int i) { // Called when a jump in playback position occurs, either // due to user scrubbing or call to seekRelativeMillis() or seekToMillis() } } private final class MyPlayerStateChangeListener implements YouTubePlayer . PlayerStateChangeListener { @Override public void onLoading () { // Called when the player is loading a video // At this point, it's not ready to accept commands affecting playback such as play() or pause() } @Override public void onLoaded (String s) { // Called when a video is done loading. // Playback methods such as play(), pause() or seekToMillis(int) may be called after this callback. } @Override public void onAdStarted () { // Called when playback of an advertisement starts. } @Override public void onVideoStarted () { // Called when playback of the video starts. } @Override public void onVideoEnded () { // Called when the video reaches its end. } @Override public void onError (YouTubePlayer.ErrorReason errorReason) { // Called when an error occurs. } } 

Выше создаются классы, которые реализуют интерфейсы YouTubePlayer.PlaybackEventListener и YouTubePlayer.PlayerStateChangeListener . Для каждого класса я реализовал методы интерфейса и добавил комментарий о том, когда вызывается обратный вызов. Вы можете выполнять любые действия, которые вы хотите в каждом обратном вызове. В нашем примере я включил вывод Toast для onPlaying() , onPaused() и onStopped() которые будут выводить сообщение при возникновении события.

Добавьте следующие переменные класса в файл MainActivity .

 private MyPlayerStateChangeListener playerStateChangeListener; private MyPlaybackEventListener playbackEventListener; 

Добавьте следующее в onCreate() для инициализации вышеуказанных объектов.

 playerStateChangeListener = new MyPlayerStateChangeListener(); playbackEventListener = new MyPlaybackEventListener(); 

Измените onInitializationSuccess() как показано. Это устанавливает слушателей на объекте YouTubePlayer .

 @Override public void onInitializationSuccess (Provider provider, YouTubePlayer player, boolean wasRestored) { player.setPlayerStateChangeListener(playerStateChangeListener); player.setPlaybackEventListener(playbackEventListener); if (!wasRestored) { player.cueVideo( "fhWaJi1Hsfo" ); // Plays https://www.youtube.com/watch?v=fhWaJi1Hsfo } } 

Запустите приложение, и вы увидите различные всплывающие сообщения, когда вы начинаете воспроизведение видео, когда вы приостанавливаете его и когда оно останавливается (по причине, отличной от приостановки, например, завершение видео или ошибка воспроизведения).

Пользовательские элементы управления плеером

Библиотека YouTube делает хорошую работу по созданию удобного в использовании пользовательского интерфейса для воспроизведения видео на YouTube. Как разработчик, вы можете пойти дальше и предоставить пользовательские элементы управления, которые дадут пользователю больший контроль над воспроизведением. Например, разрешите им переходить вперед и назад в видео или разрешите им воспроизводить следующее или предыдущее видео в списке воспроизведения.

Мы создадим элемент управления в нашем приложении, который позволит пользователю переходить к определенному времени в видео.

 <?xml version="1.0" encoding="utf-8"?> < LinearLayout xmlns:android = "http://schemas.android.com/apk/res/android" xmlns:tools = "http://schemas.android.com/tools" android:layout_width = "match_parent" android:layout_height = "match_parent" android:orientation = "vertical" tools:context = ".MainActivity" > < com.google.android.youtube.player.YouTubePlayerView android:id = "@+id/youtube_view" android:layout_width = "match_parent" android:layout_height = "wrap_content" /> < LinearLayout android:layout_width = "match_parent" android:layout_height = "wrap_content" > < EditText android:id = "@+id/seek_to_text" android:layout_width = "wrap_content" android:layout_height = "wrap_content" android:inputType = "number" android:hint = "@string/seek_to_hint" /> < Button android:id = "@+id/seek_to_button" android:text = "@string/seek_to" android:layout_width = "wrap_content" android:layout_height = "wrap_content" /> </ LinearLayout > </ LinearLayout > 

 private YouTubePlayer player; 

 this .player = player; 

 final EditText seekToText = (EditText) findViewById(R.id.seek_to_text); Button seekToButton = (Button) findViewById(R.id.seek_to_button); seekToButton.setOnClickListener( new View.OnClickListener() { @Override public void onClick (View v) { int skipToSecs = Integer.valueOf(seekToText.getText().toString()); player.seekToMillis(skipToSecs * 1000 ); } });