Çıkış değiştirici, Android 13'ten itibaren içeriklerin yerel ve uzaktan oynatılması arasında sorunsuz aktarım sağlayan Cast SDK ö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, içerik oynatmayı telefon hoparlörü, eşlenmiş Bluetooth cihazlar ve uzaktaki Cast özellikli cihazlar arasında değiştirmek için MediaRouter
kitaplığını kullanır. Kullanım alanları aşağıdaki senaryolara ayrılabilir:
- Yerelden uzağa
- Uzak-yerel
- Uzaktan uzaktan (Remote-to-remote)
Uygulamanızda Çıkış Değiştirici'yi nasıl uygulayacağınızla ilgili referans için CastVideos-android örnek uygulamasını indirip kullanın.
Bu kılavuzda belirtilen adımları uygulayarak yerelden uzağa, uzaktan yerel ve uzaktan uzağa bağlantı kurmak için Çıkış Değiştirici'nin etkinleştirilmesi gerekir. Yerel cihaz hoparlörleri ile eşlenmiş 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, yerel ve uzak cihazların yanı sıra cihazın seçilip seçilmediği, bağlanıp bağlanmadığı ve mevcut ses düzeyi gibi mevcut cihaz durumlarını gösterir. Mevcut cihazın yanı sıra başka cihazlar da varsa diğer cihazı tıkladığınızda medya oynatma işlemini seçilen cihaza aktarabilirsiniz.
Bilinen sorunlar
- Yerel oynatma için oluşturulan medya oturumları, Cast SDK bildirimine geçildiğinde kapatılıp yeniden oluşturulur.
Giriş noktaları
Medya bildirimi
Bir uygulama, yerel oynatma (yerel olarak oynatma) için MediaSession
simgesini içeren bir medya bildirimi yayınlarsa medya bildiriminin sağ üst köşesinde, içeriğin şu anda oynatıldığı cihaz 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 dokunularak ve "Play <App Name> on <Cast Device>" metnine dokunularak da tetiklenebilir.
Adımların özeti
- Ön koşulların karşılandığından emin olun
- AndroidManifest.xml dosyasında çıkış değiştiriciyi etkinleştirme
- Arka planda yayın için SessionManagerListener'ı güncelleme
- Uzak-Uzak bağlantı desteği ekleme
- setRemoteToLocalEnabled işaretini ayarlayın
- Oynatmaya yerel olarak devam etme
Ön koşullar
- Mevcut Android uygulamanızı AndroidX'e taşıyın.
- Uygulamanızın
build.gradle
sürümünü, Çıkış Değiştirici için Android Sender SDK'nın gerekli minimum sürümünü kullanacak şekilde güncelleyin:dependencies { ... implementation 'com.google.android.gms:play-services-cast-framework:21.2.0' ... }
- Uygulama, medya bildirimlerini destekliyor.
- Android 13'ün yüklü olduğu cihaz
Medya bildirimlerini ayarlama
Çıkış değiştiriciyi kullanmak için ses ve video uygulamalarının, oynatma durumunu ve yerel oynatma için medyalarına yönelik kontrolleri göstermek üzere medya bildirimi oluşturması gerekir. Bunun için MediaSession
oluşturmanız, MediaStyle
değerini MediaSession
'nin jetonuyla ayarlamanız ve bildirimdeki 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. Ayrıca, ses ve video uygulamaları için medya oturumu geri çağırmalarını ayarlama kılavuzları da mevcuttur:
// 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)
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 MediaSession
meta verilerini ve oynatma durumunu eklemeniz gerekir.
MediaSession
meta verilerini eklemek için setMetaData()
kullanın ve MediaMetadataCompat.Builder()
içinde medyanızla ilgili tüm MediaMetadata
sabitlerini sağlayın.
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() )
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.
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() )
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önderilmesiyle ilgili sorunları önlemek için medya bildirimleriyle ilgili 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ı duraklatın ve bildirimi kapatın.
- Uygulama tekrar ön plana geçtiğinde yerel oynatma devam etmeli ve bildirim yeniden yayınlanmalıdır.
AndroidManifest.xml dosyasında çıkış değiştiriciyi etkinleştirme
Çıkış değiştiriciyi etkinleştirmek için MediaTransferReceiver
, uygulamanın AndroidManifest.xml
bölümüne eklenmelidir. Aksi takdirde özellik etkinleştirilmez ve uzak-yerel özellik işareti de geçersiz olur.
<application>
...
<receiver
android:name="androidx.mediarouter.media.MediaTransferReceiver"
android:exported="true">
</receiver>
...
</application>
MediaTransferReceiver
, sistem kullanıcı arayüzü olan cihazlar arasında medya aktarımını sağlayan bir yayın alıcısıdır. Daha fazla bilgi için MediaTransferReceiver
referansını inceleyin.
Yerelden uzağa
Kullanıcı, oynatmayı yerelden uzağa değiştirdiğinde Cast SDK, Cast oturumunu otomatik olarak başlatır. Ancak uygulamaların yerelden uzağa geçişi işlemesi gerekir. Örneğin, yerel oynatmayı durdurup medyayı Cast cihazına yüklemesi gerekir. Uygulamalar, Cast
SessionManagerListener
, onSessionStarted()
ve
onSessionEnded()
geri çağırmalarını kullanarak dinlemeli ve Cast
SessionManager
geri çağırmalarını aldığında 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 olmasını sağlamalıdır.
Arka planda yayın için SessionManagerListener'ı güncelleme
Eski Cast deneyimi, uygulama ön planda olduğunda yerelden uzağa aktarımı zaten desteklemektedir. Tipik bir Cast deneyimi, kullanıcıların uygulamada Cast simgesini tıklayıp medya yayınlamak için bir cihaz seçmesiyle başlar. Bu durumda uygulamanın, onCreate()
veya onStart()
içinde SessionManagerListener
'ye kaydolması, uygulamanın etkinliğinin onStop()
veya onDestroy()
içinde işleyicinin kaydını silmesi gerekir.
Çıkış değiştirici kullanılarak yapılan yeni yayın deneyimiyle uygulamalar, arka planda çalışırken yayın yapmaya başlayabilir. Bu özellik, özellikle arka planda oynatılırken bildirim gönderen ses uygulamaları için kullanışlıdır. Uygulamalar, hizmetin SessionManager
dinleyicilerini hizmetin onCreate()
bölümüne kaydedebilir ve hizmetin onDestroy()
bölümünde kaydı silebilir. Uygulama arka plandayken uygulamalar her zaman yerelden uzağa geri çağırmaları (ör. onSessionStarted
) almalıdır.
Uygulama MediaBrowserService
kullanıyorsa SessionManagerListener
'ı burada kaydetmeniz önerilir.
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) } } }
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 uzağa yayınlama işlemi geleneksel yayınlama ile aynı şekilde çalışır. Bluetooth cihazlardan Cast cihazlara geçiş için ek işlem yapılması gerekmez.
Uzak konumdan yerel konuma
Çıkış değiştirici, uzaktan oynatmadan telefon hoparlörüne veya yerel Bluetooth cihazına aktarım yapma olanağı sunar. Bu özellik, CastOptions
sayfasında setRemoteToLocalEnabled
bayrağı true
olarak ayarlanarak etkinleştirilebilir.
Mevcut gönderen cihazın birden fazla göndereni olan mevcut bir oturuma katıldığı ve uygulamanın mevcut medyanın yerel olarak aktarılmasına izin verilip verilmediğini kontrol etmesi gerektiği durumlarda, uygulamalar SessionState
'ı kontrol etmek için SessionTransferCallback
'ın onTransferred
geri çağırmasını kullanmalıdır.
setRemoteToLocalEnabled işaretini ayarlayın
CastOptions.Builder
, etkin bir yayınlama 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 setRemoteToLocalEnabled
sağlar.
class CastOptionsProvider : OptionsProvider { fun getCastOptions(context: Context?): CastOptions { ... return Builder() ... .setRemoteToLocalEnabled(true) .build() } }
public class CastOptionsProvider implements OptionsProvider { @Override public CastOptions getCastOptions(Context context) { ... return new CastOptions.Builder() ... .setRemoteToLocalEnabled(true) .build() } }
Oynatmayı yerel olarak devam ettirme
Uzak-yerel özelliğini destekleyen uygulamalar, etkinlik gerçekleştiğinde bildirim almak için SessionTransferCallback
kaydı yapmalıdır. Böylece, medyanın aktarılmasına izin verilip verilmeyeceğini ve yerel olarak oynatılmaya devam edilip edilmeyeceğini kontrol edebilirler.
CastContext#addSessionTransferCallback(SessionTransferCallback)
Bir uygulamanın SessionTransferCallback
kaydetmesine ve gönderen yerel oynatmaya aktarıldığında onTransferred
ve onTransferFailed
geri aramalarını dinlemesine olanak tanır.
Uygulama SessionTransferCallback
kaydını kaldırdıktan sonra artık SessionTransferCallback
almaz.
SessionTransferCallback
, mevcut SessionManagerListener
geri aramalarının bir uzantısıdır ve onSessionEnded
tetiklendikten sonra tetiklenir. Uzak-yerel geri aramaların sırası şöyledir:
onTransferring
onSessionEnding
onSessionEnded
onTransferred
Çıkış değiştirici, uygulama arka planda çalışırken ve yayın yaparken medya bildirimi çipiyle açılabildiğinden uygulamaların, arka planda oynatmayı destekleyip desteklemediklerine bağlı olarak yerel aktarımı farklı şekilde işlemesi gerekir. Aktarımın başarısız olması durumunda, onTransferFailed
hata oluştuğu her an tetiklenir.
Arka planda oynatmayı destekleyen uygulamalar
Arka planda oynatmayı destekleyen uygulamalar (genellikle ses uygulamaları) için Service
(örneğin MediaBrowserService
) kullanılması önerilir. Hizmetler, onTransferred
geri çağırma işlevini dinlemeli ve uygulama ön planda veya arka planda olduğunda oynatmaya yerel olarak devam etmelidir.
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. } } }
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 aramayı dinlemeniz ve uygulama ön plandaysa oynatmaya yerel olarak devam etmeniz önerilir.
Uygulama arka plandaysa oynatmayı duraklatmalı ve SessionState
'dan gerekli bilgileri (ör. medya meta verileri ve oynatma konumu) saklamalıdır. Uygulama arka plandan ön plana getirildiğinde yerel oynatma, depolanan bilgilerle devam etmelidir.
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. } } }
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. } } }
Uzak cihazdan uzak cihaza
Çıkış değiştirici, akış genişletme özelliğini kullanan ses uygulamaları için birden fazla yayın özellikli 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ştiriciyi kullanan ses uygulamaları, akış genişletme özelliğini kullanarak Cast oturumu sırasında sesi Cast özellikli birden fazla 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ü uygulamada bir gruba yayın yapıldığını yansıtacak şekilde güncellemelidir.
Yayın genişletme sırasında yeni genişletilmiş grup adını almak için CastSession#addCastListener
kullanarak Cast.Listener
kaydettirin.
Ardından, onDeviceNameChanged
geri arama sırasında CastSession#getCastDevice()
numaralı telefonu arayın.
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) } }
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:
- Geleneksel yayınlama veya yerelden uzağa yayınlama özelliğini kullanarak içeriğinizi Cast uyumlu bir cihaza yayınlayın.
- Giriş noktalarından birini kullanarak Çıkış Değiştirici'yi açın.
- Başka bir Cast özellikli cihaza dokunduğunuzda ses uygulamaları, içeriği ek cihaza genişleterek dinamik bir grup oluşturur.
- Cast özellikli cihaza tekrar dokunduğunuzda cihaz, dinamik gruptan kaldırılır.