Android Studio V3.12环境下TV开发教程
（转自Android官网https://developer.android.com/training/tv/start）
文章源自：光谷佳武 https://blog.csdn.net/jiawuhan/article/details/8062
您的应用程序可能为用户提供多步骤任务。 例如，您的应用可能需要引导用户购买额外的内容，或设置复杂的配置设置，或者只是确认一个决定。 所有这些任务都需要通过一个或多个有序的步骤或决定来步行用户。
v17 Leanback支持库提供了实现多步用户任务的类。 本课讨论如何使用GuidedStepFragment类来指导用户完成一系列任务。 GuidedStepFragment使用电视用户界面最佳做法，使多步骤任务易于理解并在电视设备上导航。
GuidedStepFragment代表一系列步骤中的一个步骤。 在视觉上，它提供了左侧的步骤信息的指导视图。 在右侧， GuidedStepFragment提供了一个包含此步骤的可能操作或决定列表的视图。
图1.一个示例引导步骤。
对于多步骤任务中的每一步，请扩展GuidedStepFragment并提供有关用户可采取的步骤和操作的上下文信息。重写onCreateGuidance()并返回一个新的GuidanceStylist.Guidance ，其中包含上下文信息，如步骤标题，描述和图标。
@覆盖 publicGuidanceStylist.Guidance onCreateGuidance（Bundled savedInstanceState）{ String title = getString（R.string.guidedstep_first_title）; String breadcrumb = getString（R.string.guidedstep_first_breadcrumb）; String description = getString（R.string.guidedstep_first_description）; Drawable icon = getActivity（）。getDrawable（R.drawable.guidedstep_main_icon_1）;返回新的GuidanceStylist.Guidance（标题，描述，面包屑，图标）; }
通过在您的activity的onCreate()方法中调用GuidedStepFragment.add() ，将GuidedStepFragment子类添加到所需的活动中。 如果您的活动仅包含GuidedStepFragment对象，请使用GuidedStepFragment.addAsRoot()而不是add()添加第一个GuidedStepFragment 。 使用addAsRoot()可确保如果用户在查看第一个GuidedStepFragment时按下电视遥控器上的后退按钮，则GuidedStepFragment和父活动都将关闭。
注意： GuidedStepFragment编程方式添加GuidedStepFragment对象，而不是在布局XML文件中。
通过覆盖onCreateActions()添加用户操作。 在您的重写中，为每个操作项目添加一个新的GuidedAction ，并提供操作字符串，描述和标识。 使用GuidedAction.Builder添加新的操作。
@覆盖 public void onCreateActions（List actions，Bundle savedInstanceState）{ //为此步骤添加“继续”用户操作 actions.add（new GuidedAction.Builder（） .ID（续） .title伪（的getString（R.string.guidedstep_continue）） .DESCRIPTION（的getString（R.string.guidedstep_letsdoit）） .hasNext（真） 。建立（））; ...
操作不限于单行选择。 以下是您可以创建的其他类型的操作：
通过设置infoOnly(true)添加信息标签操作。 如果将infoOnly设置为true，则用户无法选择操作。 要提供有关用户选择的其他信息，请使用标签操作。
通过设置editable(true)添加可编辑文本操作。 如果editable是真的，当选择操作时，用户可以使用遥控器或连接的键盘输入文本。 覆盖onGuidedActionEdited()或onGuidedActionEditedAndProceed()以获取用户输入的修改后的文本。
通过使用具有公共ID值的checkSetId()将操作分组为一组，可添加一组具有可检查单选按钮的操作。 具有相同检查集ID的同一列表中的所有操作都被视为链接。 当用户选择该组中的一个动作时，该动作将被检查，而所有其他动作变为未选中状态。
在onCreateActions()使用GuidedDatePickerAction.Builder而不是GuidedAction.Builder添加日期选择器操作。 覆盖onGuidedActionEdited()或onGuidedActionEditedAndProceed()以获取用户输入的修改日期值。
添加一个动作，使用子动作让用户从扩展的选择列表中选择。 子动作在Add子动作中描述。
添加一个按钮动作，出现在动作列表的右侧，并且可以轻松访问。 按钮操作在添加按钮操作中进行了描述。
您还可以添加一个可视指示器来指示选择操作导致新的步骤 - 通过设置hasNext(true) 。 对于您可以设置的所有不同属性，请参阅GuidedAction 。
要响应操作，请覆盖onGuidedActionClicked()并处理传入的GuidedAction 。 通过检查GuidedAction.getId()来识别选定的操作。
某些操作可能需要为用户提供一组额外的选择。 GuidedAction可以指定显示为子操作下拉列表的子操作列表。
图2.引导步骤子动作。
子动作列表可以包含常规动作或单选按钮动作，但不包含日期选择器或可编辑的文本动作。 此外，由于系统不支持多个级别的子动作，所以子动作不能拥有自己的一组子动作。 深层嵌套的操作会导致糟糕的用户体验。
要添加子动作，请首先创建并填充充当子动作的GuidedActions列表：
List subActions = new ArrayList （）; subActions.add（new GuidedAction.Builder（） .ID（SUBACTION1） .title伪（的getString（R.string.guidedstep_subaction1_title）） .DESCRIPTION（的getString（R.string.guidedstep_subaction1_desc）） 。建立（））; ...
在onCreateActions() ，创建一个顶级GuidedAction ，它将在选择时显示子动作列表：
@覆盖 public void onCreateActions（List actions，Bundle savedInstanceState）{ ... actions.add（new GuidedAction.Builder（） .ID（子动作） .title伪（的getString（R.string.guidedstep_subactions_title）） .DESCRIPTION（的getString（R.string.guidedstep_subactions_desc））.subActions（子动作） 。建立（））; ... }
最后，通过重写onSubGuidedActionClicked()来响应子操作选择：
@覆盖 public boolean onSubGuidedActionClicked（GuidedAction action）{ //检查点击哪个动作，并根据需要进行处理 if（action.getId（）== SUBACTION1）{ //选择了Subaction 1 } //返回true以折叠子活动下拉列表或 // false保持下拉列表展开。返回true; }
如果您的指导步骤中有大量操作，用户可能需要滚动列表才能访问最常用的操作。 使用按钮操作将常用操作与操作列表分开。 按钮操作显示在操作列表的右侧并易于导航到。
图3.引导式步骤按钮操作。
按钮动作的创建和处理就像常规动作一样，但是您可以在onCreateButtonActions()而不是onCreateActions()创建按钮动作。 回应onGuidedActionClicked()按钮操作。
对简单操作使用按钮操作，例如步骤之间的导航操作。 不要将日期选取器操作或其他可编辑操作用作按钮操作。另外，按钮动作不能有子动作。
GuidedStepFragment代表一个单独的步骤，但是您可能会按照有序顺序执行几个步骤。 使用GuidedStepFragment.add()将多个GuidedStepFragment对象组合在一起，以将序列中的下一个步骤添加到片段堆栈中。
@覆盖 public void onGuidedActionClicked（GuidedAction action）{ FragmentManager fm = getFragmentManager（）; if（action.getId（）== CONTINUE）{ GuidedStepFragment.add（fm，new SecondStepFragment（））; } ...
如果用户按下电视遥控器上的后退按钮，设备将在片段堆栈中显示前一个GuidedStepFragment 。 如果您决定提供返回上一步的GuidedAction ，则可以通过调用getFragmentManager().popBackStack()来实现Back行为。 如果您需要将用户返回到序列中更早的步骤，请使用popBackStackToGuidedStepFragment()返回片段堆栈中的特定GuidedStepFragment 。
当用户完成序列中的最后一步时，使用finishGuidedStepFragments()从当前堆栈中删除所有GuidedStepFragments并返回到原始父活动。 如果使用addAsRoot()添加第一个GuidedStepFragment ，则调用finishGuidedStepFragments()将关闭父活动。
GuidedStepFragment类可以使用控制表示方面的自定义主题，例如标题文本格式或步骤转换动画。 自定义主题必须继承自Theme_Leanback_GuidedStep ，并且可以为GuidanceStylist和GuidedActionsStylist定义的属性提供重写值。
要将自定义主题应用于GuidedStepFragment，请执行以下操作之一：
通过将android:theme属性设置为Android清单中的activity元素，将主题应用于父活动。 设置此属性将主题应用于所有子视图，并且是父活动仅包含GuidedStepFragment对象时应用自定义主题的最简单方法。
如果您的活动已使用自定义主题，并且您不想将GuidedStepFragment样式应用于活动中的其他视图，请将LeanbackGuidedStepTheme_guidedStepTheme属性添加到您现有的自定义活动主题中。 此属性指向只有活动中的GuidedStepFragment对象使用的自定义主题。
如果在作为同一整体多步骤任务的不同活动中使用GuidedStepFragment对象并希望在所有步骤中使用一致的视觉主题，请覆盖GuidedStepFragment.onProvideTheme()并返回您的自定义主题。
有关如何添加样式和主题的更多信息，请参阅样式和主题 。
GuidedStepFragment类使用特殊的设计师类来访问和应用主题属性。 GuidanceStylist类使用主题信息来控制左指导视图的呈现，而GuidedActionsStylist类使用主题信息来控制正确操作视图的呈现。
要定制超出自定义主题可以提供的步骤的视觉样式，请在GuidedStepFragment.onCreateGuidanceStylist()或GuidedStepFragment.onCreateActionsStylist()中GuidedStepFragment.onCreateGuidanceStylist() GuidanceStylist或GuidedActionsStylist并返回您的子类。 有关您可以在这些子类中进行自定义的详细信息，请参阅GuidanceStylist和GuidedActionsStylist的文档。
网友评论