Çıkış Değiştirici

Çıkış değiştirici, Android 13'ten itibaren içeriklerin yerel ve uzaktan oynatılması arasında sorunsuz geçiş yapılmasını sağlayan bir Cast SDK'sı özelliğidir. Amaç, gönderen uygulamaların içeriğin nerede oynatıldığını kolayca ve hızlı bir şekilde kontrol etmesine yardımcı olmaktır. Çıkış Değiştirici, telefon hoparlörü, eşlenen Bluetooth cihazlar ve uzaktan Cast uyumlu cihazlar arasında içerik oynatmayı değiştirmek için MediaRouter kitaplığını kullanır. Kullanım alanları aşağıdaki senaryolara ayrılabilir:

Uygulamanızda çıkış değiştiriciyi nasıl uygulayacağınızla ilgili referans için CastVideos-android örnek uygulamasını indirip kullanın.

Bu kılavuzda açıklanan adımlar kullanılarak yerelden uzaktan kumandaya, uzaktan kumandadan yerele ve uzaktan kumandadan uzaktan kumandaya geçişi desteklemek için çıkış değiştirici etkinleştirilmelidir. Yerel cihaz hoparlörleri ile eşlenen Bluetooth cihazlar arasında aktarımı desteklemek için ek bir adım gerekmez.

Çıkış Değiştirici Kullanıcı Arayüzü

Çıkış Değiştirici, kullanılabilir yerel ve uzak cihazların yanı sıra cihazın seçili olup olmadığı, bağlanıp bağlanmadığı ve mevcut ses seviyesi gibi mevcut cihaz durumlarını gösterir. Mevcut cihazın yanı sıra başka cihazlar varsa diğer cihazı tıklayarak medya oynatmayı seçili cihaza aktarabilirsiniz.

Bilinen sorunlar

  • Yerel oynatma için oluşturulan medya oturumları, Cast SDK'sı bildirimine geçildiğinde kapatılır ve yeniden oluşturulur.

Giriş noktaları

Medya bildirimi

Bir uygulama, yerel oynatma (yerel olarak oynatma) için MediaSession ile bir medya bildirimi yayınlarsa medya bildiriminin sağ üst köşesinde, içeriğin oynatıldığı cihazın adını (ör. telefon hoparlörü) içeren bir bildirim çipi gösterilir. Bildirim çipine dokunulduğunda çıkış değiştirici iletişim kutusu sistem kullanıcı arayüzü açılır.

Ses düzeyi ayarları

Çıkış Değiştirici iletişim kutusu sistem kullanıcı arayüzü, cihazdaki fiziksel ses düğmeleri tıklanarak, alttaki ayarlar simgesine dokunarak ve "<Uygulama Adı> uygulamasını <Yayın Cihazı> cihazında oynat" metnine dokunarak da tetiklenebilir.

Adımların özeti

Ön koşullar

  1. Mevcut Android uygulamanızı AndroidX'e taşıma
  2. Çıkış Değiştirici için Android gönderen SDK'sının gerekli minimum sürümünü kullanmak üzere uygulamanızın build.gradle dosyasını güncelleyin:
    dependencies {
      ...
      implementation 'com.google.android.gms:play-services-cast-framework:21.2.0'
      ...
    }
  3. Uygulama, medya bildirimlerini destekler.
  4. Android 13 yüklü cihaz.

Medya bildirimlerini ayarlama

Çıkış Değiştirici'yi kullanmak için ses ve video uygulamalarının, yerel oynatma için medya oynatma durumunu ve kontrollerini gösteren bir medya bildirimi oluşturması gerekir. Bunun için bir MediaSession oluşturmanız, MediaStyle öğesini MediaSession jetonuyla ayarlamanız ve bildirimde medya kontrollerini ayarlamanız gerekir.

