시스템 UI의 미디어 컨트롤

Android 13부터 시스템 UI의 미디어 컨트롤에는 작업 버튼 및 원격 재생에 대한 업데이트가 포함됩니다. 이러한 변경 사항은 휴대폰 및 태블릿에서 보다 세련된 미디어 제어 환경을 지원하고 장치 간에 원활한 미디어 전송을 제공합니다.

미디어 컨트롤 업데이트

이 섹션에서는 작업 버튼 및 원격 재생을 위한 Android 13의 미디어 컨트롤 업데이트에 대해 설명합니다.

작업 버튼 변경 사항

사용자가 미디어를 재생하는 앱의 다양한 미디어 컨트롤에 액세스할 수 있도록 Android 13용 미디어 컨트롤의 작업 버튼은 PlaybackState 작업 상태에서 파생됩니다. 이 변경으로 인해 MediaDataManager#createActionsFromState 함수는 PlaybackState 작업 상태를 기반으로 작업 버튼 정보를 생성합니다. 이는 Auto, Assistant, Wear와 같은 다른 Android 플랫폼에서 미디어 컨트롤이 렌더링되는 방식과 일치합니다.

반면 Android 12에서는 미디어 컨트롤의 작업 버튼이 MediaStyle 알림에 추가된 알림 작업 에 의해 결정되었습니다.

작업 버튼 업데이트에 대한 앱 호환 변경 사항에 대한 요약은 StatusBarManager 를 참조하십시오.

원격 재생 API

다양한 표면에서 응집력 있는 미디어 경험을 제공하기 위해 Android 13부터 새로운 시스템 API Notification#setRemotePlaybackInfo 가 추가되어 원격 재생을 위한 미디어 컨트롤 시스템 UI의 미디어 알림을 표시합니다. 이 API를 통해 알림을 게시하는 시스템 앱은 다음을 수행할 수 있습니다.

  • 원격 장치에서 시작된 미디어에 대한 정보와 기능을 미디어 컨트롤의 기본 출력 스위처에 제공합니다.
  • 필요한 경우 출력 스위처 어포던스를 교체하십시오.

이 알림을 사용하는 시스템 앱에는 MEDIA_CONTENT_CONTROL 권한이 있어야 합니다.

Notification#setRemotePlaybackInfo API는 또한 원격 재생 장치의 이름, 아이콘 및 의도를 결정하기 위해 다음과 같은 extras 을 추가합니다.

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

이 정보를 사용하여 시스템 UI는 기본 출력 스위처 칩 장치 정보를 대체하고 원격 재생을 위한 미디어 컨트롤을 로컬 미디어 컨트롤 목록의 끝에 추가할 수 있습니다.

미디어 제어 구현

OEM은 앱에 대한 미디어 컨트롤이 생성되는 방식에 영향을 미치기 때문에 기본 동작에 대한 이러한 변경 사항을 알고 있어야 합니다. OEM은 또한 새 시스템 API가 출력 스위처 어포던스에 적용 가능한 대로 작동하는지 확인해야 합니다.

OEM은 변경할 필요가 없으며 AOSP의 기본 구현 을 사용할 수 있습니다.

원격 재생 사용자 정의

OEM에 원격 미디어 재생 알림을 게시하는 시스템 앱이 있는 경우 MEDIA_CONTENT_CONTROL 권한이 부여된 한 앱은 알림을 위해 선택적으로 setRemotePlaybackInfo 를 호출할 수 있습니다. 그러나 이것은 요구 사항이 아니며 파트너는 사용자 지정하지 않도록 선택할 수 있습니다.

미디어 제어 검증

시스템 UI에서 미디어 제어를 테스트하려면 수동 테스트를 실행하여 다음을 확인하십시오.

  • 버튼은 앱에서 미디어를 재생하는 동안 의도한 대로 작동합니다.
  • 출력 스위처는 올바른 장치 정보를 표시합니다.

다음 테스트를 사용하여 원격 재생 API의 유효성을 검사합니다.

권장 사항은 새로운 CDD 요구 사항 [3.8.3.1/H-1-SR]을 참조하십시오.