MediaRouter

일반 사용자 인터페이스를 사용하여 원격 수신 기기에서 미디어 표시 및 재생을 사용 설정합니다.
최근 업데이트 안정화 버전 출시 후보 버전 베타 버전 알파 버전
2023년 2월 10일 1.3.1 - 1.4.0-beta01 1.6.0-alpha01

종속 항목 선언

MediaRouter의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용은 Google Maven 저장소를 읽어보세요.

다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다.

Groovy

dependencies {
    implementation "androidx.mediarouter:mediarouter:1.4.0"
}

Kotlin

dependencies {
    implementation("androidx.mediarouter:mediarouter:1.4.0")
}

종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.

의견

제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

버전 1.6

버전 1.6.0-alpha01

2023년 2월 10일

androidx.mediarouter:mediarouter:1.6.0-alpha01이 출시되었습니다. 버전 1.6.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • 출력 전환기의 경로 목록 환경설정

API 변경사항

  • 앱이 출력 전환기를 구성하는 메커니즘.

버전 1.4

버전 1.4.0-beta01

2023년 1월 25일

androidx.mediarouter:mediarouter:1.4.0-beta01이 출시되었습니다. 버전 1.4.0-beta01에 포함된 커밋을 확인하세요.

API 변경사항

이제 전달된 경로가 SELECTED 또는 SELECTING이 아닌 경우 DynamicGroupRouteController.notifyDynamicRoutesChanged()에서 IllegalArgumentException이 발생합니다. (8f6b3e)

버그 수정

  • null 경로 제공자를 반환하는 API 준수 제공자 서비스 구현으로 인한 비정상 종료 문제를 해결했습니다. (63f16d)
  • 보호되는 broadcast receiver를 내보내기가 되지 않도록 표시하여 API 33 이상을 타겟팅하는 앱에서 작동하도록 합니다. (784f8b)
  • OverlayListView의 일부 잘못된 null 허용 여부 주석을 수정합니다. (472e3f)
  • SystemOutputSwitcherDialogController.showDialog의 EXTRA_CLOSE_ON_CONNECT로 인해 Wear 기기에서 블루투스 설정 프래그먼트가 갑자기 닫히는 버그를 수정했습니다. (28c9d8)
  • 출력 전환기 공개 메서드의 Javadoc로 변경되었습니다. (f0ae94, 44d2c9)

버전 1.4.0-alpha01

2022년 11월 9일

androidx.mediarouter:mediarouter:1.4.0-alpha01이 출시되었습니다. 버전 1.4.0-alpha01에 포함된 커밋을 확인하세요.

새로운 기능

  • SystemOutputSwitcherDialogController#showDialog를 추가하여 시스템의 출력 전환기 대화상자를 표시하거나 시스템 출력 전환기를 사용할 수 없는 Wear 기기의 블루투스 설정 프래그먼트를 표시합니다. (Ic3d78)

API 변경사항

  • MediaRouteDescriptor.Builder.clearControlFilters를 추가합니다. (I3a4e1)
  • 누락된 MainThread 주석을 MediaRouter에 추가합니다. (I3ef6e)

버그 수정

  • MediaRouter.removeUserRoute 호출로 인해 발생하는 기기별 비정상 종료 문제를 수정했습니다. (b/202931542)
  • 그룹 설명자에서 볼륨 처리 업데이트가 일관되게 수신되지 않는 문제를 수정했습니다. (461303)
  • API 33 이상에 broadcast receiver 내보내기 플래그를 추가합니다. (b2a663)
  • 플랫폼에서 잘못된 경로 설명자를 수신하여 발생하는 비정상 종료 문제를 수정했습니다. (dd5c09)

버전 1.3

버전 1.3.1

2022년 7월 27일

androidx.mediarouter:mediarouter:1.3.1이 출시되었습니다. 버전 1.3.1에 포함된 커밋을 확인하세요.

버그 수정

  • MediaRouter.removeUserRoute()에서 예기치 않은 IllegalArgumentException이 발생하는 기기 문제를 해결합니다. (b/202931542)

버전 1.3.0

2022년 4월 20일

androidx.mediarouter:mediarouter:1.3.0이 출시되었습니다. 버전 1.3.0에 포함된 커밋을 확인하세요.

