Urządzenia audio

Urządzenia Google Cast dla audio obsługują tylko odtwarzanie dźwięku. Z tego przewodnika dowiesz się, jak zoptymalizować aplikacje Cast na urządzeniach obsługujących tylko dźwięk oraz wykorzystać mniejsze wymagania dotyczące pamięci, procesora i przepustowości sieci.

Aplikacja, która obsługuje Google Cast audio, musi wziąć pod uwagę te kwestie:

  • Urządzenia audio w Google Cast nie wyświetlają obrazu ani grafiki. Wiele urządzeń audio ma jednak wyświetlacz, który pokazuje metadane, takie jak stan odtwarzania (odtwarzanie lub wstrzymane) i postęp. Twoja aplikacja nie może wyświetlać tak istotnych informacji o użytkowniku tylko u odbiorcy. Istotne informacje i większość interfejsu muszą być widoczne u nadawcy.
  • Aby aplikacje Web Reader działały prawidłowo, Google Cast na urządzenia audio musi nadal renderować grafikę, nawet jeśli nie jest wyświetlana. Urządzenia mogą nie obsługiwać operacji graficznych z akceleracją sprzętową, dlatego aplikacje odbiornika powinny unikać wykonywania operacji o wysokiej rozdzielczości, takich jak gradient kolorów, obrót, mieszanie alfa czy ponowne rysowanie dużych obiektów, takich jak paski postępu, częściej niż raz na sekundę.
  • Google Cast na urządzenia audio obsługuje tylko Widevine w przypadku treści chronionych przez zarządzanie prawami cyfrowymi (DRM).
  • W przypadku większości urządzeń audio obsługujących Google Cast aplikacja nadawcy steruje pełnym zakresem głośności urządzenia (np. głośnikiem), a nie tylko głośnością wejścia źródła dźwięku do telewizora, jak w przypadku Chromecasta.
  • Oprócz sterowania odtwarzaniem za pomocą urządzenia nadawcy (np. telefonu) aplikacja może udostępniać możliwość sterowania odtwarzaniem za pomocą własnych kontrolerów urządzenia, takich jak pilot, przyciski na urządzeniu lub zewnętrzna aplikacja zdalna.
  • Urządzenie Google Cast dla audio może obsługiwać wyświetlanie metadanych treści z małym ekranem LCD, wyjściem HDMI (w przypadku soundbarów lub odbiorników audio-wideo) lub zewnętrzną aplikacją zdalną (w zależności od interfejsu użytkownika urządzenia).

Programowanie

Pierwszym krokiem w procesie tworzenia aplikacji obsługującej Google Cast audio jest opracowanie aplikacji Cast dla dźwięku i obrazu i upewnienie się, że będzie ona działać na Chromecaście. W tym dokumencie zakładamy, że aplikacja została opracowana i przetestowana.

Aplikacja może obsługiwać urządzenia audio-wideo i tylko audio. Aplikacja musi wiedzieć, kiedy jest przesyłana do innego, i podejmować odpowiednie działania, aby zapewnić użytkownikom jak najlepsze wrażenia w danej sytuacji.

Na przykład aplikacje obsługujące odtwarzanie plików audio i wideo (takie jak aplikacje lokalne/naS do odtwarzania plików) powinny umożliwiać przesyłanie na urządzenia obsługujące tylko dźwięk, ale nie powinny zezwalać użytkownikowi na przesyłanie plików wideo na urządzenie obsługujące tylko dźwięk. Aplikacja może używać opisanych poniżej interfejsów API do obsługi urządzeń dla nadawców, aby określić treści odpowiednie dla urządzenia.