Şu anda MediaStyle ve MediaSession kullanmıyorsanız aşağıdaki snippet'te bunların nasıl ayarlanacağı gösterilmektedir. Ses ve video uygulamaları için medya oturumu geri çağırmalarının nasıl ayarlanacağını gösteren kılavuzlar da mevcuttur:

Kotlin
// Create a media session. NotificationCompat.MediaStyle
// PlayerService is your own Service or Activity responsible for media playback.
val mediaSession = MediaSessionCompat(this, "PlayerService")

// Create a MediaStyle object and supply your media session token to it.
val mediaStyle = Notification.MediaStyle().setMediaSession(mediaSession.sessionToken)

// Create a Notification which is styled by your MediaStyle object.
// This connects your media session to the media controls.
// Don't forget to include a small icon.
val notification = Notification.Builder(this@PlayerService, CHANNEL_ID)
    .setStyle(mediaStyle)
    .setSmallIcon(R.drawable.ic_app_logo)
    .build()

// Specify any actions which your users can perform, such as pausing and skipping to the next track.
val pauseAction: Notification.Action = Notification.Action.Builder(
        pauseIcon, "Pause", pauseIntent
    ).build()
notification.addAction(pauseAction)
Java
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {
    // Create a media session. NotificationCompat.MediaStyle
    // PlayerService is your own Service or Activity responsible for media playback.
    MediaSession mediaSession = new MediaSession(this, "PlayerService");

    // Create a MediaStyle object and supply your media session token to it.
    Notification.MediaStyle mediaStyle = new Notification.MediaStyle().setMediaSession(mediaSession.getSessionToken());

    // Specify any actions which your users can perform, such as pausing and skipping to the next track.
    Notification.Action pauseAction = Notification.Action.Builder(pauseIcon, "Pause", pauseIntent).build();

    // Create a Notification which is styled by your MediaStyle object.
    // This connects your media session to the media controls.
    // Don't forget to include a small icon.
    String CHANNEL_ID = "CHANNEL_ID";
    Notification notification = new Notification.Builder(this, CHANNEL_ID)
        .setStyle(mediaStyle)
        .setSmallIcon(R.drawable.ic_app_logo)
        .addAction(pauseAction)
        .build();
}

Ayrıca, bildirimi medyanızla ilgili bilgilerle doldurmak için medyanızın meta verilerini ve oynatma durumunu MediaSession öğesine eklemeniz gerekir.

MediaSession öğesine meta veri eklemek için setMetaData() öğesini kullanın ve MediaMetadataCompat.Builder() içinde medyanızla ilgili tüm MediaMetadata sabitlerini sağlayın.

Kotlin
mediaSession.setMetadata(MediaMetadataCompat.Builder()
    // Title
    .putString(MediaMetadata.METADATA_KEY_TITLE, currentTrack.title)

    // Artist
    // Could also be the channel name or TV series.
    .putString(MediaMetadata.METADATA_KEY_ARTIST, currentTrack.artist)

    // Album art
    // Could also be a screenshot or hero image for video content
    // The URI scheme needs to be "content", "file", or "android.resource".
    .putString(
        MediaMetadata.METADATA_KEY_ALBUM_ART_URI, currentTrack.albumArtUri)
    )

    // Duration
    // If duration isn't set, such as for live broadcasts, then the progress
    // indicator won't be shown on the seekbar.
    .putLong(MediaMetadata.METADATA_KEY_DURATION, currentTrack.duration)

    .build()
)
Java
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {
    mediaSession.setMetadata(
        new MediaMetadataCompat.Builder()
        // Title
        .putString(MediaMetadata.METADATA_KEY_TITLE, currentTrack.title)

        // Artist
        // Could also be the channel name or TV series.
        .putString(MediaMetadata.METADATA_KEY_ARTIST, currentTrack.artist)

        // Album art
        // Could also be a screenshot or hero image for video content
        // The URI scheme needs to be "content", "file", or "android.resource".
        .putString(MediaMetadata.METADATA_KEY_ALBUM_ART_URI, currentTrack.albumArtUri)

        // Duration
        // If duration isn't set, such as for live broadcasts, then the progress
        // indicator won't be shown on the seekbar.
        .putLong(MediaMetadata.METADATA_KEY_DURATION, currentTrack.duration)

        .build()
    );
}

