Zintegruj działania głosowe z aplikacją do obsługi multimediów, aby zwiększyć bezpieczeństwo i wygodę kierowcy, minimalizując rozproszenie uwagi. Gdy Android Auto lub Android Automotive OS (AAOS) wykryje i zinterpretuje działanie głosowe, przekazuje je do aplikacji za pomocą wywołania zwrotnego onPlayFromSearch.
Po otrzymaniu wywołania zwrotnego aplikacja wyszukuje treści pasujące do ciągu zapytania i rozpoczyna odtwarzanie. Aplikacja musi uwzględniać różne kategorie zapytań, takie jak gatunek, wykonawca, album, nazwa utworu, stacja radiowa lub playlista. Aplikacja musi też obsługiwać pusty ciąg zapytania, który oznacza ogólne żądanie dotyczące muzyki.
Jeśli aplikacja odtwarza jeden element multimedialny, użytkownik może powiedzieć „Odtwórz [tytuł utworu]”, aby polecić aplikacji odtworzenie innego utworu bez patrzenia na wyświetlacz samochodu ani dotykania go. Użytkownicy mogą inicjować zapytania, klikając odpowiednie przyciski na kierownicy lub wypowiadając słowa aktywujące „OK Google”.
Gdy Android Auto lub AAOS wykryje i zinterpretuje działanie głosowe, przekazuje je do aplikacji za pomocą onPlayFromSearch. Po otrzymaniu tego wywołania zwrotnego aplikacja wyszukuje treści pasujące do ciągu znaków query, a następnie rozpoczyna odtwarzanie.
Użytkownicy mogą określać w zapytaniu różne kategorie terminów, np. gatunek, wykonawca, album, nazwa utworu, stacja radiowa lub playlista. Podczas tworzenia obsługi wyszukiwania uwzględnij wszystkie kategorie, które mają sens w przypadku Twojej aplikacji. Jeśli Android Auto lub AAOS wykryje, że dane zapytanie pasuje do określonej kategorii, dodatkowe informacje zostaną dołączone w parametrze extras. Możesz wysłać te dodatki:
Uwzględnij pusty ciąg znaków query, który może być wysyłany przez Androida Auto lub AAOS, jeśli użytkownik nie określi wyszukiwanych haseł. Jeśli na przykład użytkownik powie: „Włącz jakąś muzykę”. W takim przypadku aplikacja może rozpocząć odtwarzanie ostatnio odtwarzanego lub nowego utworu.
Jeśli aplikacja nie może szybko przetworzyć wyszukiwania, nie blokuj w onPlayFromSearch.
Zamiast tego ustaw stan odtwarzania na STATE_CONNECTING i przeprowadź wyszukiwanie w wątku asynchronicznym.
Gdy odtwarzanie się rozpocznie, możesz wypełnić kolejkę sesji multimedialnej powiązanymi treściami. Jeśli na przykład użytkownik poprosi o odtwarzanie albumu, Twoja aplikacja może wypełnić kolejkę listą utworów z tego albumu.
Oprócz zapytań typu „Odtwórz” Android Auto i AAOS rozpoznają zapytania głosowe dotyczące sterowania odtwarzaniem, takie jak „wstrzymaj muzykę” i „następny utwór”, i dopasowują te polecenia do odpowiednich wywołań zwrotnych sesji multimedialnej, np. onPause i onSkipToNext.
Więcej informacji o wdrażaniu działań odtwarzania sterowanych głosem znajdziesz w artykule Asystent Google i aplikacje multimedialne.