README.md
1 # Sample for live TV Input Framework (TIF) on Android TV
2
3 This app is designed to show how to build live TV apps for Android TV. The sample is a service that once installed, it's recognized and run by the default TV app.
4
5 It consists of:
6
7 * Simple TV input: 2 channels from local video files
8 * Rich TV input: 4 channels served from Google Cloud Storage consisting of MP4 videos, HLS stream and MPEG-DASH stream
9
10 Users can set up these TV inputs using the Live Channels app.
11
12 ## Dependencies
13 * ExoPlayer: http://developer.android.com/guide/topics/media/exoplayer.html
14
15 ## Setup Instructions
16 * Compile the project and install the app to your Android TV device.
17 * Start the pre-installed system app Live Channels (which does not show up in Apps on Home screen until there is at least one TV input service or a physical input like HDMI1).
18 * To set up the Rich TV input:
19 - Either click Search upon starting Live Channels app to search for channels
20 - Or when running Live Channels app,
21 + Click ENTER to bring out Recent Channels
22 + Click DOWN to enter TV options
23 + Click RIGHT to Channel sources and select it
24 + Click DOWN to select Rich Input and hit ENTER
25 + Click ADD CHANNELS NOW to add 3 channels of MP4 videos, HLS stream and MPEG-DASH stream
26 * To watch sample channels, simply toggle UP and DOWN to switch channels
27 * Visit Channel Sources -> Rich Input -> Settings to see mock options for input settings.
28
29 ## References and How to report bugs
30 * [Android TV Developer Documentation: TV Input Framework](http://developer.android.com/training/tv/tif/index.html)
31
32 ## How to make contributions?
33 Please read and follow the steps in the CONTRIBUTING.md
34
35 ## License
36 See LICENSE
37
38 ## Google+
39 Android TV Community Page on Google+ [https://g.co/androidtvdev](https://g.co/androidtvdev)
40
41 ## Change List
42 Version 1.0
43
44 ## Notice
45
46 Images/videos used in this sample are courtesy of the Blender Foundation, shared under copyright or Creative Commons license.
47
48 * Elephant's Dream: (c) copyright 2006, Blender Foundation / Netherlands Media Art Institute / www.elephantsdream.org
49 * Sintel: (c) copyright Blender Foundation | www.sintel.org
50 * Tears of Steel: (CC) Blender Foundation | mango.blender.org
51 * Big Buck Bunny: (c) copyright 2008, Blender Foundation / www.bigbuckbunny.org
52