Oynatma durumunu MediaSession öğesine eklemek için setPlaybackState() kullanın ve PlaybackStateCompat.Builder() içinde medyanızla ilgili tüm PlaybackStateCompat sabitlerini sağlayın.

Kotlin
mediaSession.setPlaybackState(
    PlaybackStateCompat.Builder()
        .setState(
            PlaybackStateCompat.STATE_PLAYING,

            // Playback position
            // Used to update the elapsed time and the progress bar.
            mediaPlayer.currentPosition.toLong(),

            // Playback speed
            // Determines the rate at which the elapsed time changes.
            playbackSpeed
        )

        // isSeekable
        // Adding the SEEK_TO action indicates that seeking is supported
        // and makes the seekbar position marker draggable. If this is not
        // supplied seek will be disabled but progress will still be shown.
        .setActions(PlaybackStateCompat.ACTION_SEEK_TO)
        .build()
)
Java
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {
    mediaSession.setPlaybackState(
        new PlaybackStateCompat.Builder()
            .setState(
                 PlaybackStateCompat.STATE_PLAYING,

                // Playback position
                // Used to update the elapsed time and the progress bar.
                mediaPlayer.currentPosition.toLong(),

                // Playback speed
                // Determines the rate at which the elapsed time changes.
                playbackSpeed
            )

        // isSeekable
        // Adding the SEEK_TO action indicates that seeking is supported
        // and makes the seekbar position marker draggable. If this is not
        // supplied seek will be disabled but progress will still be shown.
        .setActions(PlaybackStateCompat.ACTION_SEEK_TO)
        .build()
    );
}

Video uygulaması bildirim davranışı

Arka planda yerel oynatmayı desteklemeyen video veya ses uygulamaları, oynatmanın desteklenmediği durumlarda medya komutları göndermeyle ilgili sorunları önlemek için medya bildirimlerine yönelik belirli davranışlara sahip olmalıdır:

  • Medya yerel olarak oynatılırken ve uygulama ön plandayken medya bildirimini yayınlayın.
  • Uygulama arka plandayken yerel oynatmayı duraklatma ve bildirimi kapatma
  • Uygulama ön plana geri döndüğünde yerel oynatma devam etmeli ve bildirim yeniden yayınlanmalıdır.

AndroidManifest.xml dosyasında Çıkış Değiştirici'yi etkinleştirme

Çıkış değiştiriciyi etkinleştirmek için MediaTransferReceiver, uygulamanın AndroidManifest.xml dosyasına eklenmelidir. Etkinleştirilmezse özellik etkinleştirilmez ve uzaktan yerel özellik bayrağı da geçersiz olur.

<application>
    ...
    <receiver
         android:name="androidx.mediarouter.media.MediaTransferReceiver"
         android:exported="true">
    </receiver>
    ...
</application>

MediaTransferReceiver, sistem kullanıcı arayüzüne sahip cihazlar arasında medya aktarımını sağlayan bir yayın alıcısıdır. Daha fazla bilgi için MediaTransferReceiver referansına bakın.

Yerelden uzaktan erişime

Kullanıcı, oynatmayı yerelden uzaktan kumandaya geçirdiğinde Cast SDK'sı, Cast oturumunu otomatik olarak başlatır. Ancak uygulamaların yerelden uzaktan oynatmaya geçişi yönetmesi gerekir. Örneğin, yerel oynatmayı durdurup medyayı Cast cihazına yüklemelidir. Uygulamalar, onSessionStarted() ve onSessionEnded() geri çağırmalarını kullanarak Cast SessionManagerListener'i dinlemeli ve Cast SessionManager geri çağırmalarını alırken işlemi gerçekleştirmelidir. Uygulamalar, çıkış değiştirici iletişim kutusu açıldığında ve uygulama ön planda olmadığında bu geri çağırmaların hâlâ etkin olduğundan emin olmalıdır.

