MediaRouter'a genel bakış

Uygulamanızda MediaRouter çerçevesini kullanmak için MediaRouter nesnesinin bir örneğini almanız ve yönlendirme etkinliklerini dinlemek için bir MediaRouter.Callback nesnesi eklemeniz gerekir. Bir medya rotası üzerinden gönderilen içerik, rotayla ilişkili MediaRouteProvider üzerinden geçer (Bluetooth çıkış cihazı gibi birkaç özel durum hariç). Şekil 1'de, cihazlar arasında içerik yönlendirmek için kullanılan sınıfların genel görünümü verilmiştir.

Şekil 1. Uygulamalar tarafından kullanılan önemli medya yönlendirici sınıflarına genel bakış.

Not: Uygulamanızın Google Cast cihazlarını desteklemesini istiyorsanız Cast SDK'yı kullanmanız ve uygulamanızı Cast göndericisi olarak oluşturmanız gerekir. MediaRouter çerçevesini doğrudan kullanmak yerine Cast belgelerindeki talimatları uygulayın.

Medya rotası düğmesi

Android uygulamaları, medya yönlendirmeyi kontrol etmek için medya rotası düğmesi kullanmalıdır. MediaRouter çerçevesi, düğme için standart bir arayüz sağlar. Bu arayüz, kullanıcıların yönlendirmeyi tanımasına ve kullanmasına yardımcı olur. Medya rotası düğmesi genellikle uygulamanızın işlem çubuğunun sağ tarafına yerleştirilir (Şekil 2'de gösterildiği gibi).

Şekil 2. İşlem çubuğundaki medya rotası düğmesi.

Kullanıcı medya rotası düğmesine bastığında, kullanılabilir medya rotaları Şekil 3'te gösterildiği gibi bir listede görünür.

Şekil 3. Medya rotası düğmesine basıldıktan sonra gösterilen, kullanılabilir medya rotalarının listesi.

Medya rotası düğmesi oluşturmak için aşağıdaki adımları uygulayın:

  1. AppCompatActivity kullanma
  2. Medya rotası düğmesi menü öğesini tanımlama
  3. MediaRouteSelector oluşturma
  4. İşlem çubuğuna medya rotası düğmesini ekleme
  5. Etkinliğinizin yaşam döngüsünde MediaRouter.Callback yöntemlerini oluşturma ve yönetme

Bu bölümde ilk dört adım açıklanmaktadır. Sonraki bölümde geri çağırma yöntemleri açıklanmaktadır.

AppCompatActivity kullanma

Bir etkinlikte medya yönlendirici çerçevesini kullandığınızda etkinliği AppCompatActivity sınıfından genişletmeniz ve androidx.appcompat.app paketini içe aktarmanız gerekir. Uygulama geliştirme projenize androidx.appcompat:appcompat ve androidx.mediarouter:mediarouter destek kitaplıklarını eklemeniz gerekir. Projenize destek kitaplıkları ekleme hakkında daha fazla bilgi için Android Jetpack'i kullanmaya başlama başlıklı makaleyi inceleyin.

Dikkat: Medya yönlendirici çerçevesinin androidx uygulamasını kullandığınızdan emin olun. Eski android.media paketini kullanmayın.

Medya rotası düğmesi için bir menü öğesi tanımlayan bir XML dosyası oluşturun. Öğenin işlemi MediaRouteActionProvider sınıfı olmalıdır. Örnek bir dosya:

<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 oluşturma

Medya rotası düğmesi menüsünde görünen rotalar, MediaRouteSelector tarafından belirlenir. Etkinliğinizi AppCompatActivity sınıfından genişletin ve aşağıdaki kod örneğinde gösterildiği gibi onCreate() yönteminden MediaRouteSelector.Builder yöntemini çağırarak etkinlik oluşturulduğunda seçiciyi oluşturun. Seçicinin bir sınıf değişkenine kaydedildiğini ve izin verilen rota türlerinin MediaControlIntent nesneleri eklenerek belirtildiğini unutmayın:

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()
    }
}

Çoğu uygulama için gereken tek rota türü CATEGORY_REMOTE_PLAYBACK şeklindedir. Bu rota türü, uygulamanızı çalıştıran cihazı uzaktan kumanda olarak değerlendirir. Bağlı alıcı cihaz; tüm içerik verilerini alma, kod çözme ve oynatma işlemlerini gerçekleştirir. Chromecast gibi Google Cast'i destekleyen uygulamalar bu şekilde çalışır.

Bazı üreticiler, "ikincil çıkış" adlı özel bir yönlendirme seçeneğini destekler. Bu yönlendirme sayesinde medya uygulamanız, video veya müzikleri doğrudan seçilen uzaktan alıcı cihazın ekranına ve/veya hoparlörlerine alır, oluşturur ve aktarır. Kablosuz özellikli müzik sistemlerine veya video ekranlarına içerik göndermek için ikincil çıkışı kullanın. Bu cihazların keşfedilmesini ve seçilmesini etkinleştirmek için MediaRouteSelector'a CATEGORY_LIVE_AUDIO veya CATEGORY_LIVE_VIDEO kontrol kategorilerini eklemeniz gerekir. Ayrıca kendi Presentation iletişim kutunuzu oluşturmanız ve işlemeniz gerekir.

