Urządzenia audio

Google Cast na urządzenia audio obsługuje tylko odtwarzanie dźwięku. Tematy w tym przewodniku: zoptymalizować aplikacje Cast pod kątem urządzeń obsługujących tylko dźwięk i wykorzystać mniejsze wymagania dotyczące wykorzystania pamięci, procesora i przepustowości sieci.

Aplikacja, która obsługuje Google Cast audio, musi uwzględniać te elementy: rozważanie zakupu:

  • Google Cast na urządzenia audio nie wyświetla filmów ani grafiki. Pamiętaj jednak: Wiele urządzeń audio ma wyświetlacz do wyświetlania metadanych, np. odtwarzania (odtwarzanie lub wstrzymanie) oraz postęp. Aplikacja nie może wyświetlać kluczowe informacje o użytkowniku wyłącznie u odbiorcy; o znaczeniu krytycznym, i większość elementów interfejsu muszą być widoczne u nadawcy.
  • Aby prawidłowo uruchamiać aplikacje odbiornika internetowego, Google Cast na urządzenia audio musi nadal renderować grafikę, nawet jeśli nie jest wyświetlana. Od urządzenia mogą nie obsługiwać sprzętowych operacji graficznych, w aplikacjach odbiorników nie należy używać zaawansowanych funkcji graficznych takie jak gradienty kolorów, obrót, mieszanie alfa czy ponowne rysowanie dużych takie jak paski postępu częściej niż raz na sekundę.
  • Google Cast na urządzenia audio obsługuje tylko platformę Widevine na potrzeby praw cyfrowych Zarządzanie treściami chronionymi za pomocą systemu DRM.
  • W przypadku większości urządzeń audio Google Cast steruje aplikacją nadawcy pełnego zakresu głośności urządzenia (np. głośnika), a nie tylko głośność sygnału wejściowego źródła dźwięku w telewizorze, tak jak w przypadku Chromecasta.
  • Oprócz sterowania odtwarzaniem za pomocą urządzenia nadawcy (telefonu, przykładowa), aplikacja może być zmuszona do sterowania odtwarzaniem za pomocą własne kontrolery urządzenia, takie jak pilot, przyciski na urządzeniu lub lub zdalną.
  • Urządzenie Google Cast audio może obsługiwać wyświetlanie metadanych treści z małym ekranem LCD, wyjściem HDMI (dla soundbarów lub audio-video) w dodatku do odbiorników) lub z zewnętrznej aplikacji zdalnej interfejsu urządzenia.

Programowanie

Pierwszym krokiem przy tworzeniu aplikacji Cast obsługującej Google Cast audio jest przygotowanie aplikacji Cast do obsługi audio-wideo i upewnij się, że działa ona Chromecast. W tym dokumencie zakładamy, że masz zaprojektowaną i przetestowaną taką aplikację.

Aplikacja może obsługiwać zarówno urządzenia audio-wideo, jak i urządzenia audio. Musi wiedzieć, podczas przesyłania treści do jednego lub drugiego i podejmować działania, aby zapewnić jak największą w danej sytuacji.

Na przykład podwójne aplikacje wideo i audio (takie jak odtwarzanie plików lokalnych/NAS) (aplikacje) powinna włączyć przesyłanie na urządzenia przeznaczone tylko do odtwarzania dźwięku. odtwarza pliki audio, ale aplikacja nie powinna zezwalać użytkownikowi na wysyłanie plików wideo. do urządzenia z włączonym dźwiękiem. Aplikacja może używać funkcji interfejsy API funkcji urządzeń dla nadawców opisane poniżej, aby określić treści odpowiednie dla danego urządzenia.

Aby obsługiwać Google Cast audio, aplikacja musi:

  • Obsługuj tylko dźwięk: strumieniowe przesyłanie muzyki i plików audio, radio itp. przesyłane strumieniowo do aplikacji Web Receiver nie mogą być strumieniem wideo. Unikaj też strumieniowanie grafik i obrazów w celu skrócenia czasu uruchamiania aplikacji i wykorzystanie pamięci. Zobacz Wskazówki dotyczące wykorzystania pamięci poniżej.

  • Działa zgodnie z oczekiwaniami zarówno na urządzeniu przesyłającym, jak i zwykłym Chromecaście.

Funkcje urządzenia

Aplikacja wie, czy działa na urządzeniu obsługującym wyłącznie dźwięk, dzięki interfejsy API funkcji urządzenia dostępne z poziomu urządzenia lub za pośrednictwem nadawcy. lub odbiorników.

