Hiển thị kết quả tìm kiếm có thể xem

Tất cả ứng dụng đều phải hỗ trợ tính năng tìm kiếm bằng giọng nói. Trang này mô tả cách cải thiện hơn nữa trải nghiệm tìm kiếm bằng cách hỗ trợ việc bắt đầu tìm kiếm mà không cần giọng nói và bằng cách hiện danh sách kết quả tìm kiếm để người dùng có thể chọn một kết quả khác. Ví dụ: nếu kết quả được đề xuất không phải là kết quả phù hợp nhất.

Ứng dụng đa phương tiện của bạn có thể cung cấp kết quả tìm kiếm theo bối cảnh trong Android Auto và Android Automotive OS (AAOS). Những kết quả này xuất hiện khi người dùng bắt đầu một cụm từ tìm kiếm hoặc xem kết quả của lượt tìm kiếm gần đây nhất.

Cách bật và cung cấp những kết quả tìm kiếm này:

• Khai báo tính năng hỗ trợ tìm kiếm trong phương thức onGetRoot của dịch vụ.

• Ghi đè phương thức onSearch trong dịch vụ trình duyệt nội dung đa phương tiện để xử lý cụm từ tìm kiếm của người dùng.

• Sắp xếp kết quả tìm kiếm bằng cách sử dụng mục tiêu đề để cải thiện khả năng duyệt xem.

Ứng dụng của bạn có thể cung cấp kết quả tìm kiếm theo ngữ cảnh xuất hiện khi người dùng bắt đầu một cụm từ tìm kiếm. Android Auto và AAOS hiển thị các kết quả này thông qua giao diện truy vấn tìm kiếm hoặc thông qua các thành phần hướng đến truy vấn đã thực hiện trước đó. Để tìm hiểu thêm, hãy xem phần Hỗ trợ thao tác bằng giọng nói.

Hình 1. Khung hiển thị phát có tuỳ chọn Kết quả tìm kiếm để xem các mục nội dung đa phương tiện liên quan đến nội dung tìm kiếm bằng giọng nói của người dùng.

Để cho biết rằng ứng dụng của bạn hỗ trợ việc hiển thị kết quả tìm kiếm, hãy thêm khoá hằng số BROWSER_SERVICE_EXTRAS_KEY_SEARCH_SUPPORTED vào gói dữ liệu bổ sung do phương thức onGetRoot của dịch vụ trả về, liên kết đến giá trị Boolean 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);
}

Để cung cấp kết quả tìm kiếm, hãy ghi đè phương thức onSearch trong dịch vụ trình duyệt nội dung đa phương tiện của bạn. Android Auto và AAOS sẽ chuyển tiếp các cụm từ tìm kiếm của người dùng đến phương thức này khi người dùng gọi giao diện truy vấn tìm kiếm hoặc thành phần Kết quả tìm kiếm.

Để giúp kết quả tìm kiếm dễ xem hơn, bạn có thể sử dụng mục tiêu đề. Ví dụ: nếu ứng dụng của bạn phát nhạc, thì bạn có thể sắp xếp kết quả tìm kiếm theo đĩa nhạc, nghệ sĩ và bài hát. Đoạn mã này cho thấy cách triển khai phương thức 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.
}