Android 미디어 라우터 프레임워크를 사용하면 제조업체는 MediaRouteProvider라는 표준화된 인터페이스를 통해 기기에서 재생을 사용 설정할 수 있습니다.
경로 제공자는 수신기 기기에서 미디어를 재생하기 위한 공통 인터페이스를 정의하여 미디어 경로를 지원하는 모든 Android 애플리케이션에서 장비의 미디어를 재생할 수 있도록 합니다.
이 가이드에서는 수신기 기기의 미디어 경로 제공자를 만들고 Android에서 실행되는 다른 미디어 재생 애플리케이션에서 사용할 수 있도록 하는 방법을 설명합니다. 이 API를 사용하려면 주요 클래스인 MediaRouteProvider, MediaRouteProviderDescriptor, RouteController에 익숙해야 합니다.
개요
Android 미디어 라우터 프레임워크를 사용하면 미디어 앱 개발자와 미디어 재생 기기 제조업체가 공통 API 및 공통 사용자 인터페이스를 통해 연결할 수 있습니다. MediaRouter 인터페이스를 구현하는 앱 개발자는 프레임워크에 연결하고 미디어 라우터 프레임워크에 참여하는 기기에 콘텐츠를 재생할 수 있습니다. 미디어 재생 기기 제조업체는 다른 애플리케이션이 수신기 기기에 연결하고 미디어를 재생할 수 있도록 하는 MediaRouteProvider를 게시하여 프레임워크에 참여할 수 있습니다. 그림 1은 앱이 미디어 라우터 프레임워크를 통해 수신 기기에 연결되는 방식을 보여줍니다.
그림 1. 미디어 경로 제공자 클래스가 미디어 앱에서 수신기 기기로의 통신을 제공하는 방법에 관한 개요
수신기 기기의 미디어 경로 제공자를 빌드할 때 제공자는 다음 용도로 사용됩니다.
- 다른 앱이 수신기 기기를 검색하고 재생 기능을 사용할 수 있도록 수신기 기기의 기능을 설명하고 게시합니다.
- 수신 기기의 프로그래밍 인터페이스와 통신 전송 메커니즘을 래핑하여 기기를 미디어 라우터 프레임워크와 호환되도록 합니다.
경로 제공자 배포
미디어 경로 제공자는 Android 앱의 일부로 배포됩니다. MediaRouteProviderService를 확장하거나 자체 서비스로 MediaRouteProvider 구현을 래핑하고 미디어 경로 제공자의 인텐트 필터를 선언하여 다른 앱에서 경로 제공자를 사용할 수 있도록 할 수 있습니다. 이 단계를 통해 다른 앱에서 미디어 경로를 검색하고 사용할 수 있습니다.
참고: 미디어 경로 제공자를 포함하는 앱은 경로 제공자에 대한 MediaRouter 인터페이스를 포함할 수도 있지만 필수는 아닙니다.
MediaRouter 지원 라이브러리
미디어 라우터 API는 AndroidX MediaRouter 라이브러리에 정의되어 있습니다. 이 라이브러리를 앱 개발 프로젝트에 추가해야 합니다. 프로젝트에 지원 라이브러리를 추가하는 방법에 관한 자세한 내용은 지원 라이브러리 설정을 참고하세요.
주의: 미디어 라우터 프레임워크의 AndroidX 구현을 사용해야 합니다.
이전 android.media 패키지를 사용하지 마세요.
제공자 서비스 만들기
미디어 라우터 프레임워크는 다른 애플리케이션이 경로를 사용할 수 있도록 미디어 경로 제공자를 검색하고 연결할 수 있어야 합니다. 이를 위해 미디어 라우터 프레임워크는 미디어 경로 제공자 인텐트 작업을 선언하는 앱을 찾습니다. 다른 앱이 제공자에 연결하려고 할 때 프레임워크가 제공자를 호출하고 연결할 수 있어야 하므로 제공자는 Service에 캡슐화되어야 합니다.
다음 예시 코드는 매니페스트에서 미디어 경로 제공자 서비스 및 인텐트 필터의 선언을 보여줍니다. 이를 통해 미디어 라우터 프레임워크에서 검색하고 사용할 수 있습니다.
<service android:name=".provider.SampleMediaRouteProviderService" android:label="@string/sample_media_route_provider_service" android:process=":mrp"> <intent-filter> <action android:name="android.media.MediaRouteProviderService" /> </intent-filter> </service>
이 manifest 예는 실제 미디어 경로 제공자 클래스를 래핑하는 서비스를 선언합니다.
Android 미디어 라우터 프레임워크는 미디어 경로 제공업체의 서비스 래퍼로 사용할 수 있는 MediaRouteProviderService 클래스를 제공합니다. 다음 코드 예는 이 래퍼 클래스를 사용하는 방법을 보여줍니다.
class SampleMediaRouteProviderService : MediaRouteProviderService() { override fun onCreateMediaRouteProvider(): MediaRouteProvider { return SampleMediaRouteProvider(this) } }
경로 기능 지정
미디어 라우터 프레임워크에 연결하는 앱은 앱의 매니페스트 선언을 통해 미디어 경로를 검색할 수 있지만, 제공하는 미디어 경로의 기능도 알아야 합니다. 미디어 경로는 다양한 유형과 다양한 기능을 가질 수 있으며, 다른 앱은 이러한 세부정보를 검색하여 경로와 호환되는지 확인할 수 있어야 합니다.
미디어 라우터 프레임워크를 사용하면 IntentFilter 객체, MediaRouteDescriptor 객체, MediaRouteProviderDescriptor를 통해 미디어 경로의 기능을 정의하고 게시할 수 있습니다. 이 섹션에서는 이러한 클래스를 사용하여 다른 앱에 미디어 경로의 세부정보를 게시하는 방법을 설명합니다.
경로 카테고리
미디어 경로 제공자의 프로그래매틱 설명의 일부로 제공자가 원격 재생, 보조 출력 또는 둘 다를 지원하는지 지정해야 합니다. 다음은 미디어 라우터 프레임워크에서 제공하는 경로 카테고리입니다.
CATEGORY_LIVE_AUDIO— 무선 지원 음악 시스템과 같은 보조 출력 장치로의 오디오 출력입니다.CATEGORY_LIVE_VIDEO: 무선 디스플레이 기기와 같은 보조 출력 기기로의 동영상 출력입니다.CATEGORY_REMOTE_PLAYBACK— Chromecast 기기와 같이 미디어 검색, 디코딩, 재생을 처리하는 별도의 기기에서 동영상 또는 오디오를 재생합니다.
미디어 경로 설명에 이러한 설정을 포함하려면 설정을 IntentFilter 객체에 삽입한 후 나중에 MediaRouteDescriptor 객체에 추가합니다.
class SampleMediaRouteProvider(context: Context) : MediaRouteProvider(context) { companion object { private val CONTROL_FILTERS_BASIC: ArrayList<IntentFilter> = IntentFilter().run { addCategory(MediaControlIntent.CATEGORY_REMOTE_PLAYBACK) arrayListOf(this) } } }
CATEGORY_REMOTE_PLAYBACK 인텐트를 지정하는 경우 미디어 경로 제공자가 지원하는 미디어 유형과 재생 컨트롤도 정의해야 합니다. 다음 섹션에서는 기기에 이러한 설정을 지정하는 방법을 설명합니다.
미디어 유형 및 프로토콜
원격 재생 기기의 미디어 경로 제공자는 지원하는 미디어 유형과 전송 프로토콜을 지정해야 합니다. 이러한 설정은 IntentFilter 클래스와 해당 객체의 addDataScheme() 및 addDataType() 메서드를 사용하여 지정합니다. 다음 코드 스니펫은 http, https, 실시간 스트리밍 프로토콜(RTSP)을 사용하여 원격 동영상 재생을 지원하는 인텐트 필터를 정의하는 방법을 보여줍니다.
class SampleMediaRouteProvider(context: Context) : MediaRouteProvider(context) { companion object { private fun IntentFilter.addDataTypeUnchecked(type: String) { try { addDataType(type) } catch (ex: IntentFilter.MalformedMimeTypeException) { throw RuntimeException(ex) } } private val CONTROL_FILTERS_BASIC: ArrayList<IntentFilter> = IntentFilter().run { addCategory(MediaControlIntent.CATEGORY_REMOTE_PLAYBACK) addAction(MediaControlIntent.ACTION_PLAY) addDataScheme("http") addDataScheme("https") addDataScheme("rtsp") addDataTypeUnchecked("video/*") arrayListOf(this) } } // ... }
재생 컨트롤
원격 재생을 제공하는 미디어 경로 제공자는 지원하는 미디어 컨트롤 유형을 지정해야 합니다. 다음은 미디어 경로에서 제공할 수 있는 일반적인 컨트롤 유형입니다.
- 재생 컨트롤. 예: 재생, 일시중지, 되감기, 빨리 감기
- 큐 기능: 전송 앱이 수신기 기기에서 유지관리하는 재생목록에서 항목을 추가하고 삭제할 수 있습니다.
- 세션 기능: 수신자 기기가 요청 앱에 세션 ID를 제공한 후 각 후속 재생 컨트롤 요청에서 해당 ID를 확인하여 전송 앱이 서로 간섭하지 않도록 합니다.
다음 코드 예는 기본 미디어 경로 재생 컨트롤을 지원하는 인텐트 필터를 구성하는 방법을 보여줍니다.
class SampleMediaRouteProvider(context: Context) : MediaRouteProvider(context) { companion object { // ... private val CONTROL_FILTERS_BASIC: ArrayList<IntentFilter> = run { val videoPlayback: IntentFilter = ... // ... val playControls = IntentFilter().apply { addCategory(MediaControlIntent.CATEGORY_REMOTE_PLAYBACK) addAction(MediaControlIntent.ACTION_SEEK) addAction(MediaControlIntent.ACTION_GET_STATUS) addAction(MediaControlIntent.ACTION_PAUSE) addAction(MediaControlIntent.ACTION_RESUME) addAction(MediaControlIntent.ACTION_STOP) } arrayListOf(videoPlayback, playControls) } } // ... }
사용 가능한 재생 컨트롤 인텐트에 관한 자세한 내용은 MediaControlIntent 클래스를 참고하세요.
MediaRouteProviderDescriptor
IntentFilter 객체를 사용하여 미디어 경로의 기능을 정의한 후 Android 미디어 라우터 프레임워크에 게시할 설명자 객체를 만들 수 있습니다. 이 설명자 객체에는 다른 애플리케이션이 미디어 경로와 상호작용하는 방법을 결정할 수 있도록 미디어 경로 기능의 세부정보가 포함되어 있습니다.
다음 예시 코드는 이전에 만든 인텐트 필터를 MediaRouteProviderDescriptor에 추가하고 미디어 라우터 프레임워크에서 사용할 설명자를 설정하는 방법을 보여줍니다.
class SampleMediaRouteProvider(context: Context) : MediaRouteProvider(context) { init { publishRoutes() } private fun publishRoutes() { val resources = context.resources val routeName: String = resources.getString(R.string.variable_volume_basic_route_name) val routeDescription: String = resources.getString(R.string.sample_route_description) // Create a route descriptor using previously created IntentFilters. val routeDescriptor: MediaRouteDescriptor = MediaRouteDescriptor.Builder(VARIABLE_VOLUME_BASIC_ROUTE_ID, routeName) .setDescription(routeDescription) .addControlFilters(CONTROL_FILTERS_BASIC) .setPlaybackStream(AudioManager.STREAM_MUSIC) .setPlaybackType(MediaRouter.RouteInfo.PLAYBACK_TYPE_REMOTE) .setVolumeHandling(MediaRouter.RouteInfo.PLAYBACK_VOLUME_VARIABLE) .setVolumeMax(VOLUME_MAX) .setVolume(mVolume) .build() // Add the route descriptor to the provider descriptor. val providerDescriptor: MediaRouteProviderDescriptor = MediaRouteProviderDescriptor.Builder() .addRoute(routeDescriptor) .build() // Publish the descriptor to the framework. descriptor = providerDescriptor } // ... }
사용 가능한 설명자 설정에 대한 자세한 내용은 MediaRouteDescriptor 및 MediaRouteProviderDescriptor의 참고 문서를 확인하세요.
경로 제어
애플리케이션이 미디어 경로 제공자에 연결되면 제공자는 다른 앱에서 경로로 전송한 미디어 라우터 프레임워크를 통해 재생 명령어를 수신합니다. 이러한 요청을 처리하려면 명령어를 처리하고 수신기 기기와의 실제 통신을 처리하는 MediaRouteProvider.RouteController 클래스의 구현을 제공해야 합니다.
미디어 라우터 프레임워크는 경로 제공자의 onCreateRouteController() 메서드를 호출하여 이 클래스의 인스턴스를 가져온 다음 요청을 이 인스턴스로 라우팅합니다.
다음은 미디어 경로 제공자에 구현해야 하는 MediaRouteProvider.RouteController 클래스의 주요 메서드입니다.
onSelect()— 애플리케이션이 재생을 위해 경로를 선택할 때 호출됩니다. 이 메서드를 사용하여 미디어 재생이 시작되기 전에 필요한 준비 작업을 수행합니다.onControlRequest()- 특정 재생 명령어를 수신 기기로 전송합니다.onSetVolume()— 수신 기기에 재생 볼륨을 특정 값으로 설정하라는 요청을 보냅니다.onUpdateVolume()— 수신 기기에 요청을 전송하여 재생 볼륨을 지정된 양만큼 수정합니다.onUnselect()- 애플리케이션이 경로를 선택 해제할 때 호출됩니다.onRelease()— 프레임워크에서 경로가 더 이상 필요하지 않을 때 호출되어 리소스를 확보할 수 있습니다.
볼륨 변경을 제외한 모든 재생 컨트롤 요청은 onControlRequest() 메서드로 전달됩니다. 이 메서드의 구현은 제어 요청을 파싱하고 적절하게 응답해야 합니다. 다음은 원격 재생 미디어 경로의 명령어를 처리하는 이 메서드의 구현 예입니다.
private class SampleRouteController : MediaRouteProvider.RouteController() { // ... override fun onControlRequest( intent: Intent, callback: MediaRouter.ControlRequestCallback? ): Boolean { return if (intent.hasCategory(MediaControlIntent.CATEGORY_REMOTE_PLAYBACK)) { val action = intent.action when (action) { MediaControlIntent.ACTION_PLAY -> handlePlay(intent, callback) MediaControlIntent.ACTION_ENQUEUE -> handleEnqueue(intent, callback) MediaControlIntent.ACTION_REMOVE -> handleRemove(intent, callback) MediaControlIntent.ACTION_SEEK -> handleSeek(intent, callback) MediaControlIntent.ACTION_GET_STATUS -> handleGetStatus(intent, callback) MediaControlIntent.ACTION_PAUSE -> handlePause(intent, callback) MediaControlIntent.ACTION_RESUME -> handleResume(intent, callback) MediaControlIntent.ACTION_STOP -> handleStop(intent, callback) MediaControlIntent.ACTION_START_SESSION -> handleStartSession(intent, callback) MediaControlIntent.ACTION_GET_SESSION_STATUS -> handleGetSessionStatus(intent, callback) MediaControlIntent.ACTION_END_SESSION -> handleEndSession(intent, callback) else -> false }.also { Log.d(TAG, sessionManager.toString()) } } else { false } } // ... }
MediaRouteProvider.RouteController 클래스는 미디어 재생 장비의 API를 위한 래퍼 역할을 하도록 설계되었다는 점을 이해하는 것이 중요합니다. 이 클래스의 메서드 구현은 전적으로 수신 기기에서 제공하는 프로그래매틱 인터페이스에 따라 달라집니다.
샘플 코드
MediaRouter 샘플은 맞춤 미디어 경로 제공자를 만드는 방법을 보여줍니다.