您的应用程序可能为用户提供多步骤任务。 例如,您的应用可能需要引导用户购买额外的内容,或设置复杂的配置设置,或者只是确认一个决定。 所有这些任务都需要通过一个或多个有序的步骤或决定来步行用户。
v17 Leanback支持库提供了实现多步用户任务的类。 本课讨论如何使用GuidedStepFragment
类来指导用户完成一系列任务。 GuidedStepFragment
使用电视用户界面最佳做法,使多步骤任务易于理解并在电视设备上导航。
提供一个步骤的详细信息
GuidedStepFragment
代表一系列步骤中的一个步骤。 在视觉上,它提供了左侧的步骤信息的指导视图。 在右侧, GuidedStepFragment
提供了一个包含此步骤的可能操作或决定列表的视图。
![](https://developer.android.com/images/training/tv/playback/guided-step-screen.png)
图1.一个示例引导步骤。
对于多步骤任务中的每一步,请扩展GuidedStepFragment
并提供有关用户可采取的步骤和操作的上下文信息。重写onCreateGuidance()
并返回一个新的GuidanceStylist.Guidance
,其中包含上下文信息,如步骤标题,描述和图标。
@Override public GuidanceStylist.Guidance onCreateGuidance(Bundle 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); return new GuidanceStylist.Guidance(title, description, breadcrumb, icon); }
通过在您的activity的onCreate()
方法中调用GuidedStepFragment.add()
,将GuidedStepFragment
子类添加到所需的活动中。 如果您的活动仅包含GuidedStepFragment
对象,请使用GuidedStepFragment.addAsRoot()
而不是