MediaRouter 개요

앱 내에서 MediaRouter 프레임워크를 사용하려면 MediaRouter 객체의 인스턴스를 가져오고 MediaRouter.Callback 객체를 연결하여 라우팅 이벤트를 수신 대기해야 합니다. 미디어 경로를 통해 전송된 콘텐츠는 경로와 연결된 MediaRouteProvider를 통과합니다(블루투스 출력 장치와 같은 몇 가지 특별한 경우 제외). 그림 1은 기기 간에 콘텐츠를 라우팅하는 데 사용되는 클래스를 대략적으로 보여줍니다.

그림 1. 앱에서 사용하는 주요 미디어 라우터 클래스의 개요

참고: 앱에서 Google Cast 기기를 지원하려면 Cast SDK를 사용하고 앱을 Cast 발신자로 빌드해야 합니다. MediaRouter 프레임워크를 직접 사용하는 대신 Cast 문서의 안내를 따르세요.

미디어 경로 버튼

Android 앱은 미디어 경로 버튼을 사용하여 미디어 라우팅을 제어해야 합니다. MediaRouter 프레임워크는 버튼의 표준 인터페이스를 제공하므로 사용자는 라우팅이 가능할 때 이를 인식하고 사용할 수 있습니다. 미디어 경로 버튼은 일반적으로 그림 2와 같이 앱 작업 모음의 오른쪽에 배치됩니다.

그림 2. 작업 모음의 미디어 경로 버튼

사용자가 미디어 경로 버튼을 누르면 사용 가능한 미디어 경로가 그림 3과 같이 목록에 표시됩니다.

그림 3. 미디어 경로 버튼을 누른 후 표시되는 사용 가능한 미디어 경로 목록

미디어 경로 버튼을 만들려면 다음 단계를 따르세요.

  1. AppCompatActivity 사용
  2. 미디어 경로 버튼 메뉴 항목 정의
  3. MediaRouteSelector 만들기
  4. 미디어 경로 버튼을 작업 모음에 추가
  5. 활동의 수명 주기에서 MediaRouter.Callback 메서드 만들기 및 관리

이 섹션에서는 처음 네 단계를 설명합니다. 다음 섹션에서는 콜백 메서드를 설명합니다.

AppCompatActivity 사용

활동에서 미디어 라우터 프레임워크를 사용하는 경우 AppCompatActivity에서 활동을 확장하고 androidx.appcompat.app 패키지를 가져와야 합니다. androidx.appcompat:appcompat 및 androidx.mediarouter:mediarouter 지원 라이브러리를 앱 개발 프로젝트에 추가해야 합니다. 프로젝트에 지원 라이브러리를 추가하는 방법에 관한 자세한 내용은 Android Jetpack 시작하기를 참고하세요.

주의: 미디어 라우터 프레임워크의 androidx 구현을 사용해야 합니다. 이전 android.media 패키지를 사용하지 마세요.

미디어 경로 버튼의 메뉴 항목을 정의하는 XML 파일을 만듭니다. 항목의 작업은 MediaRouteActionProvider 클래스여야 합니다 다음은 파일 예입니다.

<menu xmlns:android="http://schemas.android.com/apk/res/android"
      xmlns:app="http://schemas.android.com/apk/res-auto"
      >

    <item android:id="@+id/media_route_menu_item"
        android:title="@string/media_route_menu_title"
        app:actionProviderClass="androidx.mediarouter.app.MediaRouteActionProvider"
        app:showAsAction="always"
    />
</menu>

MediaRouteSelector 만들기

미디어 경로 버튼 메뉴에 표시되는 경로는 MediaRouteSelector에서 판단합니다. AppCompatActivity에서 활동을 확장하고, 다음 코드 샘플과 같이 onCreate() 메서드에서 MediaRouteSelector.Builder를 호출하여 활동이 생성될 때 선택기를 빌드합니다. 선택기는 클래스 변수에 저장되고 허용되는 경로 유형은 MediaControlIntent 객체를 추가하여 지정됩니다.

class MediaRouterPlaybackActivity : AppCompatActivity() {

    private var mSelector: MediaRouteSelector? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // Create a route selector for the type of routes your app supports.
        mSelector = MediaRouteSelector.Builder()
            // These are the framework-supported intents.
            .addControlCategory(MediaControlIntent.CATEGORY_REMOTE_PLAYBACK)
            .build()
    }
}