Arka planda yayınlama için SessionManagerListener'ı güncelleme

Eski Cast deneyimi, uygulama ön plandayken yerelden uzaktan kumandaya geçişi zaten destekliyor. Tipik bir Cast deneyimi, kullanıcılar uygulamadaki Cast simgesini tıklayıp medya akışı için bir cihaz seçtiğinde başlar. Bu durumda uygulamanın, uygulamanın etkinliğinin SessionManagerListener, onCreate() veya onStart() bölümünde dinleyiciye kaydolması ve onStop() ya da onDestroy() bölümünde dinleyicinin kaydını iptal etmesi gerekir.

Çıkış değiştiriciyi kullanarak yayın yapma özelliği sayesinde uygulamalar arka plandayken yayın yapmaya başlayabilir. Bu, özellikle arka planda oynatılırken bildirim yayınlayan ses uygulamaları için kullanışlıdır. Uygulamalar, hizmetin onCreate() bölümünde SessionManager dinleyicilerini kaydedebilir ve hizmetin onDestroy() bölümünde kaydı iptal edebilir. Uygulamalar, arka plandayken her zaman yerelden uzaktan geri çağırmaları (ör. onSessionStarted) almalıdır.

Uygulama MediaBrowserService kullanıyorsa SessionManagerListener'yi buraya kaydetmeniz önerilir.

Kotlin
class MyService : Service() {
    private var castContext: CastContext? = null
    protected fun onCreate() {
        castContext = CastContext.getSharedInstance(this)
        castContext
            .getSessionManager()
            .addSessionManagerListener(sessionManagerListener, CastSession::class.java)
    }

    protected fun onDestroy() {
        if (castContext != null) {
            castContext
                .getSessionManager()
                .removeSessionManagerListener(sessionManagerListener, CastSession::class.java)
        }
    }
}
Java
public class MyService extends Service {
  private CastContext castContext;

  @Override
  protected void onCreate() {
     castContext = CastContext.getSharedInstance(this);
     castContext
        .getSessionManager()
        .addSessionManagerListener(sessionManagerListener, CastSession.class);
  }

  @Override
  protected void onDestroy() {
    if (castContext != null) {
       castContext
          .getSessionManager()
          .removeSessionManagerListener(sessionManagerListener, CastSession.class);
    }
  }
}

Bu güncellemeyle birlikte, uygulama arka plandayken yerelden uzaktan kumandaya geçiş, geleneksel yayınlama ile aynı şekilde çalışır ve Bluetooth cihazlardan yayın cihazlarına geçiş için ekstra işlem yapılması gerekmez.

Uzaktan yerel ortama

Çıkış değiştirici, uzaktan oynatmadan telefon hoparlörüne veya yerel Bluetooth cihazına aktarma olanağı sağlar. Bu özellik, CastOptions sayfasında setRemoteToLocalEnabled işaretini true olarak ayarlayarak etkinleştirilebilir.

Mevcut gönderen cihazın birden fazla gönderen içeren mevcut bir oturuma katıldığı ve uygulamanın mevcut medyanın yerel olarak aktarılmasına izin verilip verilmediğini kontrol etmesi gereken durumlarda uygulamalar, SessionState değerini kontrol etmek için SessionTransferCallback sınıfının onTransferred geri çağırma işlevini kullanmalıdır.

setRemoteToLocalEnabled işaretini ayarlama

CastOptions.Builder, etkin bir yayın oturumu olduğunda çıkış değiştirici iletişim kutusunda telefon hoparlörünü ve yerel Bluetooth cihazlarını aktarım hedefi olarak göstermek veya gizlemek için bir setRemoteToLocalEnabled sağlar.

