সকল অ্যাপে অবশ্যই ভয়েস সার্চের সুবিধা থাকতে হবে। এই পৃষ্ঠায় বর্ণনা করা হয়েছে কীভাবে ভয়েস ছাড়াই সার্চ শুরু করার সুবিধা দিয়ে এবং সার্চ ফলাফলের একটি তালিকা দেখিয়ে সার্চের অভিজ্ঞতাকে আরও উন্নত করা যায়, যাতে ব্যবহারকারীরা অন্য কোনো ফলাফল বেছে নিতে পারেন। উদাহরণস্বরূপ, যদি প্রস্তাবিত ফলাফলটি সবচেয়ে প্রাসঙ্গিক না হয়।
আপনার মিডিয়া অ্যাপ অ্যান্ড্রয়েড অটো এবং অ্যান্ড্রয়েড অটোমোটিভ ওএস (AAOS)-এ প্রাসঙ্গিক অনুসন্ধানের ফলাফল প্রদান করতে পারে। যখন কোনো ব্যবহারকারী অনুসন্ধান শুরু করেন বা সাম্প্রতিকতম অনুসন্ধানের ফলাফল দেখেন, তখন এই ফলাফলগুলো প্রদর্শিত হয়।
এই অনুসন্ধানের ফলাফলগুলি সক্রিয় করতে এবং প্রদান করতে:
আপনার সার্ভিসের
onGetRootমেথডে সার্চ সাপোর্ট ঘোষণা করুন।ব্যবহারকারীর সার্চ টার্মগুলো পরিচালনা করার জন্য আপনার মিডিয়া ব্রাউজার সার্ভিসের
onSearchমেথডটি ওভাররাইড করুন।আরও সহজে ব্রাউজ করার জন্য শিরোনাম ব্যবহার করে অনুসন্ধানের ফলাফল সাজান।
আপনার অ্যাপ প্রাসঙ্গিক অনুসন্ধানের ফলাফল প্রদান করতে পারে, যা কোনো অনুসন্ধান শুরু করার সাথে সাথে প্রদর্শিত হয়। অ্যান্ড্রয়েড অটো এবং AAOS এই ফলাফলগুলো সার্চ কোয়েরি ইন্টারফেসের মাধ্যমে অথবা পূর্বে করা অনুসন্ধানের উপর ভিত্তি করে তৈরি অ্যাফোর্ডেন্সের মাধ্যমে দেখায়। আরও জানতে, ‘ সাপোর্ট ভয়েস অ্যাকশনস’ দেখুন।

চিত্র ১। ব্যবহারকারীর ভয়েস সার্চের সাথে সম্পর্কিত মিডিয়া আইটেমগুলো দেখার জন্য সার্চ রেজাল্ট অপশনসহ প্লেব্যাক ভিউ।
আপনার অ্যাপ যে সার্চ রেজাল্ট প্রদর্শন সমর্থন করে, তা বোঝাতে, আপনার সার্ভিসের onGetRoot মেথড দ্বারা রিটার্ন করা এক্সট্রাস বান্ডেলে BROWSER_SERVICE_EXTRAS_KEY_SEARCH_SUPPORTED কনস্ট্যান্ট কী-টি অন্তর্ভুক্ত করুন, যা বুলিয়ান ' true এর সাথে ম্যাপ করা থাকবে।
কোটলিন
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)
}
জাভা
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 মেথডটি ওভাররাইড করুন। যখন কোনো ব্যবহারকারী সার্চ কোয়েরি ইন্টারফেস বা সার্চ রেজাল্টস অ্যাফোর্ডেন্স চালু করেন, তখন অ্যান্ড্রয়েড অটো এবং AAOS ব্যবহারকারীর সার্চ টার্মগুলো এই মেথডে পাঠিয়ে দেয়।
সার্চ রেজাল্টগুলোকে আরও সহজে ব্রাউজ করার জন্য, আপনি টাইটেল আইটেম ব্যবহার করতে পারেন। উদাহরণস্বরূপ, যদি আপনার অ্যাপ গান বাজায়, তাহলে আপনি অ্যালবাম, শিল্পী এবং গান অনুযায়ী সার্চ রেজাল্টগুলো সাজাতে পারেন। এই কোড স্নিপেটটি onSearch মেথডের একটি প্রয়োগ দেখাচ্ছে:
কোটলিন
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.
}
জাভা
@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<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<MediaItem> resultsToFill) {
// Implement this method.
}