Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 8443fad4 authored by Scott Rowe's avatar Scott Rowe
Browse files

docs: Add screenshot

Change-Id: I0995d23e1df30ce17ce381c14a6cbd2de389c396
parent d8bd117c
Loading
Loading
Loading
Loading
+208 KiB
Loading image diff...
+3 −2
Original line number Original line Diff line number Diff line
@@ -23,7 +23,7 @@ startpage=true
<p>
<p>
  TV devices offer many entertainment options for users. They have thousands of content options
  TV devices offer many entertainment options for users. They have thousands of content options
  from apps and related content services. At the same time, most users prefer to use TVs with the
  from apps and related content services. At the same time, most users prefer to use TVs with the
  least amount of input possible. With the amount of choice available to users, it is important for
  least amount of input possible. With the number of choices available to users, it is important for
  app developers to provide quick and easy paths for users to discover and enjoy your content.
  app developers to provide quick and easy paths for users to discover and enjoy your content.
</p>
</p>


@@ -44,7 +44,8 @@ startpage=true
  <dt><b><a href="recommendations.html">Recommending TV Content</a></b></dt>
  <dt><b><a href="recommendations.html">Recommending TV Content</a></b></dt>
    <dd>Learn how to recommend content for users so that it appears in the recommendations row
    <dd>Learn how to recommend content for users so that it appears in the recommendations row
      on the home screen of a TV device.</dd>
      on the home screen of a TV device.</dd>

  <dt><b><a href="searchable.html">Making TV Apps Searchable</a></b></dt>
    <dd>Learn how to make your content searchable from the Android TV home screen.</dd>
  <dt><b><a href="in-app-search.html">Searching within TV Apps</a></b></dt>
  <dt><b><a href="in-app-search.html">Searching within TV Apps</a></b></dt>
    <dd>Learn how to use a built-for-TV user interface for searching within your app.</dd>
    <dd>Learn how to use a built-for-TV user interface for searching within your app.</dd>
</dl>
</dl>
+6 −14
Original line number Original line Diff line number Diff line
@@ -109,8 +109,6 @@ view for the content, along with links to the apps of other providers. This is d


<p>Your application's database class might define the columns as follows:</p>
<p>Your application's database class might define the columns as follows:</p>


