ब्राउज़ किए जा सकने वाले खोज के नतीजे दिखाना

सभी ऐप्लिकेशन में, बोलकर खोजने की सुविधा काम करनी चाहिए. इस पेज पर बताया गया है कि आवाज़ का इस्तेमाल किए बिना खोज शुरू करने की सुविधा देकर और खोज के नतीजों की सूची दिखाकर, खोज के अनुभव को कैसे बेहतर बनाया जा सकता है. इससे लोग कोई दूसरा नतीजा चुन पाएंगे. उदाहरण के लिए, अगर सुझाया गया नतीजा सबसे ज़्यादा काम का नहीं है.

आपका मीडिया ऐप्लिकेशन, Android Auto और Android Automotive OS (AAOS) में कॉन्टेक्स्ट के हिसाब से खोज के नतीजे दिखा सकता है. ये नतीजे तब दिखते हैं, जब कोई उपयोगकर्ता खोज क्वेरी शुरू करता है या हाल ही में की गई खोज के नतीजे देखता है.

इन खोज नतीजों को दिखाने और इन्हें चालू करने के लिए:

  • अपनी सेवा के onGetRoot तरीके में, खोज की सुविधा के बारे में बताएं.

  • उपयोगकर्ता के खोज शब्दों को मैनेज करने के लिए, मीडिया ब्राउज़र सेवा में onSearch तरीके को बदलें.

  • खोज के नतीजों को टाइटल आइटम का इस्तेमाल करके व्यवस्थित करें, ताकि उन्हें आसानी से ब्राउज़ किया जा सके.

आपका ऐप्लिकेशन, कॉन्टेक्स्ट के हिसाब से खोज के नतीजे दिखा सकता है. ये नतीजे, खोज क्वेरी शुरू होने पर दिखते हैं. Android Auto और AAOS, खोज क्वेरी इंटरफ़ेस या पहले की गई क्वेरी के आधार पर उपलब्ध सुविधाओं के ज़रिए ये नतीजे दिखाते हैं. ज़्यादा जानने के लिए, बोलकर की जाने वाली कार्रवाइयों के लिए सहायता पाना लेख पढ़ें.

मीडिया आइटम देखने के लिए, **खोज के नतीजे** विकल्प के साथ वीडियो चलाने का व्यू. ये मीडिया आइटम, उपयोगकर्ता की बोलकर की गई खोज से जुड़े होते हैं

पहली इमेज. खोज के नतीजों के विकल्प के साथ, मीडिया आइटम देखने के लिए प्लेबैक व्यू. इससे उपयोगकर्ता को बोलकर की गई खोज से जुड़े मीडिया आइटम दिखते हैं.

यह बताने के लिए कि आपका ऐप्लिकेशन खोज के नतीजों को दिखाने की सुविधा देता है, अपनी सेवा के onGetRoot तरीके से दिखाए गए एक्स्ट्रा बंडल में, कॉन्स्टेंट की BROWSER_SERVICE_EXTRAS_KEY_SEARCH_SUPPORTED को शामिल करें. इसे बूलियन true पर मैप करें.

Kotlin

import androidx.media.utils.MediaConstants

@Nullable
override fun onGetRoot(
    @NonNull clientPackageName: String,
    clientUid: Int,
    @Nullable rootHints: Bundle
): BrowserRoot {
    val extras = Bundle()
    extras.putBoolean(
        MediaConstants.BROWSER_SERVICE_EXTRAS_KEY_SEARCH_SUPPORTED, true)
    return BrowserRoot(ROOT_ID, extras)
}

Java

import androidx.media.utils.MediaConstants;

@Nullable
@Override
public BrowserRoot onGetRoot(
    @NonNull String clientPackageName,
    int clientUid,
    @Nullable Bundle rootHints) {
    Bundle extras = new Bundle();
    extras.putBoolean(
        MediaConstants.BROWSER_SERVICE_EXTRAS_KEY_SEARCH_SUPPORTED, true);
    return new BrowserRoot(ROOT_ID, extras);
}

खोज के नतीजे दिखाने के लिए, मीडिया ब्राउज़र सेवा में onSearch तरीके को बदलें. जब कोई उपयोगकर्ता, खोज क्वेरी इंटरफ़ेस या खोज के नतीजों को चालू करता है, तब Android Auto और AAOS, उपयोगकर्ता के खोज के शब्दों को इस तरीके से आगे बढ़ाते हैं.

खोज के नतीजों को ज़्यादा आसानी से ब्राउज़ करने के लिए, टाइटल आइटम का इस्तेमाल किया जा सकता है. उदाहरण के लिए, अगर आपका ऐप्लिकेशन संगीत चलाता है, तो खोज के नतीजों को एल्बम, कलाकार, और गाने के हिसाब से व्यवस्थित किया जा सकता है. इस कोड स्निपेट में, onSearch मेथड को लागू करने का तरीका दिखाया गया है:

Kotlin

fun onSearch(query: String, extras: Bundle) {
  // Detach from results to unblock the caller (if a search is expensive).
  result.detach()
  object:AsyncTask() {
    internal var searchResponse:ArrayList
    internal var succeeded = false
    protected fun doInBackground(vararg params:Void):Void {
      searchResponse = ArrayList()
      if (doSearch(query, extras, searchResponse))
      {
        succeeded = true
      }
      return null
    }
    protected fun onPostExecute(param:Void) {
      if (succeeded)
      {
        // Sending an empty List informs the caller that there were no results.
        result.sendResult(searchResponse)
      }
      else
      {
        // This invokes onError() on the search callback.
        result.sendResult(null)
      }
      return null
    }
  }.execute()
}
// Populates resultsToFill with search results. Returns true on success or false on error.
private fun doSearch(
    query: String,
    extras: Bundle,
    resultsToFill: ArrayList
): Boolean {
  // Implement this method.
}

Java

@Override
public void onSearch(final String query, final Bundle extras,
                        Result<List<MediaItem>> result) {

  // Detach from results to unblock the caller (if a search is expensive).
  result.detach();

  new AsyncTask<Void, Void, Void>() {
    List>MediaItem> searchResponse;
    boolean succeeded = false;
    @Override
    protected Void doInBackground(Void... params) {
      searchResponse = new ArrayList&lt;MediaItem>();
      if (doSearch(query, extras, searchResponse)) {
        succeeded = true;
      }
      return null;
    }

    @Override
    protected void onPostExecute(Void param) {
      if (succeeded) {
       // Sending an empty List informs the caller that there were no results.
       result.sendResult(searchResponse);
      } else {
        // This invokes onError() on the search callback.
        result.sendResult(null);
      }
    }
  }.execute()
}

/** Populates resultsToFill with search results. Returns true on success or false on error. */
private boolean doSearch(String query, Bundle extras, ArrayList&lt;MediaItem> resultsToFill) {
    // Implement this method.
}