Kotlin
class CastOptionsProvider : OptionsProvider {
    fun getCastOptions(context: Context?): CastOptions {
        ...
        return Builder()
            ...
            .setRemoteToLocalEnabled(true)
            .build()
    }
}
Java
public class CastOptionsProvider implements OptionsProvider {
    @Override
    public CastOptions getCastOptions(Context context) {
        ...
        return new CastOptions.Builder()
            ...
            .setRemoteToLocalEnabled(true)
            .build()
  }
}

Oynatmaya yerel olarak devam etme

Uzaktan yerel oynatmayı destekleyen uygulamalar, etkinlik gerçekleştiğinde bildirim almak için SessionTransferCallback öğesini kaydetmelidir. Böylece, medyanın aktarılmasına ve yerel olarak oynatılmaya devam edilmesine izin verilip verilmeyeceğini kontrol edebilirler.

CastContext#addSessionTransferCallback(SessionTransferCallback), bir uygulamanın SessionTransferCallback değerini kaydetmesine ve bir gönderen yerel oynatmaya aktarıldığında onTransferred ve onTransferFailed geri çağırmalarını dinlemesine olanak tanır.

Uygulama, SessionTransferCallback kaydını sildikten sonra artık SessionTransferCallback almaz.

SessionTransferCallback, mevcut SessionManagerListener geri çağırmalarının bir uzantısıdır ve onSessionEnded tetiklendikten sonra tetiklenir. Uzaktan yerele geri çağırmaların sırası şu şekildedir:

  1. onTransferring
  2. onSessionEnding
  3. onSessionEnded
  4. onTransferred

Uygulama arka planda çalışırken ve yayın yaparken çıkış değiştirici, medya bildirim çipi tarafından açılabildiğinden uygulamaların, arka planda oynatmayı destekleyip desteklemediklerine bağlı olarak yerel cihaza aktarımı farklı şekilde işlemesi gerekir. Aktarım başarısız olursa onTransferFailed, hata oluştuğu anda tetiklenir.

Arka planda oynatmayı destekleyen uygulamalar

Arka planda oynatmayı destekleyen uygulamalarda (genellikle ses uygulamaları) Service (ör. MediaBrowserService) kullanılması önerilir. Hizmetler, onTransferred geri çağırma işlevini dinlemeli ve uygulama ön planda veya arka plandayken oynatmayı yerel olarak devam ettirmelidir.

Kotlin
class MyService : Service() {
    private var castContext: CastContext? = null
    private var sessionTransferCallback: SessionTransferCallback? = null
    protected fun onCreate() {
        castContext = CastContext.getSharedInstance(this)
        castContext.getSessionManager()
                   .addSessionManagerListener(sessionManagerListener, CastSession::class.java)
        sessionTransferCallback = MySessionTransferCallback()
        castContext.addSessionTransferCallback(sessionTransferCallback)
    }

    protected fun onDestroy() {
        if (castContext != null) {
            castContext.getSessionManager()
                       .removeSessionManagerListener(sessionManagerListener, CastSession::class.java)
            if (sessionTransferCallback != null) {
                castContext.removeSessionTransferCallback(sessionTransferCallback)
            }
        }
    }

    class MySessionTransferCallback : SessionTransferCallback() {
        fun onTransferring(@SessionTransferCallback.TransferType transferType: Int) {
            // Perform necessary steps prior to onTransferred
        }

        fun onTransferred(@SessionTransferCallback.TransferType transferType: Int,
                          sessionState: SessionState?) {
            if (transferType == SessionTransferCallback.TRANSFER_TYPE_FROM_REMOTE_TO_LOCAL) {
                // Remote stream is transferred to the local device.
                // Retrieve information from the SessionState to continue playback on the local player.
            }
        }

