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:
- Android: CastDevice.hasCapabilities
- iOS: deviceCapabilities
- Chrome: chrome.cast.Capability
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 głośnością nadawcy w Lista kontrolna do projektu
- Głośność nadawcy na Androidzie
- Liczba nadawców (iOS)
- Liczba nadawców internetowych
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:
Android
MediaMetadata
przy użyciuMEDIA_TYPE_MUSIC_TRACK
i:iOS
GCKMediaMetadata
przy użyciu:GCKMediaMetadataType
GCKMediaMetadataTypeMusicTrack
i:Chrome
MediaInfo
zMusicTrackMediaMetadata
i:
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.
Zalecane podstawowe przypadki testowe
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.