<p class="code-caption"><a href="https://github.com/googlesamples/androidtv-Leanback/blob/master/app/src/main/java/com/example/android/tvleanback/VideoDatabase.java#L41" target="_blank">
VideoDatabase.java</a></p>
<pre>
<pre>
public class VideoDatabase {
public class VideoDatabase {
  //The columns we'll include in the video database table
  //The columns we'll include in the video database table
@@ -136,8 +134,6 @@ public class VideoDatabase {
<p>When you build the map from the {@link android.app.SearchManager} columns to your data fields, you
<p>When you build the map from the {@link android.app.SearchManager} columns to your data fields, you
must also specify the {@link android.provider.BaseColumns#_ID} to give each row a unique ID.</p>
must also specify the {@link android.provider.BaseColumns#_ID} to give each row a unique ID.</p>


<p class="code-caption"><a href="https://github.com/googlesamples/androidtv-Leanback/blob/master/app/src/main/java/com/example/android/tvleanback/VideoDatabase.java#L83" target="_blank">
VideoDatabase.java</a></p>
<pre>
<pre>
...
...
  private static HashMap<String, String> buildColumnMap() {
  private static HashMap<String, String> buildColumnMap() {
@@ -195,8 +191,6 @@ java.lang.String[], java.lang.String, java.lang.String[], java.lang.String) quer
provider searches your suggestion data and returns a {@link android.database.Cursor} that points to
provider searches your suggestion data and returns a {@link android.database.Cursor} that points to
the rows you have designated for suggestions.</p>
the rows you have designated for suggestions.</p>


<p class="code-caption"><a href="https://github.com/googlesamples/androidtv-Leanback/blob/master/app/src/main/java/com/example/android/tvleanback/VideoContentProvider.java" target="_blank">
VideoContentProvider.java</a></p>
<pre>
<pre>
&#64;Override
&#64;Override
  public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs,
  public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs,
@@ -248,8 +242,6 @@ provider includes the {@code android:searchSuggestAuthority} attribute to tell t
namespace of your content provider. Also, you must set its {@code android:exported} attribute to
namespace of your content provider. Also, you must set its {@code android:exported} attribute to
{@code "true"} so that the Android global search can use the results returned from it.</p>
{@code "true"} so that the Android global search can use the results returned from it.</p>


<p class="code-caption"><a href="https://github.com/googlesamples/androidtv-Leanback/blob/master/app/src/main/AndroidManifest.xml" target="_blank">
AndroidManifest.xml</a></p>
<pre>
<pre>
&lt;provider android:name="com.example.android.tvleanback.VideoContentProvider"
&lt;provider android:name="com.example.android.tvleanback.VideoContentProvider"
    android:authorities="com.example.android.tvleanback"
    android:authorities="com.example.android.tvleanback"
@@ -294,8 +286,6 @@ question mark ({@code ?}) value is replaced with the query text.</p>
<a href="{@docRoot}guide/topics/search/searchable-config.html">{@code searchable.xml}</a>
<a href="{@docRoot}guide/topics/search/searchable-config.html">{@code searchable.xml}</a>
file:</p>
file:</p>


<p class="code-caption"><a href="https://github.com/googlesamples/androidtv-Leanback/blob/master/app/src/main/res/xml/searchable.xml" target="_blank">
Searchable.xml</a></p>
<pre>
<pre>
&lt;searchable xmlns:android="http://schemas.android.com/apk/res/android"
&lt;searchable xmlns:android="http://schemas.android.com/apk/res/android"
    android:label="@string/search_label"
    android:label="@string/search_label"
@@ -320,8 +310,6 @@ intent searches the repository for columns with the given word in their values,
of content items with those columns. In your {@code AndroidManifest.xml} file, you designate the
of content items with those columns. In your {@code AndroidManifest.xml} file, you designate the
activity which handles the {@link android.content.Intent#ACTION_SEARCH} intent like this:
activity which handles the {@link android.content.Intent#ACTION_SEARCH} intent like this:


<p class="code-caption"><a href="https://github.com/googlesamples/androidtv-Leanback/blob/master/app/src/main/AndroidManifest.xml" target="_blank">
AndroidManifest.xml</a></p>
<pre>
<pre>
...
...
  &lt;activity
  &lt;activity
@@ -361,8 +349,12 @@ Suggestions</a> and mapped the {@link android.app.SearchManager#SUGGEST_COLUMN_T
{@link android.app.SearchManager#SUGGEST_COLUMN_CONTENT_TYPE}, and
{@link android.app.SearchManager#SUGGEST_COLUMN_CONTENT_TYPE}, and
{@link android.app.SearchManager#SUGGEST_COLUMN_PRODUCTION_YEAR} fields as described in
{@link android.app.SearchManager#SUGGEST_COLUMN_PRODUCTION_YEAR} fields as described in
<a href="#columns">Identify Columns</a>, a <a href="{@docRoot}training/app-indexing/deep-linking.html">
<a href="#columns">Identify Columns</a>, a <a href="{@docRoot}training/app-indexing/deep-linking.html">
deep link</a> to your content appears in the details screen that launches when the user selects a
deep link</a> to a watch action for your content appears in the details screen that launches when
search result.</p>
the user selects a search result, as shown in figure 1.</p>

<img itemprop="image" src="{@docRoot}images/tv/deep-link.png" alt="Deep link in the details screen"/>
<p class="img-caption"><b>Figure 1.</b> The details screen displays a deep link for the
Videos by Google (Leanback) sample app. Sintel: &copy; copyright Blender Foundation, www.sintel.org.</p>


<p>When the user selects the link for your app, identified by the "Available On" button in the
<p>When the user selects the link for your app, identified by the "Available On" button in the
details screen, the system launches the activity which handles the {@link android.content.Intent#ACTION_VIEW}
details screen, the system launches the activity which handles the {@link android.content.Intent#ACTION_VIEW}