Nagłówek HTTP urządzenia

Nagłówek HTTP CAST-DEVICE-CAPABILITIES udostępniany przez urządzenie przesyłające w czasie uruchomienie aplikacji opisuje możliwości urządzenia. Urządzenie wysyła żądanie tym nagłówkiem do serwera hostującego aplikację odbiornika internetowego. Nagłówek urządzenie tylko dźwiękowe opisuje jego możliwości przy użyciu CAST-DEVICE-CAPABILITIES: {"display_supported":false}

Gdy serwer odbierze żądanie z urządzenia, możesz użyć metody w tym nagłówku, aby przekierować żądanie do aplikacji Web Receiver, jest zoptymalizowana pod kątem urządzeń audio.

Interfejs Web Receiver API

Możesz uzyskać ten sam obiekt możliwości urządzenia, wywołując metodę CastReceiverManager.getDeviceCapabilities() po załadowaniu aplikacji Web Receiver.

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

Interfejsy API nadawcy

Każdy z interfejsów API nadawcy Cast zawiera też informacje o możliwościach urządzenia. Dzięki nim aplikacja nadawcy może określić, jaki rodzaj multimediów ma wysłać do odbiorcy. Jeśli aplikacja obsługuje zarówno dźwięk, jak i obraz, możesz uniknąć wysyłania treści wideo do na urządzeniach tylko z dźwiękiem. Aplikacja może też regulować głośność za pomocą najbardziej odpowiednio do urządzenia, jak opisano na liście kontrolnej projektowania. Zapoznaj się z tymi interfejsami API funkcji urządzeń dla nadawców:

Wytyczne dotyczące wykorzystania pamięci

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

  • Unikaj pobierania i używania obrazów i zasobów graficznych, aby zmniejszyć ilość pamięci i skróć czas do rozpoczęcia odtwarzania.
  • Jeśli używasz rozszerzeń źródła treści (MSE), aplikacje muszą ograniczać strumień do 2 MB. Jeśli używana jest biblioteka odtwarzacza (MPL), plik cookie aplikacji rozmiar bufora strumienia jest już zdefiniowany w MPL.
  • Gdy używasz HTMLMediaElement, rozmiar bufora strumienia aplikacji jest zdefiniowany na podstawie szybkości strumieniowania. Ogranicz szybkość transmisji dźwięku do 2 megabitów na który obsługuje wszystkie kodeki opisane Obsługiwane multimedia (do 48 kHz/16 bitów).

Sterowanie głośnością

W przypadku większości urządzeń audio Google Cast to aplikacja nadawcy kontroluje pozwala ustawić pełny zakres głośności urządzenia, a nie tylko głośność wejściowego źródła dźwięku, jak w przypadku Urządzenie Chromecast. Oznacza to, że przyrosty zmian głośności muszą być mniejsze w przypadku: w aplikacjach obsługujących tylko dźwięk. W poniższych dokumentach znajdziesz wskazówki dotyczące dostarczania regulacja głośności w aplikacji:

Sterowanie urządzeniami

Urządzenia przesyłające Google Cast dla audio mogą mieć własne elementy sterujące odtwarzaniem (np. przyciski czy piloty). Korzystają one z komunikatów o odtwarzaniu multimediów zdefiniowanych dla Przestrzeń nazw urn:x-cast:com.google.cast.media, zgodnie z opisem w Komunikaty dotyczące odtwarzania multimediów – do sterowania odtwarzaniem w aplikacji odbiorcy. Aplikacja odbierająca musi obsługiwać wiadomości na temat odtwarzania multimediów, aby umożliwić obsługę elementów sterujących odtwarzaniem na urządzeniu.

Aplikacja nadawcy powinna też obsługiwać Wiadomości od odbiorcy do nadawcy. Dzięki temu, jeśli użytkownik zmieni stan multimediów za pomocą elementów sterujących urządzenia, aplikacja nadawcy może otrzymywać od odbiorcy komunikat o stanie i aktualizować UI odpowiednio się zmienia.

Wyświetlacz urządzenia

Urządzenie przesyłające Google Cast audio może mieć ekran LCD aplikacją do sterowania urządzeniami, która wyświetla metadane multimediów. Twój odbiornik aplikacja musi dostarczyć te metadane dla wszystkich ścieżek audio i zapewnić ich synchronizację z odtwarzanymi treściami, by zapewnić wyświetlanie metadanych są prawidłowo wyświetlane na wyświetlaczu. Jeśli aplikacja korzysta z niestandardowych metadanych, Musi też zawierać standardowe metadane audio (tytuł utworu, nazwę wykonawcy, album tytuł itp.) zgodnie z opisem w przypadku każdej z poniższych platform.