        fun onTransferFailed(@SessionTransferCallback.TransferType transferType: Int,
                             @SessionTransferCallback.TransferFailedReason transferFailedReason: Int) {
            // Handle transfer failure.
        }
    }
}
Java
public class MyService extends Service {
    private CastContext castContext;
    private SessionTransferCallback sessionTransferCallback;

    @Override
    protected void onCreate() {
        castContext = CastContext.getSharedInstance(this);
        castContext.getSessionManager()
                   .addSessionManagerListener(sessionManagerListener, CastSession.class);
        sessionTransferCallback = new MySessionTransferCallback();
        castContext.addSessionTransferCallback(sessionTransferCallback);
    }

    @Override
    protected void onDestroy() {
        if (castContext != null) {
            castContext.getSessionManager()
                       .removeSessionManagerListener(sessionManagerListener, CastSession.class);
            if (sessionTransferCallback != null) {
                castContext.removeSessionTransferCallback(sessionTransferCallback);
            }
        }
    }

    public static class MySessionTransferCallback extends SessionTransferCallback {
        public MySessionTransferCallback() {}

        @Override
        public void onTransferring(@SessionTransferCallback.TransferType int transferType) {
            // Perform necessary steps prior to onTransferred
        }

        @Override
        public void onTransferred(@SessionTransferCallback.TransferType int transferType,
                                  SessionState sessionState) {
            if (transferType==SessionTransferCallback.TRANSFER_TYPE_FROM_REMOTE_TO_LOCAL) {
                // Remote stream is transferred to the local device.
                // Retrieve information from the SessionState to continue playback on the local player.
            }
        }

        @Override
        public void onTransferFailed(@SessionTransferCallback.TransferType int transferType,
                                     @SessionTransferCallback.TransferFailedReason int transferFailedReason) {
            // Handle transfer failure.
        }
    }
}

Arka planda oynatmayı desteklemeyen uygulamalar

Arka planda oynatmayı desteklemeyen uygulamalarda (genellikle video uygulamaları) onTransferred geri çağırma işlevini dinlemeniz ve uygulama ön plandaysa oynatmayı yerel olarak devam ettirmeniz önerilir.

Uygulama arka plandaysa oynatmayı duraklatmalı ve SessionState'dan gerekli bilgileri (ör. medya meta verileri ve oynatma konumu) depolamalıdır. Uygulama arka plandan ön plana getirildiğinde yerel oynatma, depolanan bilgilerle devam etmelidir.

Kotlin
class MyActivity : AppCompatActivity() {
    private var castContext: CastContext? = null
    private var sessionTransferCallback: SessionTransferCallback? = null
    protected fun onCreate() {
        castContext = CastContext.getSharedInstance(this)
        castContext.getSessionManager()
                   .addSessionManagerListener(sessionManagerListener, CastSession::class.java)
        sessionTransferCallback = MySessionTransferCallback()
        castContext.addSessionTransferCallback(sessionTransferCallback)
    }

    protected fun onDestroy() {
        if (castContext != null) {
            castContext.getSessionManager()
                       .removeSessionManagerListener(sessionManagerListener, CastSession::class.java)
            if (sessionTransferCallback != null) {
                castContext.removeSessionTransferCallback(sessionTransferCallback)
            }
        }
    }

    class MySessionTransferCallback : SessionTransferCallback() {
        fun onTransferring(@SessionTransferCallback.TransferType transferType: Int) {
            // Perform necessary steps prior to onTransferred
        }

        fun onTransferred(@SessionTransferCallback.TransferType transferType: Int,
                          sessionState: SessionState?) {
            if (transferType == SessionTransferCallback.TRANSFER_TYPE_FROM_REMOTE_TO_LOCAL) {
                // Remote stream is transferred to the local device.

                // Retrieve information from the SessionState to continue playback on the local player.
            }
        }

        fun onTransferFailed(@SessionTransferCallback.TransferType transferType: Int,
                             @SessionTransferCallback.TransferFailedReason transferFailedReason: Int) {
            // Handle transfer failure.
        }
    }
}
Java
public class MyActivity extends AppCompatActivity {
  private CastContext castContext;
  private SessionTransferCallback sessionTransferCallback;