Aby aplikacja obsługiwała Google Cast audio, musi spełniać te wymagania:

  • Obsługa samego dźwięku: strumieniowanie muzyki, plików audio, radia itp. Multimedia przesyłane strumieniowo do aplikacji Web Detectr nie mogą być strumieniami wideo. Unikaj też strumieniowania grafiki i obrazów, aby skrócić czas uruchamiania aplikacji i skrócić wykorzystanie pamięci. Zobacz wytyczne dotyczące wykorzystania pamięci poniżej.

  • Działa zgodnie z oczekiwaniami na urządzeniu Cast for audio, a także na zwykłym Chromecaście.

Funkcje urządzenia

Aplikacja może stwierdzić, czy aplikacja działa na urządzeniu, dzięki interfejsom API funkcji urządzenia dostępnym bezpośrednio na urządzeniu lub za pomocą interfejsów API nadawcy lub odbiorcy.

Nagłówek HTTP urządzenia

Nagłówek HTTP CAST-DEVICE-CAPABILITIES dostarczany przez urządzenie przesyłające podczas uruchamiania aplikacji opisuje jego możliwości. Urządzenie wysyła żądanie z tym nagłówkiem do serwera hostującego aplikację Web pickupr. Nagłówek urządzenia z samym dźwiękiem opisuje możliwości urządzenia w CAST-DEVICE-CAPABILITIES: {"display_supported":false}.

Gdy serwer otrzyma żądanie z urządzenia, możesz użyć informacji z tego nagłówka, aby przekierować je do aplikacji Web Received, która jest zoptymalizowana pod kątem urządzeń audio.

Web pickupr API

Możesz uzyskać ten sam obiekt możliwości urządzenia, wywołując CastReceiverManager.getDeviceCapabilities() podczas wczytywania aplikacji Web Receivedr.

Więcej informacji znajdziesz w sekcji Możliwości urządzenia.

Interfejsy API nadawców

Każdy z interfejsów API nadawców Cast zawiera też informacje o możliwościach urządzenia. Pozwoli to aplikacji nadawcy określić, jaki rodzaj multimediów wysłać do odbiorcy. Jeśli aplikacja obsługuje zarówno dźwięk, jak i obraz, może unikać wysyłania treści wideo na urządzenia, które obsługują tylko dźwięk. Poza tym aplikacja może sterować głośnością za pomocą metody najbardziej odpowiedniej dla urządzenia, zgodnie z opisem na liście kontrolnej projektowania. Zobacz te interfejsy API możliwości urządzeń dla nadawców:

Wytyczne dotyczące wykorzystania pamięci

Aplikacje internetowe odbiornika działające na urządzeniach audio muszą zarządzać wykorzystaniem pamięci w ten sposób:

  • Unikaj pobierania i używania żadnych zasobów graficznych i graficznych, aby zredukować ilość pamięci i skrócić czas do rozpoczęcia odtwarzania.
  • Gdy korzystasz z rozszerzeń multimediów (MSE), aplikacje muszą ograniczać bufor strumienia do 2 MB. Jeśli używasz biblioteki Media Player Library (MPL), rozmiar bufora strumienia aplikacji jest już zdefiniowany przez ten język.
  • Podczas korzystania z HTMLMediaElement rozmiar bufora strumienia aplikacji jest określany przez Chrome na podstawie szybkości transmisji strumieniowej. Ogranicz szybkość transmisji dźwięku do 2 megabitów na sekundę. Ta opcja obsługuje wszystkie kodeki opisane w sekcji Obsługiwane formaty multimediów (do 48 kHz/16 bitów).

Regulacja głośności

W przypadku większości urządzeń audio z Google Cast aplikacja nadawcy steruje pełnym zakresem głośności urządzenia, a nie tylko głośnością wejścia źródła dźwięku, tak jak w przypadku Chromecasta. Oznacza to, że przyrosty głośności muszą być mniejsze w przypadku aplikacji obejmujących tylko dźwięk. Wskazówki dotyczące regulowania głośności w aplikacji znajdziesz w tych dokumentach:

Sterowanie urządzeniami

