JarCasting
JarCasting JarCasting

youtubetv

YouTube embedded player library for Android TV

License

License
GroupId

GroupId

fr.bmartel
ArtifactId

ArtifactId

youtubetv
Last Version

Last Version

1.2
Release Date

Release Date
Type

Type

aar
Description

Description

youtubetv
YouTube embedded player library for Android TV
Project URL

Project URL

https://github.com/bertrandmartel/youtubetv
Source Code Management

Source Code Management

https://github.com/bertrandmartel/youtubetv

Download youtubetv

Filename Size
youtubetv-1.2.pom
youtubetv-1.2.aar 105 KB
youtubetv-1.2-sources.jar 42 KB
youtubetv-1.2-javadoc.jar 129 KB
Browse

How to add to project

<!-- https://jarcasting.com/artifacts/fr.bmartel/youtubetv/ -->
<dependency>
    <groupId>fr.bmartel</groupId>
    <artifactId>youtubetv</artifactId>
    <version>1.2</version>
    <type>aar</type>
</dependency>
// https://jarcasting.com/artifacts/fr.bmartel/youtubetv/
implementation 'fr.bmartel:youtubetv:1.2'
// https://jarcasting.com/artifacts/fr.bmartel/youtubetv/
implementation ("fr.bmartel:youtubetv:1.2")
'fr.bmartel:youtubetv:aar:1.2'
<dependency org="fr.bmartel" name="youtubetv" rev="1.2">
  <artifact name="youtubetv" type="aar" />
</dependency>
@Grapes(
@Grab(group='fr.bmartel', module='youtubetv', version='1.2')
)
libraryDependencies += "fr.bmartel" % "youtubetv" % "1.2"
[fr.bmartel/youtubetv "1.2"]

Dependencies

compile (1)

Group / Artifact Type Version
com.android.support » leanback-v17 jar 25.0.1

Project Modules

There are no modules declared in this project.

YoutubeTV library

CircleCI Download Maven Central Codacy Badge Javadoc License

YouTube embedded player library for Android TV

Purpose

Download YoutubeTv library Showcase from Google Play :

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

attribute name format default value description
yt_videoId string Youtube video Id
yt_playlistId string playlist Id (if video is part of a playlist)
yt_videoQuality enum hd1080 suggested quality
yt_showNowPlayingCard boolean true define if now playing card must be shown or not
yt_showRelatedVideos boolean false display related video when video ends
yt_showVideoInfo boolean false show video info before playing video
yt_showControls enum none define if iframe control bar is shown (auto/always/none)
yt_autoHide enum alwaysVisible control iframe control bar visibility (auto/always/none)
yt_closedCaptions boolean false display closed captions
yt_closedCaptionLangPref string closed captions preference language
yt_playerLanguage string youtube player language
yt_videoAnnotation boolean false display video annotations
yt_debug boolean false active/disactive debug mode
yt_loadingBackgroundColor integer #00000000 set loading background color
yt_autoplay boolean true autoplay the video or initiate on click
yt_userAgentString string iphone(*) user agent string used for the Webview
yt_showBorder boolean false define if a thin border is shown when the View is selected
yt_borderWidth integer 2 selection border width in dp (no effect if showBorder not set)
yt_borderColor color Color.BLUE selection border color (no effect if showBorder not set)
yt_thumbnailQuality enum maxresdefault suggested quality for the thumbnail displayed before the video plays
yt_javascriptTimeout integer 1500 timeout value in ms for Javascript API that return values from JS side

(*) 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

License

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

Versions

Version
1.2
1.1