YoutubeTV library

YouTube embedded player library for Android TV

Purpose

• to embed Youtube videos in your own Android TV application with Youtube Player API for iframe Embeds
• to provide an alternative to the lack of Youtube Android Player API on Android TV platform

Download YoutubeTv library Showcase from Google Play :

Features

• a custom view YoutubeTvView that embeds a Webview with Youtube iframe
• a custom fragment YoutubeTvFragment that holds a YoutubeTvView with a media control bar (PlaybackOverlayFragment)
• all Javascript API for iframe Embeds are available from YoutubeTvView
• video autoplay
• a video thumbnail is shown at the beginning waiting for the player to be ready
• a loading progress bar is shown waiting for the PLAY status

Include in your project

with Gradle, from jcenter :

compile 'fr.bmartel:youtubetv:1.2'

Minimum SDK : 21

YoutubeTvView

YoutubeTvView is the custom view that holds Youtube iframe inside a Webview.

Layout

<fr.bmartel.youtubetv.YoutubeTvView
    android:id="@+id/youtube_video"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    app:yt_videoId="4a5m4qF1e6Q" />

Attribute list

(*) There is currently a bug on regular android user agent string that restricts video quality to large and below. The bug doesn't affect desktop, iphone or ipad user agent string. So, in order to have quality hd720 or hd1080 we must change user agent string.

• suggested videoQuality

• auto

• tiny
• small
• medium
• large
• hd720
• hd1080
• highres
• hd1440

• hd2160

• suggested thumbnailQuality

• auto

• hqdefault
• mqdefault
• sddefault
• maxresdefault

YoutubeTvFragment

YoutubeTvFragment holds a YoutubeTvView with a PlaybackOverlayFragment that is used to display a media control bar.

Usage

• in your Activity's onCreate :

FragmentTransaction fTransaction = getFragmentManager().beginTransaction();

Bundle args = new Bundle();
args.putString("videoId", "gdgHZi347hU");
args.putString("videoQuality", "hd1080");

YoutubeTvFragment mYtFragment = YoutubeTvFragment.newInstance(args);
fTransaction.replace(R.id.youtube_fragment, mYtFragment);
fTransaction.commit();

Proguard

The following is required to keep Javascript interface from obfuscation :

-keep class fr.bmartel.youtubetv.JavascriptInterface { *; }

-keepclassmembers,allowobfuscation class fr.bmartel.youtubetv.JavascriptInterface.** {
    <methods>;
}

External libraries

• YoutubeTv library

• leanback-v17

• Showcase application

• leanback-v17
• gson
• picasso

License

The MIT License (MIT) Copyright (c) 2016 Bertrand Martel