대부분의 애플리케이션에서 필요한 유일한 경로 유형은 CATEGORY_REMOTE_PLAYBACK입니다. 이 경로 유형은 앱을 실행하는 기기를 리모컨으로 취급합니다. 연결된 수신 기기는 모든 콘텐츠 데이터 검색, 디코딩, 재생을 처리합니다. Chromecast와 같이 Google Cast를 지원하는 앱은 이와 같이 작동합니다.

일부 제조업체는 '보조 출력'이라는 특수 라우팅 옵션을 지원합니다. 이 라우팅을 사용하면 미디어 앱이 선택한 원격 수신기 기기의 화면 또는 스피커로 직접 동영상이나 음악을 가져오고 렌더링하고 스트리밍합니다. 보조 출력을 사용하여 콘텐츠를 무선 지원 음악 시스템 또는 동영상 디스플레이로 전송합니다. 이러한 기기를 검색하고 선택할 수 있도록 하려면 CATEGORY_LIVE_AUDIO 또는 CATEGORY_LIVE_VIDEO 제어 카테고리를 MediaRouteSelector에 추가해야 합니다. 또한 자체 Presentation 대화상자를 만들고 처리해야 합니다.

미디어 경로 버튼을 작업 모음에 추가

미디어 경로 메뉴와 MediaRouteSelector가 정의되면 이제 미디어 경로 버튼을 활동에 추가할 수 있습니다. 각 활동의 onCreateOptionsMenu() 메서드를 재정의하여 옵션 메뉴를 추가합니다.

override fun onCreateOptionsMenu(menu: Menu): Boolean {
    super.onCreateOptionsMenu(menu)

    // Inflate the menu and configure the media router action provider.
    menuInflater.inflate(R.menu.sample_media_router_menu, menu)

    // Attach the MediaRouteSelector to the menu item.
    val mediaRouteMenuItem = menu.findItem(R.id.media_route_menu_item)
    val mediaRouteActionProvider =
        MenuItemCompat.getActionProvider(mediaRouteMenuItem) as MediaRouteActionProvider

    // Attach the MediaRouteSelector that you built in onCreate().
    selector?.also(mediaRouteActionProvider::setRouteSelector)

    // Return true to show the menu.
    return true
}

앱에서 작업 모음을 구현하는 방법에 관한 자세한 내용은 작업 모음 개발자 가이드를 참고하세요.

미디어 경로 버튼을 모든 뷰에 MediaRouteButton로 추가할 수도 있습니다. setRouteSelector() 메서드를 사용하여 MediaRouteSelector를 버튼에 연결해야 합니다. 미디어 경로 버튼을 애플리케이션에 통합하는 방법에 관한 가이드라인은 Google Cast 디자인 체크리스트를 참고하세요.

MediaRouter 콜백

동일한 기기에서 실행되는 모든 앱은 단일 MediaRouter 인스턴스와 그 경로를 공유합니다(앱의 MediaRouteSelector에 의해 앱별로 필터링됨). 각 활동은 자체 MediaRouter.Callback 메서드 구현을 사용하여 MediaRouter와 통신합니다. MediaRouter는 사용자가 경로를 선택, 변경 또는 연결 해제할 때마다 콜백 메서드를 호출합니다.

콜백에는 라우팅 이벤트에 관한 정보를 수신하기 위해 재정의할 수 있는 여러 메서드가 있습니다. 최소한 MediaRouter.Callback 클래스 구현은 onRouteSelected() 및 onRouteUnselected()를 재정의해야 합니다.

MediaRouter는 공유 리소스이므로 앱은 일반적인 활동 수명 주기 콜백에 대한 응답으로 MediaRouter 콜백을 관리해야 합니다.

  • 활동이 만들어지면(onCreate(Bundle)) MediaRouter 포인터를 가져와 앱의 전체 기간 동안 유지하세요.
  • 활동이 표시되면(onStart()) 콜백을 MediaRouter에 연결하고 활동이 숨겨지면(onStop()) 콜백을 분리합니다.

다음 코드 샘플은 콜백 객체를 만들고 저장하는 방법, MediaRouter 인스턴스를 가져오는 방법, 콜백을 관리하는 방법을 보여줍니다. onStart()에서 콜백을 연결할 때 CALLBACK_FLAG_REQUEST_DISCOVERY 플래그를 사용해야 합니다. 이렇게 하면 MediaRouteSelector가 미디어 경로 버튼의 사용 가능한 경로 목록을 새로고침할 수 있습니다.

class MediaRouterPlaybackActivity : AppCompatActivity() {