Urządzenia audio Google Cast mogą mieć własne elementy sterujące odtwarzaniem (np. przyciski czy piloty). Korzystają one z komunikatów dotyczących odtwarzania multimediów zdefiniowanych dla przestrzeni nazw urn:x-cast:com.google.cast.media, zgodnie z opisem w artykule Komunikaty dotyczące odtwarzania multimediów, do sterowania odtwarzaniem w aplikacji odbierającej. Aplikacja odbierająca musi obsługiwać te komunikaty dotyczące odtwarzania multimediów, aby umożliwić działanie elementów sterujących odtwarzaniem na urządzeniu.

Poza tym aplikacja nadawcy powinna obsługiwać wiadomości od odbiorcy do nadawcy, aby gdy użytkownik zmieni stan multimediów przy użyciu elementów sterujących urządzenia, aplikacja nadawcy powinna otrzymać wiadomość o stanie od odbiorcy i odpowiednio zaktualizować interfejs.

Wyświetlacz urządzenia

Urządzenie obsługujące Google Cast dla audio może mieć ekran LCD lub specyficzną dla urządzenia aplikację sterującą, która wyświetla metadane multimediów. Aplikacja odbierająca musi udostępniać metadane wszystkich ścieżek audio oraz zadbać o to, aby były one zsynchronizowane z odtwarzanymi obecnie treściami. Dzięki temu metadane będą prawidłowo wyświetlane na wyświetlaczu. Jeśli aplikacja korzysta z niestandardowych metadanych, musi też dostarczać standardowe metadane audio (tytuł utworu, nazwę wykonawcy, tytuł albumu itp.) zgodnie z opisem dla każdej platformy.

Odbiorca otrzymuje metadane od nadawcy w chwili wczytywania multimediów. Polecenie wczytywania multimediów w aplikacji nadawcy musisz wypełnić pola opisane poniżej, aby metadane były wyświetlane na urządzeniu audio Google Cast. Użyj tych interfejsów API:

Jeśli aplikacja Cast zarządza kolejką multimediów na odbiorniku lub w chmurze, Web odbiornik musi przesyłać wszystkie aktualizacje stanu multimediów przy użyciu przestrzeni nazw urn:x-cast:com.google.cast.media, aby wszyscy nadawcy byli zsynchronizowani.

Rejestracja

Musisz zarejestrować urządzenie Google Cast w celu testowania i zarejestrować aplikację na potrzeby obsługi Google Cast w przypadku urządzeń audio w konsoli programisty Google Cast SDK.

  • Więcej informacji o rejestrowaniu urządzeń znajdziesz w sekcji Urządzenia.
  • Podczas rejestrowania aplikacji musisz zaznaczyć pole wyboru Obsługuje przesyłanie na urządzenia audio, aby umożliwić jej wykrywanie Google Cast na urządzenia audio. Zobacz Rejestrowanie aplikacji.

W przypadku nieopublikowanych aplikacji, np. używanych do testów, musisz też wybrać opcję obsługi urządzeń z samym dźwiękiem, aby aplikacja mogła wykrywać urządzenia tylko z dźwiękiem.

Google Cast for Audio 2.0

Google Cast for Audio (GC4A) 2.0 to nowa generacja platformy audio do przesyłania strumieniowego, która powstała z myślą o urządzeniach z małą ilością pamięci i rozwija ekosystem urządzeń, które mogą odtwarzać strumieniowo Twoje treści.

Ważne jest, aby deweloperzy aplikacji audio testowali swoje aplikacje przy użyciu GC4A 2.0. Aplikację Cast możesz przetestować pod kątem GC4A 2.0 na produkcyjnym głośniku Bose (np. inteligentnym głośniku Bose 500).

Jeśli potrzebujesz pomocy w przygotowaniu do testowania lub nie możesz użyć głośnika Bose, napisz na adres gc4a-support-external@google.com. Jeśli chcesz debugować aplikację, Google zaleca korzystanie z narzędzia Cast Debug Logger.