xref: /aosp_15_r20/developers/build/prebuilts/androidtv/sample-inputs/README.md (revision d353a188ca6ec4b5eba25b5fbd7bcb8ce61322fb)
1*d353a188SXin Li# Sample for live TV Input Framework (TIF) on Android TV
2*d353a188SXin Li
3*d353a188SXin LiThis 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*d353a188SXin Li
5*d353a188SXin LiIt consists of:
6*d353a188SXin Li
7*d353a188SXin Li* Simple TV input: 2 channels from local video files
8*d353a188SXin Li* Rich TV input: 4 channels served from Google Cloud Storage consisting of MP4 videos, HLS stream and MPEG-DASH stream
9*d353a188SXin Li
10*d353a188SXin LiUsers can set up these TV inputs using the Live Channels app.
11*d353a188SXin Li
12*d353a188SXin Li## Dependencies
13*d353a188SXin Li* ExoPlayer: http://developer.android.com/guide/topics/media/exoplayer.html
14*d353a188SXin Li
15*d353a188SXin Li## Setup Instructions
16*d353a188SXin Li* Compile the project and install the app to your Android TV device.
17*d353a188SXin Li* 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*d353a188SXin Li* To set up the Rich TV input:
19*d353a188SXin Li    - Either click Search upon starting Live Channels app to search for channels
20*d353a188SXin Li    - Or when running Live Channels app,
21*d353a188SXin Li        + Click ENTER to bring out Recent Channels
22*d353a188SXin Li        + Click DOWN to enter TV options
23*d353a188SXin Li        + Click RIGHT to Channel sources and select it
24*d353a188SXin Li        + Click DOWN to select Rich Input and hit ENTER
25*d353a188SXin Li        + Click ADD CHANNELS NOW to add 3 channels of MP4 videos, HLS stream and MPEG-DASH stream
26*d353a188SXin Li* To watch sample channels, simply toggle UP and DOWN to switch channels
27*d353a188SXin Li* Visit Channel Sources -> Rich Input -> Settings to see mock options for input settings.
28*d353a188SXin Li
29*d353a188SXin Li## References and How to report bugs
30*d353a188SXin Li* [Android TV Developer Documentation: TV Input Framework](http://developer.android.com/training/tv/tif/index.html)
31*d353a188SXin Li
32*d353a188SXin Li## How to make contributions?
33*d353a188SXin LiPlease read and follow the steps in the CONTRIBUTING.md
34*d353a188SXin Li
35*d353a188SXin Li## License
36*d353a188SXin LiSee LICENSE
37*d353a188SXin Li
38*d353a188SXin Li## Google+
39*d353a188SXin LiAndroid TV Community Page on Google+ [https://g.co/androidtvdev](https://g.co/androidtvdev)
40*d353a188SXin Li
41*d353a188SXin Li## Change List
42*d353a188SXin LiVersion 1.0
43*d353a188SXin Li
44*d353a188SXin Li## Notice
45*d353a188SXin Li
46*d353a188SXin LiImages/videos used in this sample are courtesy of the Blender Foundation, shared under copyright or Creative Commons license.
47*d353a188SXin Li
48*d353a188SXin Li* Elephant's Dream: (c) copyright 2006, Blender Foundation / Netherlands Media Art Institute / www.elephantsdream.org
49*d353a188SXin Li* Sintel: (c) copyright Blender Foundation | www.sintel.org
50*d353a188SXin Li* Tears of Steel: (CC) Blender Foundation | mango.blender.org
51*d353a188SXin Li* Big Buck Bunny: (c) copyright 2008, Blender Foundation / www.bigbuckbunny.org
52