From 9551e92507564c597a7764473945114d3c3bfff3 Mon Sep 17 00:00:00 2001 From: Jae Seo Date: Tue, 5 Aug 2014 19:06:47 -0700 Subject: [PATCH] TIF: Add explanation for TvView Bug: 16801733 Change-Id: I8fa81a850d1e29f32fdb6caa4bd3dc4b2668e18a --- media/java/android/media/tv/TvView.java | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/media/java/android/media/tv/TvView.java b/media/java/android/media/tv/TvView.java index 82761ec37573..5ff9578c9788 100644 --- a/media/java/android/media/tv/TvView.java +++ b/media/java/android/media/tv/TvView.java @@ -41,7 +41,18 @@ import android.view.ViewRootImpl; import java.util.List; /** - * View playing TV + * Displays TV contents. The TvView class provides a high level interface for applications to show + * TV programs from various TV sources that implement {@link TvInputService}. (Note that the list of + * TV inputs available on the system can be obtained by calling + * {@link TvInputManager#getTvInputList() TvInputManager.getTvInputList()}.) + *

+ * Once the application supplies the URI for a specific TV channel to {@link #tune(String, Uri)} + * method, it takes care of underlying service binding (and unbinding if the current TvView is + * already bound to a service) and automatically allocates/deallocates resources needed. In addition + * to a few essential methods to control how the contents are presented, it also provides a way to + * dispatch input events to the connected TvInputService in order to enable custom key actions for + * the TV input. + *

*/ public class TvView extends ViewGroup { private static final String TAG = "TvView"; -- 2.11.0