1.2.0 이후 중요 변경사항

  • 런타임 시 원활한 전송을 사용 중지하는 데 사용할 수 있는 플래그를 MediaRouterParams에 추가합니다.
  • MediaRouter를 재설정할 수 있는 테스트 아티팩트를 추가했습니다.
  • MediaRouterControllerDialog에서 UX 조정을 위한 라우터 매개변수를 추가합니다.
  • 공개 메서드에 nullness 주석을 추가했습니다.
  • MissingGetterMatchingBuilder의 API 린트 검사가 androidx용으로 사용 설정되었습니다.
  • mediarouter용 코어 종속 항목을 1.6.0으로 업데이트합니다.

버전 1.3.0-rc01

2022년 3월 23일

androidx.mediarouter:mediarouter:1.3.0-rc01이 출시되었습니다. 버전 1.3.0-rc01에 포함된 커밋을 확인하세요.

  • 마지막 베타 출시 이후 변경사항이 없습니다.

버전 1.3.0-beta01

2022년 3월 9일

androidx.mediarouter:mediarouter:1.3.0-beta01이 출시되었습니다. 버전 1.3.0-beta01에 포함된 커밋을 확인하세요.

  • 마지막 알파 출시 이후 변경사항이 없습니다.

버전 1.3.0-alpha01

2021년 12월 15일

androidx.mediarouter:mediarouter:1.3.0-alpha01이 출시되었습니다. 버전 1.3.0-alpha01에 포함된 커밋을 확인하세요.

API 변경사항

  • 런타임 시 원활한 전송을 사용 중지하는 데 사용할 수 있는 플래그를 MediaRouterParams에 추가합니다. (I53d68)
  • MediaRouter를 재설정할 수 있는 테스트 아티팩트를 추가했습니다. (Id167c)
  • MediaRouterControllerDialog에서 UX 조정을 위한 라우터 매개변수를 추가합니다. (I7e574)
  • 공개 메서드에 nullness 주석을 추가했습니다. (Ifc901)

버그 수정

  • MissingGetterMatchingBuilder의 API 린트 검사가 androidx용으로 사용 설정되었습니다. (I4bbea, b/138602561)

버전 1.2

버전 1.2.6

2022년 1월 26일

androidx.mediarouter:mediarouter:1.2.6이 출시되었습니다. 버전 1.2.6에 포함된 커밋을 확인하세요.

버그 수정

  • Android 12에서 RemotePlaybackClient 생성자 비정상 종료를 수정했습니다. b/210684559

버전 1.2.5

2021년 9월 1일

androidx.mediarouter:mediarouter:1.2.5가 출시되었습니다. 버전 1.2.5에 포함된 커밋을 확인하세요.

버그 수정

  • 전송 경로가 없는 경우 출력 전환기에서 미디어 경로 버튼을 숨깁니다.
  • 그룹 구성원 경로의 볼륨 제어 문제를 해결했습니다.

버전 1.2.4

2021년 6월 16일

androidx.mediarouter:mediarouter:1.2.4가 출시되었습니다. 버전 1.2.4에 포함된 커밋을 확인하세요.

버그 수정

  • MediaRouteButton이 연결 애니메이션을 다시 재생하는 문제를 수정했습니다.
  • MediaRouteChooserDialog에서 경로의 세로 정렬 문제를 수정했습니다.

버전 1.2.3

2021년 5월 5일

androidx.mediarouter:mediarouter:1.2.3이 출시되었습니다. 버전 1.2.3에 포함된 커밋을 확인하세요.

버그 수정

  • 맞춤설정 선택기 대화상자의 NullPointerException을 수정했습니다.
  • MediaRouteButton이 일시적으로 사용 중지되면 연결되어 있더라도 연결 해제된 상태가 표시되는 문제를 수정했습니다.

버전 1.2.2

2021년 2월 10일

androidx.mediarouter:mediarouter:1.2.2가 출시되었습니다. 버전 1.2.2에 포함된 커밋을 확인하세요.

버그 수정

  • OnDynamicRouteChangedListener.onRouteChanged가 호출될 때 선택한 경로를 다시 선택해서는 안 됩니다.

버전 1.2.1

2021년 1월 13일

androidx.mediarouter:mediarouter:1.2.1이 출시되었습니다. 버전 1.2.1에 포함된 커밋을 확인하세요.