  @Override
  protected void onCreate() {
     castContext = CastContext.getSharedInstance(this);
     castContext
        .getSessionManager()
        .addSessionManagerListener(sessionManagerListener, CastSession.class);
     sessionTransferCallback = new MySessionTransferCallback();
     castContext.addSessionTransferCallback(sessionTransferCallback);
  }

  @Override
  protected void onDestroy() {
    if (castContext != null) {
       castContext
          .getSessionManager()
          .removeSessionManagerListener(sessionManagerListener, CastSession.class);
      if (sessionTransferCallback != null) {
         castContext.removeSessionTransferCallback(sessionTransferCallback);
      }
    }
  }

  public static class MySessionTransferCallback extends SessionTransferCallback {
    public MySessionTransferCallback() {}

    @Override
    public void onTransferring(@SessionTransferCallback.TransferType int transferType) {
        // Perform necessary steps prior to onTransferred
    }

    @Override
    public void onTransferred(@SessionTransferCallback.TransferType int transferType,
                               SessionState sessionState) {
      if (transferType==SessionTransferCallback.TRANSFER_TYPE_FROM_REMOTE_TO_LOCAL) {
        // Remote stream is transferred to the local device.

        // Retrieve information from the SessionState to continue playback on the local player.
      }
    }

    @Override
    public void onTransferFailed(@SessionTransferCallback.TransferType int transferType,
                                 @SessionTransferCallback.TransferFailedReason int transferFailedReason) {
      // Handle transfer failure.
    }
  }
}

Uzaktan kumandadan uzaktan kumandaya

Çıkış değiştirici, akış genişletme özelliğini kullanan ses uygulamaları için birden fazla Cast uyumlu hoparlör cihazına genişletme özelliğini destekler.

Ses uygulamaları, Google Cast SDK Geliştirici Konsolu'ndaki Alıcı Uygulama ayarlarında Google Cast for Audio'yu destekleyen uygulamalardır.

Hoparlörlerle akış genişletme

Çıkış Değiştirici'yi kullanan ses uygulamaları, Akış Genişletme özelliğini kullanarak bir yayın oturumu sırasında sesi birden fazla Cast uyumlu hoparlör cihazına genişletebilir.

Bu özellik, Cast platformu tarafından desteklenir ve uygulama varsayılan kullanıcı arayüzünü kullanıyorsa başka değişiklik yapılması gerekmez. Özel bir kullanıcı arayüzü kullanılıyorsa uygulama, kullanıcı arayüzünü uygulamanın bir gruba yayın yaptığını yansıtacak şekilde güncellemelidir.

Akış genişletme sırasında yeni genişletilmiş grup adını almak için CastSession#addCastListener kullanarak bir Cast.Listener kaydedin. Ardından onDeviceNameChanged geri arama sırasında CastSession#getCastDevice() numarasını arayın.

Kotlin
class MyActivity : Activity() {
    private var mCastSession: CastSession? = null
    private lateinit var mCastContext: CastContext
    private lateinit var mSessionManager: SessionManager
    private val mSessionManagerListener: SessionManagerListener<CastSession> =
        SessionManagerListenerImpl()
    private val mCastListener = CastListener()

    private inner class SessionManagerListenerImpl : SessionManagerListener<CastSession?> {
        override fun onSessionStarting(session: CastSession?) {}

        override fun onSessionStarted(session: CastSession?, sessionId: String) {
            addCastListener(session)
        }

        override fun onSessionStartFailed(session: CastSession?, error: Int) {}

        override fun onSessionSuspended(session: CastSession?, reason Int) {
            removeCastListener()
        }

        override fun onSessionResuming(session: CastSession?, sessionId: String) {}

        override fun onSessionResumed(session: CastSession?, wasSuspended: Boolean) {
            addCastListener(session)
        }

        override fun onSessionResumeFailed(session: CastSession?, error: Int) {}

        override fun onSessionEnding(session: CastSession?) {}

        override fun onSessionEnded(session: CastSession?, error: Int) {
            removeCastListener()
        }
    }

