Sterowanie multimediami w interfejsie systemu

Począwszy od systemu Android 13, kontrolki multimediów w interfejsie użytkownika systemu zawierają aktualizacje przycisków akcji i zdalnego odtwarzania. Te zmiany zapewniają bardziej dopracowane sterowanie multimediami na telefonach i tabletach oraz oferują płynne przesyłanie multimediów między urządzeniami.

Aktualizacje kontroli multimediów

W tej sekcji opisano aktualizacje wprowadzone do kontrolek multimediów w systemie Android 13 dla przycisków akcji i zdalnego odtwarzania.

Zmiana przycisku akcji

Aby zapewnić użytkownikom dostęp do bogatego zestawu kontrolek multimediów dla aplikacji odtwarzających multimedia, przyciski akcji na kontrolkach multimediów dla systemu Android 13 pochodzą ze stanów akcji PlaybackState . Dzięki tej zmianie funkcja MediaDataManager#createActionsFromState generuje informacje o przycisku akcji na podstawie stanu akcji PlaybackState . Jest to zgodne z tym, jak kontrolki multimediów są renderowane na innych platformach Androida, takich jak Auto, Assistant i Wear.

Natomiast w systemie Android 12 przyciski akcji na kontrolkach multimediów zostały określone przez akcje powiadomień dodane do powiadomienia MediaStyle .

Aby zapoznać się z podsumowaniem zmian zgodnych z aplikacją dla aktualizacji przycisków akcji, zobacz StatusBarManager .

Zdalne odtwarzanie API

Aby zapewnić spójne środowisko multimedialne na różnych powierzchniach, począwszy od systemu Android 13, dodano nowy systemowy interfejs API Notification#setRemotePlaybackInfo , który oznacza powiadomienia o multimediach w interfejsie użytkownika systemu sterowania multimediami w celu zdalnego odtwarzania. Ten interfejs API umożliwia aplikacjom systemowym, które publikują powiadomienia, wykonywanie następujących czynności:

  • Dostarcza informacje i funkcje dla mediów pochodzących ze zdalnego urządzenia do domyślnego przełącznika wyjściowego w sterowaniu mediami.
  • W razie potrzeby wymień afordancję przełącznika wyjściowego.

Aplikacje systemowe korzystające z tego powiadomienia muszą mieć uprawnienie MEDIA_CONTENT_CONTROL .

Interfejs API Notification#setRemotePlaybackInfo dodaje również następujące extras w celu określenia nazwy, ikony i przeznaczenia urządzenia do odtwarzania zdalnego:

  • Notification#EXTRA_MEDIA_REMOTE_DEVICE
  • Notification#EXTRA_MEDIA_REMOTE_ICON
  • Notification#EXTRA_MEDIA_REMOTE_INTENT

Dzięki tym informacjom interfejs użytkownika systemu może zastąpić informacje o domyślnym układzie przełącznika wyjściowego i dodać sterowanie multimediami do zdalnego odtwarzania na końcu listy lokalnych elementów sterujących multimediami.

Wdrożenie kontroli mediów

Producenci OEM muszą być świadomi tej zmiany zachowania domyślnego, ponieważ wpływa ona na sposób generowania kontrolek multimediów dla aplikacji. Producenci OEM muszą również upewnić się, że nowy systemowy interfejs API działa w odpowiedni sposób w ich afordancji przełącznika wyjściowego.

Producenci OEM nie muszą wprowadzać żadnych zmian i mogą używać domyślnej implementacji w AOSP.

Dostosowanie zdalnego odtwarzania

W przypadkach, w których producent OEM ma aplikację systemową, która publikuje powiadomienia o zdalnym odtwarzaniu multimediów, aplikacja może opcjonalnie wywołać setRemotePlaybackInfo w celu powiadomienia, o ile przyznano jej uprawnienie MEDIA_CONTENT_CONTROL . Nie jest to jednak wymagane i partner może zdecydować, że nie będzie dostosowywać.

Walidacja kontroli mediów

Aby przetestować sterowanie multimediami w interfejsie użytkownika systemu, uruchom test ręczny, aby zweryfikować następujące elementy:

  • Przyciski działają zgodnie z przeznaczeniem podczas odtwarzania multimediów z aplikacji.
  • Przełącznik wyjścia wyświetla prawidłowe informacje o urządzeniu.

Użyj następujących testów, aby sprawdzić poprawność interfejsu API odtwarzania zdalnego:

Zalecenia można znaleźć w nowym wymaganiu CDD [3.8.3.1/H-1-SR].