對于用戶，應(yīng)用存在多步任務(wù)沃琅。例如：你的應(yīng)用可能需要引導(dǎo)用戶購買額外的內(nèi)容哗咆，建立復(fù)雜的設(shè)置，簡單的確認(rèn)益眉。所有這些任務(wù)都要求用戶通過一個(gè)或多個(gè)有序的步驟或決策晌柬。
v17 Leanback support library 提供了實(shí)現(xiàn)多步任務(wù)的類。下面討論使用 GuidedStepFragment引導(dǎo)用戶完成一系列決策和復(fù)雜任務(wù)郭脂。
提供步驟的詳細(xì)信息
一個(gè)GuidedStepFragment代表一系列步驟中的一步年碘。在視覺上，它提供了一個(gè)帶有步驟信息的左側(cè)的指導(dǎo)視圖展鸡。在右邊屿衅，GuidedStepFragment提供的視圖包含了一系列可能的行動(dòng)或這一步的決策。
在多步任務(wù)的每一步中莹弊，繼承GuidedStepFragment并提供步驟信息和用戶能做的行為涤久。重寫onCreateGuidance()并且返回一個(gè)包含標(biāo)題、描述忍弛、圖標(biāo)的 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方法中通過調(diào)用GuidedStepFragment.add()方法添加GuidedStepFragment的子類。如果你的Activity只包含GuidedStepFragment對象,使用GuidedStepFragment.addAsRoot()替代add()添加第一個(gè)GuidedStepFragment细疚。使用addAsRoot()可以確保用戶在第一個(gè)GuidedStepFragment按返回鍵時(shí)蔗彤，可以使GuidedStepFragment和父Activity一起關(guān)閉。
@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);
}
創(chuàng)建并處理用戶行為
添加用戶行為通過重寫onCreateActions()疯兼。為每一項(xiàng)行為添加一個(gè)新的GuidedAction然遏，并提供行為的標(biāo)題、描述和ID吧彪。使用GuidedAction.Builder添加一個(gè)新的行為待侵。
@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());
...
操作不限于單行選擇。下面是您可以創(chuàng)建的其他操作類型：
- 添加信息標(biāo)簽的操作姨裸，通過設(shè)置infoOnly(true)秧倾。如果infoOnly設(shè)置為true,用戶將不能選中該操作香拉，目的是根據(jù)用戶的選項(xiàng)提供額外的信息。
- 添加一個(gè)文本編輯操作中狂，通過設(shè)置editable(true)。當(dāng)設(shè)置為true時(shí)扑毡，用戶可以使用遙控器或連接的鍵盤輸入文本胃榕。重寫 onGuidedActionEdited()或onGuidedActionEditedAndProceed()可以得到用戶輸入后的修改文本。
- 添加一組操作瞄摊，像單選按鈕一樣勋又。通過一個(gè)共同的ID和checkSetId()。
- 添加一個(gè)日期選擇操作换帜，使用 GuidedDatePickerAction.Builder楔壤。
- 添加一個(gè)操作，以響應(yīng)讓用戶從一個(gè)擴(kuò)展的選項(xiàng)列表中選擇（類似多級菜單）惯驼。
- 添加一個(gè)按鈕操作蹲嚣，該動(dòng)作出現(xiàn)在操作列表的右邊，并且很容易訪問祟牲。
為了響應(yīng)操作隙畜，重寫onGuidedActionClicked()和 GuidedAction的傳遞過程。
添加子操作
一些操作可能給用戶一組額外的選項(xiàng)说贝。一個(gè)GuidedAction可以指定列表的子操作议惰，顯示為一個(gè)操作的下拉列表。
添加子操作乡恕，首先創(chuàng)建和并填充一個(gè)列表的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()中言询，創(chuàng)建一個(gè)頂層GuidedAction,當(dāng)選中時(shí)，顯示字操作列表：
@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()用于響應(yīng)子操作被選中：
@Override
public boolean onSubGuidedActionClicked(GuidedAction action) {
// Check for which action was clicked, and handle as needed
if (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;
}
添加按鈕操作
如果你的引導(dǎo)步驟有大量的操作列表运杭，用戶可能需要滾動(dòng)列表以訪問最常用的操作。使用按鈕操作從動(dòng)作列表中分離常用操作蛋哭。按鈕操作出現(xiàn)在操作列表的右邊并且很容易導(dǎo)航到县习。
按鈕操作的創(chuàng)建和就像普通的行動(dòng)來處理，但是你創(chuàng)造的onCreateButtonActions()按鈕的動(dòng)作而不是onCreateActions()谆趾。
引導(dǎo)步驟組導(dǎo)入一個(gè)引導(dǎo)序列
一個(gè)GuidedStepFragment代表一個(gè)單獨(dú)的步驟躁愿，然而你可能在一個(gè)有序的序列有幾個(gè)步驟。
@Override
public void onGuidedActionClicked(GuidedAction action) {
FragmentManager fm = getFragmentManager();
if (action.getId() == CONTINUE) {
GuidedStepFragment.add(fm, new SecondStepFragment());
}
...
如果用戶按電視機(jī)遙控器的后退按鈕沪蓬，設(shè)備會(huì)顯示堆棧上之前的GuidedStepFragment彤钟。如果你決定要提供自己的GuidedAction返回到上一步，你可以通過調(diào)用getFragmentManager().popbackstack()實(shí)現(xiàn)返回行為跷叉。
如果你需要返回用戶在序列中的更早一步逸雹，可使用popBackStackToGuidedStepFragment()回到堆棧中的特定GuidedStepFragment营搅。
當(dāng)用戶完成序列中的最后一步時(shí)，使用finishGuidedStepFragments()從當(dāng)前棧刪除所有GuidedStepFragments并返回到原來的父Activity梆砸。如果第一個(gè)GuidedStepFragment添加使用addasroot(),調(diào)用finishGuidedStepFragments()也將關(guān)閉父Activity转质。
自定義演示步驟
GuidedStepFragment可以使用自定義主題，控制演示的步驟帖世，如標(biāo)題文本格式或步驟轉(zhuǎn)換動(dòng)畫休蟹。自定義主題繼承Theme_Leanback_GuidedStep，提供GuidanceStylist和GuidedActionsStylist定義屬性的重寫的屬性值日矫。
自定義GuidedStepFragment的主題赂弓，如下：
- 使用主題通過設(shè)置父Activity的android:theme屬性在manifest文件中。設(shè)置這個(gè)屬性會(huì)將這個(gè)主題應(yīng)用到所有的子視圖哪轿。如果activity包含任何一個(gè)GuidedStepFragment盈魁，上述方法是一種最簡單的應(yīng)用自定義主題的方式。
- 如果你activity已經(jīng)使用了自定義主題窃诉，但是你不想將GuidedStepFragment的樣式應(yīng)用到其他視圖上杨耙，你可以對已經(jīng)存在自定義屬性的activity設(shè)置LeanbackGuidedStepTheme_guidedStepTheme屬性。只對activity中的GuidedStepFragment對象應(yīng)用飘痛。
- 如果你想在不同的activity中使用GuidedStepFragment完成相同整體的多步驟任務(wù)并希望在所有步驟中使用一致的視覺主題按脚，重寫GuidedStepFragment.onProvideTheme()返回自定義主題。
