البحث في تطبيقات التلفزيون

يضع المستخدمون في الاعتبار عادةً محتوى محددًا عند استخدام تطبيق وسائط على التلفزيون. وإذا كان تطبيقك يتضمّن كتالوجًا كبيرًا من المحتوى، قد لا يكون تصفّح عنوان معيّن الطريقة الأكثر فعالية بالنسبة إلى المستخدمين للعثور على ما يبحثون عنه. ويمكن أن تساعد واجهة البحث المستخدمين في الوصول إلى المحتوى الذي يريدونه بشكل أسرع من التصفّح.

توفر مكتبة Leanback androidx مجموعة من الفئات لتفعيل واجهة بحث عادية داخل تطبيقك تتوافق مع وظائف البحث الأخرى على التلفزيون وتوفر ميزات مثل الإدخال الصوتي.

يناقش هذا الدليل كيفية توفير واجهة بحث في تطبيقك باستخدام فصول مكتبة دعم Leanback.

إضافة إجراء بحث

عند استخدام الفئة BrowseFragment لواجهة تصفُّح وسائط، يمكنك تفعيل واجهة بحث كجزء عادي من واجهة المستخدم. واجهة البحث هي رمز يظهر في التنسيق عند ضبط View.OnClickListener على العنصر BrowseFragment. يوضح الرمز النموذجي التالي هذا الأسلوب.

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 تُجري طلب البحث في سلسلة محادثات منفصلة. يمنع هذا الأسلوب طلبات البحث التي يُحتمل أن تكون بطيئة التشغيل من حظر سلسلة التعليمات الرئيسية لواجهة المستخدم.