    private inner class CastListener : Cast.Listener() {
        override fun onDeviceNameChanged() {
            mCastSession?.let {
                val castDevice = it.castDevice
                val deviceName = castDevice.friendlyName
                // Update UIs with the new cast device name.
            }
        }
    }

    private fun addCastListener(castSession: CastSession) {
        mCastSession = castSession
        mCastSession?.addCastListener(mCastListener)
    }

    private fun removeCastListener() {
        mCastSession?.removeCastListener(mCastListener)
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        mCastContext = CastContext.getSharedInstance(this)
        mSessionManager = mCastContext.sessionManager
        mSessionManager.addSessionManagerListener(mSessionManagerListener, CastSession::class.java)
    }

    override fun onDestroy() {
        super.onDestroy()
        mSessionManager.removeSessionManagerListener(mSessionManagerListener, CastSession::class.java)
    }
}
Java
public class MyActivity extends Activity {
    private CastContext mCastContext;
    private CastSession mCastSession;
    private SessionManager mSessionManager;
    private SessionManagerListener<CastSession> mSessionManagerListener =
            new SessionManagerListenerImpl();
    private Cast.Listener mCastListener = new CastListener();

    private class SessionManagerListenerImpl implements SessionManagerListener<CastSession> {
        @Override
        public void onSessionStarting(CastSession session) {}
        @Override
        public void onSessionStarted(CastSession session, String sessionId) {
            addCastListener(session);
        }
        @Override
        public void onSessionStartFailed(CastSession session, int error) {}
        @Override
        public void onSessionSuspended(CastSession session, int reason) {
            removeCastListener();
        }
        @Override
        public void onSessionResuming(CastSession session, String sessionId) {}
        @Override
        public void onSessionResumed(CastSession session, boolean wasSuspended) {
            addCastListener(session);
        }
        @Override
        public void onSessionResumeFailed(CastSession session, int error) {}
        @Override
        public void onSessionEnding(CastSession session) {}
        @Override
        public void onSessionEnded(CastSession session, int error) {
            removeCastListener();
        }
    }

    private class CastListener extends Cast.Listener {
         @Override
         public void onDeviceNameChanged() {
             if (mCastSession == null) {
                 return;
             }
             CastDevice castDevice = mCastSession.getCastDevice();
             String deviceName = castDevice.getFriendlyName();
             // Update UIs with the new cast device name.
         }
    }

    private void addCastListener(CastSession castSession) {
        mCastSession = castSession;
        mCastSession.addCastListener(mCastListener);
    }

    private void removeCastListener() {
        if (mCastSession != null) {
            mCastSession.removeCastListener(mCastListener);
        }
    }

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        mCastContext = CastContext.getSharedInstance(this);
        mSessionManager = mCastContext.getSessionManager();
        mSessionManager.addSessionManagerListener(mSessionManagerListener, CastSession.class);
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        mSessionManager.removeSessionManagerListener(mSessionManagerListener, CastSession.class);
    }
}

Uzaktan uzaktan test etme

Özelliği test etmek için:

  1. İçeriğinizi geleneksel yayınlama yöntemini veya yerelden uzaktan kumandaya yöntemini kullanarak Cast uyumlu bir cihaza yayınlayın.
  2. Giriş noktalarından birini kullanarak çıkış değiştiriciyi açın.
  3. Cast uyumlu başka bir cihaza dokunduğunuzda ses uygulamaları, içeriği ek cihaza genişleterek dinamik bir grup oluşturur.
  4. Cast uyumlu cihaza tekrar dokunduğunuzda cihaz, dinamik gruptan kaldırılır.