버그 수정

  • BT를 사용할 수 있는 동안 unselect()가 호출될 때 휴대전화 스피커 선택 문제를 수정했습니다.
  • MediaRouter.Callback 타이밍을 수정했습니다. OnPrepareTransferListener#onPrepareTransfer가 완료된 후 Callback#onRouteSelected 및 Callback#onRouteUnselected가 호출됩니다.

버전 1.2.0

2020년 10월 14일

androidx.mediarouter:mediarouter:1.2.0이 출시되었습니다. 버전 1.2.0에 포함된 커밋을 확인하세요.

1.1.0 이후 주요 기능

  • 시스템 UI를 통한 미디어 전송을 가능하게 하는 원활한 미디어 전송을 지원합니다. 자세한 내용은 미디어의 새로운 기능 동영상을 참고하세요.
  • 콜백 등록 안내를 변경했습니다. MediaRouter.addCallback()의 Javadoc에서 코드 예를 확인하세요.
  • 선택된 경로가 변경되려고 할 때 이벤트를 수신하도록 새로운 리스너인 MediaRouter#OnPrepareTransferListener를 추가합니다.
  • 라우팅 기능 및 UI 유형을 나타내는 MediaRouterParams를 추가합니다.
  • @RestrictTo(LIBRARY)로 내부 전용 메서드의 잠정적인 사용을 방지합니다.

버전 1.2.0-rc02

2020년 10월 1일

androidx.mediarouter:mediarouter:1.2.0-rc02가 출시되었습니다. 버전 1.2.0-rc02에 포함된 커밋을 확인하세요.

버그 수정

  • 사용자가 시스템 UI를 통한 전송을 중지할 경우 RouteController#onUnselect가 호출되지 않던 문제가 수정되었습니다.

버전 1.2.0-rc01

2020년 9월 16일

androidx.mediarouter:mediarouter:1.2.0-rc01이 출시되었습니다. 버전 1.2.0-rc01에 포함된 커밋을 확인하세요.

버그 수정

  • 블루투스 오디오 기기가 연결되었을 때 현재 전송 중인 연결이 해제되는 문제를 수정했습니다.
  • MediaRouteProvider#notifyDynamicRoutesChanged()에서 IllegalArgumentException이 발생하는 문제를 수정했습니다.
  • 출력 전환기에서 전송 중지가 작동하도록 합니다.

버전 1.2.0-beta01

2020년 9월 2일

androidx.mediarouter:mediarouter:1.2.0-beta01이 출시되었습니다. 버전 1.2.0-beta01에 포함된 커밋을 확인하세요.

새로운 기능

API 변경사항

  • MediaRouter.OnPrepareTransferListener가 ListenableFuture를 사용하도록 합니다.

버그 수정

  • 그룹 경로의 볼륨 컨트롤을 수정합니다.
  • 그룹 경로를 만들 때는 먼저 그룹 경로를 만들고 나중에 구성원 경로를 만듭니다.
  • 출력 전환기에서 '중지'가 작동하도록 합니다.
  • 예상되지 않은 콜백을 수정합니다.
    • 라우팅 세션이 만들어질 때 RouteController#onSelect
    • Cast에서 휴대전화로 전송할 때 MediaRouter.Callback#onRouteSelected
    • 그룹 경로 정보가 정확한 MediaRouter.Callback#onRouteSelected
  • 콜백이 삭제되도록 합니다.

버전 1.2.0-alpha02

2020년 7월 22일

androidx.mediarouter:mediarouter:1.2.0-alpha02가 출시되었습니다. 버전 1.2.0-alpha02에 포함된 커밋을 확인하세요.

API 변경사항

  • 선택된 경로가 요청된 경로와 다른 경우 알림을 받을 수 있도록 새로운 MediaRouter.Callback#onRouteSelected를 추가합니다. (Ieee16)
  • 선택된 경로가 변경되려고 할 때 이벤트를 수신하도록 새로운 리스너인 MediaRouter#OnPrepareTransferListener를 추가합니다. (I6ace1)
  • MediaRouterParam을 추가합니다. (I33150)
  • 콜백 등록 안내를 변경했습니다. MediaRouter.addCallback()의 Javadoc에서 코드 예를 확인하세요. (I58112)

버전 1.2.0-alpha01

2020년 4월 15일

