README.md
1# Sample for live TV Input Framework (TIF) on Android TV
2
3This 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
5It 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
10Users 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?
33Please read and follow the steps in the CONTRIBUTING.md
34
35## License
36See LICENSE
37
38## Google+
39Android TV Community Page on Google+ [https://g.co/androidtvdev](https://g.co/androidtvdev)
40
41## Change List
42Version 1.0
43
44## Notice
45
46Images/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