對于用戶，應(yīng)用存在多步任務(wù)。例如：你的應(yīng)用可能需要引導(dǎo)用戶購買額外的內(nèi)容，建立復(fù)雜的設(shè)置，簡單的確認(rèn)。所有這些任務(wù)都要求用戶通過一個或多個有序的步驟或決策。

v17 Leanback support library 提供了實現(xiàn)多步任務(wù)的類。下面討論使用 GuidedStepFragment引導(dǎo)用戶完成一系列決策和復(fù)雜任務(wù)。

提供步驟的詳細(xì)信息

一個GuidedStepFragment代表一系列步驟中的一步。在視覺上，它提供了一個帶有步驟信息的左側(cè)的指導(dǎo)視圖。在右邊，GuidedStepFragment提供的視圖包含了一系列可能的行動或這一步的決策。

image.png

在多步任務(wù)的每一步中，繼承GuidedStepFragment并提供步驟信息和用戶能做的行為。重寫onCreateGuidance()并且返回一個包含標(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()添加第一個GuidedStepFragment。使用addAsRoot()可以確保用戶在第一個GuidedStepFragment按返回鍵時，可以使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()。為每一項行為添加一個新的GuidedAction，并提供行為的標(biāo)題、描述和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());
...

操作不限于單行選擇。下面是您可以創(chuàng)建的其他操作類型：

• 添加信息標(biāo)簽的操作，通過設(shè)置infoOnly(true)。如果infoOnly設(shè)置為true,用戶將不能選中該操作，目的是根據(jù)用戶的選項提供額外的信息。
• 添加一個文本編輯操作，通過設(shè)置editable(true)。當(dāng)設(shè)置為true時，用戶可以使用遙控器或連接的鍵盤輸入文本。重寫 onGuidedActionEdited()或onGuidedActionEditedAndProceed()可以得到用戶輸入后的修改文本。
• 添加一組操作，像單選按鈕一樣。通過一個共同的ID和checkSetId()。
• 添加一個日期選擇操作，使用 GuidedDatePickerAction.Builder。
• 添加一個操作，以響應(yīng)讓用戶從一個擴展的選項列表中選擇（類似多級菜單）。
• 添加一個按鈕操作，該動作出現(xiàn)在操作列表的右邊，并且很容易訪問。

為了響應(yīng)操作，重寫onGuidedActionClicked()和 GuidedAction的傳遞過程。

添加子操作

一些操作可能給用戶一組額外的選項。一個GuidedAction可以指定列表的子操作，顯示為一個操作的下拉列表。

image.png

添加子操作，首先創(chuàng)建和并填充一個列表的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)建一個頂層GuidedAction,當(dāng)選中時，顯示字操作列表：

@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)步驟有大量的操作列表，用戶可能需要滾動列表以訪問最常用的操作。使用按鈕操作從動作列表中分離常用操作。按鈕操作出現(xiàn)在操作列表的右邊并且很容易導(dǎo)航到。

image.png

按鈕操作的創(chuàng)建和就像普通的行動來處理，但是你創(chuàng)造的onCreateButtonActions()按鈕的動作而不是onCreateActions()。

引導(dǎo)步驟組導(dǎo)入一個引導(dǎo)序列

一個GuidedStepFragment代表一個單獨的步驟，然而你可能在一個有序的序列有幾個步驟。

@Override
public void onGuidedActionClicked(GuidedAction action) {
    FragmentManager fm = getFragmentManager();
    if (action.getId() == CONTINUE) {
       GuidedStepFragment.add(fm, new SecondStepFragment());
    }
...

如果用戶按電視機遙控器的后退按鈕，設(shè)備會顯示堆棧上之前的GuidedStepFragment。如果你決定要提供自己的GuidedAction返回到上一步，你可以通過調(diào)用getFragmentManager().popbackstack()實現(xiàn)返回行為。
如果你需要返回用戶在序列中的更早一步，可使用popBackStackToGuidedStepFragment()回到堆棧中的特定GuidedStepFragment。

當(dāng)用戶完成序列中的最后一步時，使用finishGuidedStepFragments()從當(dāng)前棧刪除所有GuidedStepFragments并返回到原來的父Activity。如果第一個GuidedStepFragment添加使用addasroot(),調(diào)用finishGuidedStepFragments()也將關(guān)閉父Activity。

自定義演示步驟

GuidedStepFragment可以使用自定義主題，控制演示的步驟，如標(biāo)題文本格式或步驟轉(zhuǎn)換動畫。自定義主題繼承Theme_Leanback_GuidedStep，提供GuidanceStylist和GuidedActionsStylist定義屬性的重寫的屬性值。

自定義GuidedStepFragment的主題，如下：

• 使用主題通過設(shè)置父Activity的android:theme屬性在manifest文件中。設(shè)置這個屬性會將這個主題應(yīng)用到所有的子視圖。如果activity包含任何一個GuidedStepFragment，上述方法是一種最簡單的應(yīng)用自定義主題的方式。
• 如果你activity已經(jīng)使用了自定義主題，但是你不想將GuidedStepFragment的樣式應(yīng)用到其他視圖上，你可以對已經(jīng)存在自定義屬性的activity設(shè)置LeanbackGuidedStepTheme_guidedStepTheme屬性。只對activity中的GuidedStepFragment對象應(yīng)用。
• 如果你想在不同的activity中使用GuidedStepFragment完成相同整體的多步驟任務(wù)并希望在所有步驟中使用一致的視覺主題，重寫GuidedStepFragment.onProvideTheme()返回自定義主題。