androidx.mediarouter:mediarouter:1.2.0-alpha01가 출시되었습니다. 버전 1.2.0-alpha01에 포함된 커밋을 확인하세요.

API 변경사항

  • @RestrictTo(LIBRARY)로 내부 전용 메서드의 잠정적인 사용을 방지합니다.

버그 수정

  • 전송 대화상자의 TalkBack 문제가 해결되었습니다.
  • Lock으로 DynamicGroupRouterController의 리스너를 보호합니다.

버전 1.1

버전 1.1.0

2019년 9월 5일

androidx.mediarouter:mediarouter:1.1.0이 출시되었습니다. 이 버전에 포함된 커밋은 여기에서 확인할 수 있습니다.

1.0.0 이후 중요 변경사항

  • 동적 그룹 지원
    • 사용자가 경로 기기를 동적으로 추가하거나 삭제할 수 있습니다.
    • 동적 그룹을 사용 설정하려면 MediaRouteButton.enableDynamicGroup()을 호출합니다. 동적 그룹에 관한 새 대화상자가 표시됩니다.
    • 설치된 MediaRouteProvider는 실제로 기능을 사용 설정하려면 동적 그룹도 지원해야 합니다.

버전 1.1.0-rc01

2019년 6월 13일

androidx.mediarouter:mediarouter:1.1.0-rc01 버전은 1.1.0-beta02에서 변경사항 없이 출시되었습니다. 이 버전에 포함된 커밋은 여기에서 확인할 수 있습니다.

버전 1.1.0-beta02

2019년 6월 5일

androidx.mediarouter:mediarouter:1.1.0-beta02가 출시되었습니다. 이 버전에 포함된 커밋은 여기에서 확인할 수 있습니다.

새로운 기능

  • MediaRouter 대화상자에서 RTL 언어를 지원합니다.

버그 수정

  • MediaRoute 대화상자의 하단 패딩을 수정합니다.

버전 1.1.0-beta01

2019년 5월 7일

androidx.mediarouter:mediarouter:1.1.0-alpha01이 출시되었습니다. 이 버전에 포함된 커밋은 여기에서 확인할 수 있습니다.

새로운 기능

  • @NonNull로 표시되는 null 인수의 IllegalPointerException을 NullPointerException으로 변경했습니다.

API 변경사항

  • DynamicRouteDescriptor의 콜백 로직이 변경되었습니다. 이제 MediaRouteProvider는 직접 콜백 메서드를 호출하지 않고 MediaRouterProvider.DynamicGroupController.notifyDynamicRoutesChanged를 호출합니다.

버전 1.1.0-alpha03

2019년 4월 3일

androidx.mediarouter:mediarouter:1.1.0-alpha03가 출시되었습니다. 이 버전에 포함된 커밋은 여기에서 확인할 수 있습니다.

버그 수정

  • MediaRouteVolumeSlider와 RegisteredMediaRouteProvider에서 비정상 종료 문제를 해결했습니다.

버전 1.1.0-alpha02

2019년 3월 13일

androidx.mediarouter:mediarouter:1.1.0-alpha02이 출시되었습니다. 이 버전에 포함된 커밋의 전체 목록은 여기에서 확인할 수 있습니다.

새로운 기능

  • Android 스튜디오 레이아웃 미리보기에서 MediaRouteButton을 지원합니다.

API 변경사항

  • 동적 그룹 기능을 사용 설정하도록 MediaRouteActionProvider 및 MediaRouteButton에 enableDynamicGroup() 메서드를 추가했습니다.
  • MediaRouteButton이 항상 표시되도록 MediaRouteActionProvider 및 MediaRouteButton에 setAlwaysVisible(boolean) 메서드를 추가했습니다.

버그 수정

  • MediaRouteCastDialog 행을 클릭하기 쉽도록 만들었습니다.
  • 불필요한 onRouteChanged 콜백 호출을 삭제했습니다.

버전 1.1.0-alpha01

2018년 12월 3일

새로운 기능

  • 동적 그룹 경로 지원을 추가했습니다.
    • MediaRouteProviders에 의한 동적 그룹 경로를 지원하는 API를 추가했습니다.
    • 동적 그룹 경로의 경로 선택기 및 컨트롤러 대화상자를 위한 새로운 UX를 추가했습니다.