summaryrefslogtreecommitdiffstats
path: root/docs/html/training/tv/tif/index.jd
blob: 92b6139cee61df1fc240a1e9d1fcf1f791d16316 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
page.title=Building TV Channels
page.tags=tv, tif
helpoutsWidget=true
startpage=true

@jd:body

<div id="tb-wrapper">
<div id="tb">
  <h2>Dependencies and Prerequisites</h2>
  <ul>
    <li>Android 5.0 (API level 21) or higher</li>
  </ul>
  <h2>You should also read</h2>
  <ul>
    <li><a href="{@docRoot}reference/android/media/tv/package-summary.html">
      android.media.tv</a></li>
  </ul>
  <h2>Try It Out</h2>
  <ul>
    <li><a class="external-link" href="https://github.com/googlesamples/androidtv-sample-inputs">
      TV Input Service sample app</a></li>
  </ul>
</div>
</div>

<p>
Watching live TV shows and other continuous, channel-based content is a big part of the TV
experience. Users are accustomed to selecting and watching shows on TV by channel browsing.
To provide your users a similar experience, use the TV Input Framework to create channels for
publishing video or music content so that your media appears alongside traditional TV channels in
the programming guide.
</p>
<p>
Android supports receiving and playback of live video content through the TV Input Framework in
Android 5.0 (API level 21). This framework provides a unified method for receiving audio and video
channel content from hardware sources, such as HDMI ports and built-in-tuners, and software
sources, such as video streamed over the internet.
</p>
<p>
  The framework enables developers to define live TV input sources by implementing a TV input
  service. This service publishes a list of channels and programs to the TV Provider. The live TV
  app on a TV device gets the list of available channels and programs from the TV Provider and
  displays them to a user. When a user selects a specific channel, the live TV app creates a
  session for the associated TV input service through the TV Input Manager, and tells the TV input
  service to tune to the requested channel and play the content to a display surface provided by
  the TV app.
</p>

<img src="{@docRoot}images/tv/tv-tif-overview.png" id="figure1">
<p class="img-caption">
  <strong>Figure 1.</strong> Functional diagram of the TV Input Framework
</p>

<p>
  The TV Input Framework is designed to provide access to a wide variety of live TV input sources
  and bring them together in a single user interface for users to browse, view, and enjoy content.
  Building a TV input service for your content can help make it more accessible on TV devices.
</p>

<h2>Topics</h2>

<dl>
  <dt><b><a href="tvinput.html">Developing a TV Input Service</a></b></dt>
    <dd>Learn how to develop a TV input service, which works with the system TV app.</dd>

  <dt><b><a href="channel.html">Working with Channel Data</a></b></dt>
    <dd>Learn how to describe channel and program data for the system.</dd>

  <dt><b><a href="ui.html">Managing User Interaction</a></b></dt>
    <dd>Learn how to present overlays, manage content availability, and handle content selection.</dd>
</dl>