使用者在電視上使用媒體應用程式時,往往會想到特定內容。如果您的應用程式含有 大量的內容目錄,瀏覽特定作品?這不見得是最有效率的方式 讓使用者找到所需資訊搜尋介面能協助使用者找到 使用者想要的內容比瀏覽速度更快
androidx.leanback 程式庫提供一組類別,用來啟用標準搜尋介面 您的應用程式與其他電視的搜尋功能一致,並提供 語音輸入。
本指南討論如何使用 Leanback 支援,在您的應用程式中提供搜尋介面 程式庫類別。
新增搜尋動作
對媒體使用 BrowseFragment
類別時
瀏覽介面時,您可以選擇啟用搜尋介面。
存取 API在 BrowseFragment
上設定 View.OnClickListener
時,搜尋介面是顯示在版面配置中的圖示
物件。下列程式碼範例可示範這項技巧。
Kotlin
override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.browse_activity) browseFragment = fragmentManager.findFragmentById(R.id.browse_fragment) as BrowseFragment browseFragment.setOnSearchClickedListener { view -> val intent = Intent(this@BrowseActivity, SearchActivity::class.java) startActivity(intent) } browseFragment.setAdapter(buildAdapter()) }
Java
@Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.browse_activity); browseFragment = (BrowseFragment) getFragmentManager().findFragmentById(R.id.browse_fragment); ... browseFragment.setOnSearchClickedListener(new View.OnClickListener() { @Override public void onClick(View view) { Intent intent = new Intent(BrowseActivity.this, SearchActivity.class); startActivity(intent); } }); browseFragment.setAdapter(buildAdapter()); }
注意:您可以使用
setSearchAffordanceColor(int)
方法。
新增搜尋輸入內容和結果
使用者選取搜尋圖示時,系統會用
定義意圖針對搜尋活動,請使用包含
SearchFragment
。
這個片段也必須實作 SearchFragment.SearchResultProvider
顯示搜尋結果的介面。
以下程式碼範例說明如何擴充 SearchFragment
類別
提供搜尋介面和結果:
Kotlin
class MySearchFragment : SearchFragment(), SearchFragment.SearchResultProvider { private val rowsAdapter = ArrayObjectAdapter(ListRowPresenter()) private val handler = Handler() private val delayedLoad = SearchRunnable() val resultsAdapter: ObjectAdapter get() { return rowsAdapter } override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setSearchResultProvider(this) setOnItemClickedListener(getDefaultItemClickedListener()) } fun onQueryTextChange(newQuery: String): Boolean { rowsAdapter.clear() if (!TextUtils.isEmpty(newQuery)) { delayedLoad.setSearchQuery(newQuery) handler.removeCallbacks(delayedLoad) handler.postDelayed(delayedLoad, SEARCH_DELAY_MS) } return true } fun onQueryTextSubmit(query: String): Boolean { rowsAdapter.clear() if (!TextUtils.isEmpty(query)) { delayedLoad.setSearchQuery(query) handler.removeCallbacks(delayedLoad) handler.postDelayed(delayedLoad, SEARCH_DELAY_MS) } return true } companion object { private val SEARCH_DELAY_MS = 300 } }
Java
public class MySearchFragment extends SearchFragment implements SearchFragment.SearchResultProvider { private static final int SEARCH_DELAY_MS = 300; private ArrayObjectAdapter rowsAdapter; private Handler handler = new Handler(); private SearchRunnable delayedLoad; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); rowsAdapter = new ArrayObjectAdapter(new ListRowPresenter()); setSearchResultProvider(this); setOnItemClickedListener(getDefaultItemClickedListener()); delayedLoad = new SearchRunnable(); } @Override public ObjectAdapter getResultsAdapter() { return rowsAdapter; } @Override public boolean onQueryTextChange(String newQuery) { rowsAdapter.clear(); if (!TextUtils.isEmpty(newQuery)) { delayedLoad.setSearchQuery(newQuery); handler.removeCallbacks(delayedLoad); handler.postDelayed(delayedLoad, SEARCH_DELAY_MS); } return true; } @Override public boolean onQueryTextSubmit(String query) { rowsAdapter.clear(); if (!TextUtils.isEmpty(query)) { delayedLoad.setSearchQuery(query); handler.removeCallbacks(delayedLoad); handler.postDelayed(delayedLoad, SEARCH_DELAY_MS); } return true; } }
先前的程式碼範例適合與 SearchRunnable
類別搭配使用
會在獨立執行緒上執行搜尋查詢。這項技巧會確保執行速度可能很慢
哪些查詢會封鎖主使用者介面執行緒