Odbiorca otrzymuje metadane od nadawcy w chwili załadowania multimediów. W w aplikacji nadawcy przy użyciu polecenia załadowania multimediów na odbiorniku, określ pola opisane poniżej, tak aby metadane były wyświetlane Urządzenie przesyłające Google Cast audio. Użyj tych interfejsów API:

Jeśli aplikacja Cast zarządza kolejką multimediów w odbiorniku lub w chmurze, Odbiornik internetowy musi przesyłać wszelkie aktualizacje stanu multimediów za pomocą urn:x-cast:com.google.cast.media, dzięki czemu wszyscy nadawcy będą .

Rejestracja

Musisz zarejestrować urządzenie Google Cast for audio na potrzeby testowania i zarejestrować obsługuje Google Cast dla urządzeń audio, korzystając z Konsola programisty Google Cast SDK.

  • Więcej informacji znajdziesz w sekcji Urządzenia o rejestrowaniu urządzeń.
  • Musisz zaznaczyć pole Obsługuje przesyłanie tylko na urządzenia audio, gdy rejestrując aplikację, by mogła ona wykrywać Google Cast na urządzenia audio. Zapoznaj się z sekcją Rejestrowanie aplikacji.

W przypadku nieopublikowanych aplikacji, np. używanych do testowania, musisz też wybrać opcję z obsługą urządzeń wyłącznie audio, aby aplikacja mogła wykrywać na urządzeniach tylko z dźwiękiem.

Google Cast for Audio 2.0

Google Cast for Audio (GC4A) 2.0 to platforma audio nowej generacji stworzonych z myślą o urządzeniach z małą ilością pamięci, co rozszerza ekosystem urządzeń, może przesyłać strumieniowo Twoje treści. Ponieważ GC4A 2.0 jest kierowana na platformy audio, interfejs API jest zmniejszony, aby dopasować go do urządzeń bez wyświetlacza. GC4A 2.0 jest wdrażana i istniejących głośników, które obsługują przesyłanie.

Testowanie i debugowanie

Ponieważ wszyscy obsługiwani głośniki przejdą na GC4A 2.0, ważne jest, deweloperzy aplikacji audio testują je pod kątem GC4A 2.0. Aplikację Cast możesz przetestować GC4A 2.0 na produkcyjnych głośnikach Bose Wi-Fi, JBL Charge 5 Wi-Fi, JBL Authentics, Cambridge Audio, Teuful Motiv Home, LG 2024 Soundbary.

GC4A 2.0 nie obsługuje zdalnego debugera Chrome. Jeśli chcesz debugować zalecamy korzystanie z Rejestratora debugowania.

Zalecamy przetestowanie wszystkich funkcji aplikacji w GC4A 2.0. Pamiętaj o podaniu testowanie odtwarzania wszystkich rodzajów multimediów (podcasty, strumienie itp.), wstrzymywanie, przewijanie, pomijanie treści, zmienianie playlist, zatrzymywanie i ponowne podłączanie przesyłania.

Obsługiwane interfejsy API

GC4A 2.0 obsługuje te interfejsy API:

  • HTML
  • JavaScript ECMA 6
  • DOMParser
  • XMLSerializer
  • Dokument i podklasy
  • DocumentFragment
  • & HTMLMediaElement HTMLAudioElement
  • HTMLVideoElement (może tylko odtwarzać treści audio)
  • HTMLScriptElement
  • HTMLBaseElement
  • HTMLTemplateElement
  • Elementy niestandardowe
  • Shadow DOM
  • Moduły skryptów / asynchroniczne / odroczone
  • Pobieranie / XHR
  • WebSocket
  • MessagePort
  • Pliki cookie
  • MSE (rozszerzenia źródeł multimediów)
  • Rozszerzenia zaszyfrowanych multimediów (EME)
  • Pamięć lokalna / pamięć sesji

GC4A 2.0 nie obsługuje:

  • Importowanie modułów dynamicznych (do dodania w 2024 r.)
  • CSS
  • IFrame
  • TextTracks

Kontakt

Skontaktuj się z gc4a-support-external@google.com, jeśli Potrzebujesz pomocy przy konfigurowaniu testu lub nie możesz użyć głośnika Bose.