İşlem çubuğuna medya rotası düğmesini ekleme

Medya rotası menüsü ve MediaRouteSelector tanımlandıktan sonra, medya rotası düğmesini bir etkinliğe ekleyebilirsiniz. Seçenekler menüsü eklemek için her bir etkinliğinizde onCreateOptionsMenu() yöntemini geçersiz kılın.

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
}

Uygulamanızda işlem çubuğunu uygulama hakkında daha fazla bilgi için İşlem Çubuğu geliştirici kılavuzuna bakın.

Ayrıca, herhangi bir görünümde medya rotası düğmesini MediaRouteButton olarak da ekleyebilirsiniz. setRouteSelector() yöntemini kullanarak düğmeye bir MediaRouteSelector eklemeniz gerekir. Medya rotası düğmesini uygulamanıza eklemeyle ilgili yönergeler için Google Cast Tasarım Kontrol Listesi'ne bakın.

MediaRouter geri çağırmaları

Aynı cihazda çalışan tüm uygulamalar tek bir MediaRouter örneğini ve rotalarını paylaşır (uygulamanın MediaRouteSelector'ı tarafından uygulama başına filtrelenir). Her etkinlik, kendi MediaRouter.Callback yöntemlerini kullanarak MediaRouter ile iletişim kurar. MediaRouter, kullanıcı bir rota seçtiğinde, değiştirdiğinde veya bağlantısını kestiğinde geri çağırma yöntemlerini çağırır.

Geri çağırmada, rota etkinlikleri hakkında bilgi almak için geçersiz kılabileceğiniz çeşitli yöntemler vardır. MediaRouter.Callback sınıfını uygularken en azından onRouteSelected() ve onRouteUnselected() yöntemlerini geçersiz kılmanız gerekir.

MediaRouter paylaşılan bir kaynak olduğundan uygulamanızın, normal etkinlik yaşam döngüsü geri çağırma yöntemlerine yanıt olarak MediaRouter geri çağırma yöntemlerini yönetmesi gerekir:

  • Etkinlik oluşturulduğunda (onCreate(Bundle)) MediaRouter için bir işaretçi alın ve uygulamanın kullanım ömrü boyunca bu işaretçiyi saklayın.
  • Etkinlik görünür hale geldiğinde (onStart()) geri çağırmaları MediaRouter'a ekleyin ve gizlendiğinde (onStop()) ayırın.

Aşağıdaki kod örneğinde, geri çağırma nesnesinin nasıl oluşturulup kaydedileceği, MediaRouter örneğinin nasıl alınacağı ve geri çağırmaların nasıl yönetileceği gösterilmektedir. onStart() içinde geri çağırmaları eklerken CALLBACK_FLAG_REQUEST_DISCOVERY işaretinin kullanıldığına dikkat edin. Bu sayede MediaRouteSelector'ınız, medya rotası düğmesinin kullanılabilir rotalar listesini yenileyebilir.

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()
    }
    // ...
}

Medya yönlendirici çerçevesi, bir etkinliğin geri çağırma işlevini ekleme ve kaldırma işlemlerini gerçekleştiren bir MediaRouteDiscoveryFragment sınıfı da sağlar.

Not: Müzik çalma uygulaması yazıyorsanız ve uygulamanın arka plandayken müzik çalmasını istiyorsanız oynatma için bir Service oluşturmanız ve hizmetin yaşam döngüsü geri çağırma yöntemlerinden medya yönlendirici çerçevesini çağırmanız gerekir.

Uzaktan oynatma rotasını kontrol etme

Uzaktan oynatma rotası seçtiğinizde uygulamanız uzaktan kumanda görevi görür. Rotanın diğer ucundaki cihaz, tüm içerik verilerini alma, kod çözme ve oynatma işlevlerini gerçekleştirir. Uygulamanızın kullanıcı arayüzündeki kontroller, RemotePlaybackClient nesnesi kullanarak alıcı cihazla iletişim kurar.

RemotePlaybackClient sınıfı, içerik oynatmayı yönetmek için ek yöntemler sağlar. RemotePlaybackClient sınıfındaki önemli oynatma yöntemlerinden bazıları şunlardır:

  • play(): Uri ile belirtilen belirli bir medya dosyasını oynatır.
  • pause(): Oynatılmakta olan medya parçasını duraklatır.
  • resume(): Duraklatma komutundan sonra mevcut parçayı çalmaya devam eder.
  • seek(): Mevcut parçada belirli bir konuma gitme
  • release(): Uygulamanızdan uzaktan oynatma cihazına olan bağlantıyı keser.

Uygulamanızda sağladığınız oynatma kontrollerine işlem eklemek için bu yöntemleri kullanabilirsiniz. Bu yöntemlerin çoğu, oynatma görevinin veya kontrol isteğinin ilerleme durumunu izleyebilmeniz için bir geri çağırma nesnesi eklemenize de olanak tanır.

RemotePlaybackClient sınıfı, oynatma için birden fazla medya öğesinin sıraya alınmasını ve medya sırasının yönetilmesini de destekler.

Örnek kod

Android BasicMediaRouter ve MediaRouter örnekleri, MediaRouter API'nin kullanımını daha ayrıntılı bir şekilde gösterir.