Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Removing info about settings activity for channel apps

Browse Source 
Settings activity is no longer supported for channel services, so
we're removing that from the docs (and the sample manifest
snippet). Note that the Setup activity is still required, and
now serves double-duty for both channel setup and channel
settings, so I adjusted the section at the end accordingly.

Added updates based on review suggestions.

Bug: 21205118
Change-Id: Ia394b83cee0cb0e7ae6caf87c9d783eb6b4e04ef
This commit is contained in:
Daniel Yu
2015-12-02 09:30:19 -08:00
parent f4de3c673f
commit d1840a36d0
1 changed files with 5 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
docs/html/training/tv/tif/tvinput.jd
View File

@@ -12,7 +12,7 @@ trainingnavtop=true
<ol>
<li><a href="#manifest">Declare Your TV Input Service in the Manifest</a></li>
<li><a href="#tvinput">Define Your TV Input Service</a></li>
<li><a href="#setup">Define Setup and Settings Activities</a></li>
<li><a href="#setup">Define Your Setup Activity</a></li>
</ol>
<h2>You should also read</h2>
<ul>
@@ -82,18 +82,14 @@ meta data are described in the following example.</p>
<p>Define the service meta data in separate XML file, as shown in the following example. The service
meta data must include a setup interface that describes the TV input's initial configuration and
channel scan. Also, the service meta data may (optionally) describe a settings activity for users to
modify the TV input's behavior. The service meta data file is located in the XML resources directory
channel scan. The service meta data file is located in the XML resources directory
for your application and must match the name of the resource in the manifest. Using the example
manifest entries above, you would create an XML file in the location
<code>res/xml/sample_tv_input.xml</code>, with the following contents:</p>
<pre>
&lt;tv-input xmlns:android="http://schemas.android.com/apk/res/android"
&lt;!-- Required: activity for setting up the input --&gt;
android:setupActivity="com.example.sampletvinput.SampleTvInputSetupActivity"
&lt;!-- Optional: activity for controlling the settings --&gt;
android:settingsActivity="com.example.sampletvinput.SampleTvInputSettingsActivity" /&gt;
android:setupActivity="com.example.sampletvinput.SampleTvInputSetupActivity" /&gt;
</pre>
<h2 id="tvinput">Define Your TV Input Service</h2>
@@ -162,16 +158,11 @@ content meta data. These <code>notify()</code> methods are described in
Control Content</a> and <a href="{@docRoot}training/tv/tif/ui.html#track">Handle Track Selection</a>
further in this training.</p>
<h2 id="setup">Define Setup and Settings Activities</h2>
<h2 id="setup">Define Your Setup Activity</h2>
<p>The system TV app works with the setup and settings activities you define for your TV input. The
<p>The system TV app works with the setup activity you define for your TV input. The
setup activity is required and must provide at least one channel record for the system database. The
system TV app will invoke the setup activity when it cannot find a channel for the TV input.
<p>The setup activity describes to the system TV app the channels made available through the TV
input, as demonstrated in the next lesson, <a href="{@docRoot}training/tv/tif/channel.html">Creating
and Updating Channel Data</a>.</p>
<p>The settings activity is optional. You can define a settings activity to turn on parental
controls, enable closed captions, set the display attributes, and so forth.</p>