Android TV Leanback (八)(引导步骤)
对于用户,应用存在多步任务。例如:你的应用可能需要引导用户购买额外的内容,建立复杂的设置,简单的确认。所有这些任务都要求用户通过一个或多个有序的步骤或决策。
v17 Leanback support library 提供了实现多步任务的类。下面讨论使用 GuidedStepFragment引导用户完成一系列决策和复杂任务。
提供步骤的详细信息
一个GuidedStepFragment代表一系列步骤中的一步。在视觉上,它提供了一个带有步骤信息的左侧的指导视图。在右边,GuidedStepFragment提供的视图包含了一系列可能的行动或这一步的决策。
在多步任务的每一步中,继承GuidedStepFragment并提供步骤信息和用户能做的行为。重写onCreateGuidance()并且返回一个包含标题、描述、图标的 GuidanceStylist.Guidance。
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的onCreat方法中通过调用GuidedStepFragment.add()方法添加GuidedStepFragment的子类。如果你的Activity只包含GuidedStepFragment对象,使用GuidedStepFragment.addAsRoot()替代add()添加第一个GuidedStepFragment。使用addAsRoot()可以确保用户在第一个GuidedStepFragment按返回键时,可以使GuidedStepFragment和父Activity一起关闭。
@Override
public void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);getWindow().setBackgroundDrawableResource(R.drawable.wizard_background_blackned);GuidedStepFragment fragment = new WizardExample1stStepFragment();fragment.setArguments(getIntent().getExtras()); // Delegate Movie to first step.GuidedStepFragment.addAsRoot(this, fragment, android.R.id.content);
}
创建并处理用户行为
添加用户行为通过重写onCreateActions()。为每一项行为添加一个新的GuidedAction,并提供行为的标题、描述和ID。使用GuidedAction.Builder添加一个新的行为。
@Override
public void onCreateActions(List<GuidedAction> actions, Bundle savedInstanceState) {
// Add "Continue" user action for this step
actions.add(new GuidedAction.Builder().id(CONTINUE).title(getString(R.string.guidedstep_continue)).description(getString(R.string.guidedstep_letsdoit)).hasNext(true).build());
...
操作不限于单行选择。下面是您可以创建的其他操作类型:
* 添加信息标签的操作,通过设置infoOnly(true)。如果infoOnly设置为true,用户将不能选中该操作,目的是根据用户的选项提供额外的信息。
* 添加一个文本编辑操作,通过设置editable(true)。当设置为true时,用户可以使用遥控器或连接的键盘输入文本。重写 onGuidedActionEdited()或onGuidedActionEditedAndProceed()可以得到用户输入后的修改文本。
* 添加一组操作,像单选按钮一样。通过一个共同的ID和checkSetId()。
* 添加一个日期选择操作,使用 GuidedDatePickerAction.Builder。
* 添加一个操作,以响应让用户从一个扩展的选项列表中选择(类似多级菜单)。
* 添加一个按钮操作,该动作出现在操作列表的右边,并且很容易访问。
为了响应操作,重写onGuidedActionClicked()和 GuidedAction的传递过程。
添加子操作
一些操作可能给用户一组额外的选项。一个GuidedAction可以指定列表的子操作,显示为一个操作的下拉列表。
添加子操作,首先创建和并填充一个列表的GuidedActions:
List<GuidedAction> subActions = new ArrayList<GuidedAction>();
subActions.add(new GuidedAction.Builder().id(SUBACTION1).title(getString(R.string.guidedstep_subaction1_title)).description(getString(R.string.guidedstep_subaction1_desc)).build());
...
在onCreatActions()中,创建一个顶层GuidedAction,当选中时,显示字操作列表:
@Override
public void onCreateActions(List<GuidedAction> actions, Bundle savedInstanceState) {...actions.add(new GuidedAction.Builder().id(SUBACTIONS).title(getString(R.string.guidedstep_subactions_title)).description(getString(R.string.guidedstep_subactions_desc)).subActions(subActions).build());...
}
最后,重写onSubGuidedActionClicked()用于响应子操作被选中:
@Override
public boolean onSubGuidedActionClicked(GuidedAction action) {// Check for which action was clicked, and handle as neededif (action.getId() == SUBACTION1) {// Subaction 1 selected}// Return true to collapse the subactions drop-down list, or// false to keep the drop-down list expanded.return true;
}
添加按钮操作
如果你的引导步骤有大量的操作列表,用户可能需要滚动列表以访问最常用的操作。使用按钮操作从动作列表中分离常用操作。按钮操作出现在操作列表的右边并且很容易导航到。
按钮操作的创建和就像普通的行动来处理,但是你创造的onCreateButtonActions()按钮的动作而不是onCreateActions()。
引导步骤组导入一个引导序列
一个GuidedStepFragment代表一个单独的步骤,然而你可能在一个有序的序列有几个步骤。
@Override
public void onGuidedActionClicked(GuidedAction action) {FragmentManager fm = getFragmentManager();if (action.getId() == CONTINUE) {GuidedStepFragment.add(fm, new SecondStepFragment());}
...
如果用户按电视机遥控器的后退按钮,设备会显示堆栈上之前的GuidedStepFragment。如果你决定要提供自己的GuidedAction返回到上一步,你可以通过调用getFragmentManager().popbackstack()实现返回行为。
如果你需要返回用户在序列中的更早一步,可使用popBackStackToGuidedStepFragment()回到堆栈中的特定GuidedStepFragment。
当用户完成序列中的最后一步时,使用finishGuidedStepFragments()从当前栈删除所有GuidedStepFragments并返回到原来的父Activity。如果第一个GuidedStepFragment添加使用addasroot(),调用finishGuidedStepFragments()也将关闭父Activity。
自定义演示步骤
GuidedStepFragment可以使用自定义主题,控制演示的步骤,如标题文本格式或步骤转换动画。自定义主题继承Theme_Leanback_GuidedStep,提供GuidanceStylist和GuidedActionsStylist定义属性的重写的属性值。
自定义GuidedStepFragment的主题,如下:
* 使用主题通过设置父Activity的android:theme属性在manifest文件中。设置这个属性会将这个主题应用到所有的子视图。如果activity包含任何一个GuidedStepFragment,上述方法是一种最简单的应用自定义主题的方式。
* 如果你activity已经使用了自定义主题,但是你不想将GuidedStepFragment的样式应用到其他视图上,你可以对已经存在自定义属性的activity设置LeanbackGuidedStepTheme_guidedStepTheme属性。只对activity中的GuidedStepFragment对象应用。
* 如果你想在不同的activity中使用GuidedStepFragment完成相同整体的多步骤任务并希望在所有步骤中使用一致的视觉主题,重写GuidedStepFragment.onProvideTheme()返回自定义主题。
Android TV Leanback (八)(引导步骤)相关推荐
- android tv 库,Android TV Leanback 简介
TV 纵向滑动列表介绍 构建滑动列表的几种方式: ListView / RecyclerView 自定义LinearLayout/ScrollView/ViewGroup 采用leanback库 go ...
- leanback android,Android TV Leanback (五)(使用leanback创建UI)
创建浏览布局 leanback库的BrowseFragment允许您创建一个主要布局,以最少的代码浏览媒体项的类别和行. 代码示例如下: android:id="@+id/main_fram ...
- Android TV Leanback (七)(详情视图)
创建一个详情presenter Leanback library提供了视频浏览框架,你可以使用presenter控制数据在屏幕上的显示,包括视频详情.这个框架为止提供了AbstractDetailsD ...
- leanback android,Android TV之谷歌android leanback框架详解
google leanback 库简介 "Leanback" 就是靠着看的意思.是指以放松的姿势倒在沙发上.谷歌推出 android.support.v17.leanback 软件 ...
- Android TV之谷歌android leanback框架详解
google leanback 库简介 "Leanback" 就是靠着看的意思.是指以放松的姿势倒在沙发上.谷歌推出 android.support.v17.leanback 软件 ...
- Android TV APPs 的介绍与创建
最近开始接触到Andorid TV编程,发现目前这方便的资料与比较还比较少,但现在随着产品与用户的升级,涉及到Android TV与 android Watch的编程离我们越来越近了,本篇博客开始,将 ...
- 【Android】android TV开发
google翻译[https://www.jianshu.com/p/c216849986ed] Ⅰ.开始使用电视应用 为了使您的应用在电视设备上获得成功,您必须设计出可以在10英尺远的地方轻松理解的 ...
- android tv nugat,GitHub - GongXunYoung/Android-tv-widget: Android tv,盒子,投影仪 控件
Android TV 开发框架 QQ群:522186932 Leanback 框架(类似谷歌的Leanback,更简直,更方便): 键盘框架: 菜单框架: 整体目录结构 *AndroidTvWidet ...
- Android TV 开发 (1)
本文来自网易云社区 作者:孙有军 前言 这里主要记录几个TV问题的解决方案,如果对这个不感兴趣的其实就不用往下看了. 这几天有一个需求就是要求出一个TV版本的app,之前没有具体的了解Tv版的app有 ...
最新文章
- 【linux】串口编程(二)——非阻塞接收
- Python基础(7)——for循环
- 判断手机号码运营商,归属地等信息
- 【杂谈】从学员到参与书籍写作,我在有三AI学习与成长的故事
- CAN协议,系统结构和帧结构
- Intellij idea 出现错误 error:java: 无效的源发行版: 11解决方法
- 深度学习-tensorflow1.x- 理解 经过softmax_cross_entropy_with_logit后 随机梯度下降的过程
- java位运算(、|、 ~、、 、 ^)
- 如何真正让小程序,WebRTC和APP互通连麦直播
- win10输入法变成繁体字的快捷键
- ES mapping 详解
- 检索下载中/英文论文的方法
- html批量采集,批量采集网页数据 - 八爪鱼采集器
- 牛牛的旅游纪念品 动态规划背包问题
- 上海宝付高谈保险扣费如何追回
- 谈谈String.intern方法
- 学Python用什么系统?
- 数据中心交换机的五大法宝
- 「解析」Matplotlib 绘制折线图
- 删除windows系统垃圾 代码