    private var mediaRouter: MediaRouter? = null
    private var mSelector: MediaRouteSelector? = null

    // Variables to hold the currently selected route and its playback client.
    private var mRoute: MediaRouter.RouteInfo? = null
    private var remotePlaybackClient: RemotePlaybackClient? = null

    // Define the Callback object and its methods, save the object in a class variable.
    private val mediaRouterCallback = object : MediaRouter.Callback() {

        override fun onRouteSelected(
            router: MediaRouter,
            route: MediaRouter.RouteInfo,
            reason: Int
        ) {
            Log.d(TAG, "onRouteSelected: route=$route")
            if (route.supportsControlCategory(MediaControlIntent.CATEGORY_REMOTE_PLAYBACK)) {
                // Stop local playback (if necessary).
                // ...

                // Save the new route.
                mRoute = route

                // Attach a new playback client.
                remotePlaybackClient =
                    RemotePlaybackClient(this@MediaRouterPlaybackActivity, route)

                // Start remote playback (if necessary).
                // ...
            }
        }

        override fun onRouteUnselected(
            router: MediaRouter,
            route: MediaRouter.RouteInfo,
            reason: Int
        ) {
            Log.d(TAG, "onRouteUnselected: route=$route")
            if (route.supportsControlCategory(MediaControlIntent.CATEGORY_REMOTE_PLAYBACK)) {

                // Changed route: tear down previous client.
                mRoute?.also {
                    remotePlaybackClient?.release()
                    remotePlaybackClient = null
                }

                // Save the new route.
                mRoute = route

                when {
                    reason != MediaRouter.UNSELECT_REASON_ROUTE_CHANGED -> {
                        // Resume local playback (if necessary).
                        // ...
                    }
                }
            }
        }
    }

    // Retain a pointer to the MediaRouter.
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        // Get the media router service.
        mediaRouter = MediaRouter.getInstance(this)
        // ...
    }

    // Use this callback to run your MediaRouteSelector to generate the
    // list of available media routes.
    override fun onStart() {
        mSelector?.also { selector ->
            mediaRouter?.addCallback(
                selector, mediaRouterCallback,
                MediaRouter.CALLBACK_FLAG_REQUEST_DISCOVERY
            )
        }
        super.onStart()
    }

    // Remove the selector on stop to tell the media router that it no longer
    // needs to discover routes for your app.
    override fun onStop() {
        mediaRouter?.removeCallback(mediaRouterCallback)
        super.onStop()
    }
    // ...
}

미디어 라우터 프레임워크는 활동의 콜백을 추가하고 삭제하는 MediaRouteDiscoveryFragment 클래스도 제공합니다.

참고: 음악 재생 앱을 작성하고 앱이 백그라운드에 있는 동안 음악을 재생하도록 하려면 재생을 위한 Service를 빌드하고 서비스의 수명 주기 콜백에서 미디어 라우터 프레임워크를 호출해야 합니다.

원격 재생 경로 제어

원격 재생 경로를 선택하면 앱이 리모컨 역할을 합니다. 경로의 다른 쪽 끝에 있는 기기가 모든 콘텐츠 데이터 검색, 디코딩, 재생 기능을 처리합니다. 앱 UI의 컨트롤은 RemotePlaybackClient 객체를 사용하여 수신기 기기와 통신합니다.

RemotePlaybackClient 클래스는 콘텐츠 재생을 관리하는 추가 메서드를 제공합니다. 다음은 RemotePlaybackClient 클래스의 주요 재생 메서드입니다.

  • play() — Uri로 지정된 특정 미디어 파일을 재생합니다.
  • pause() — 현재 재생 중인 미디어 트랙을 일시중지합니다.
  • resume() — 일시중지 명령어 후 현재 트랙을 계속 재생합니다.
  • seek() — 현재 트랙의 특정 위치로 이동합니다.
  • release() — 앱에서 원격 재생 기기로의 연결을 해제합니다.

이러한 메서드를 사용하여 앱에서 제공하는 재생 컨트롤에 작업을 연결할 수 있습니다. 또한 대부분의 메서드를 사용하면 콜백 객체를 포함할 수 있으므로 재생 작업 또는 제어 요청의 진행 상황을 모니터링할 수 있습니다.

RemotePlaybackClient 클래스는 재생을 위한 여러 미디어 항목의 큐에 추가 및 미디어 큐 관리도 지원합니다.

샘플 코드

Android BasicMediaRouter 및 MediaRouter 샘플은 MediaRouter API를 사용하는 방법을 자세히 보여줍니다.