Questa guida per gli sviluppatori descrive come aggiungere il supporto di Google Cast alla tua app mittente Android utilizzando l'SDK Android Sender.
Il dispositivo mobile o laptop è il mittente che controlla la riproduzione, mentre il dispositivo Google Cast è il destinatario che mostra i contenuti sulla TV.
Il framework del mittente si riferisce al programma binario della libreria di classi di trasmissione e alle risorse associate presenti in fase di esecuzione sul mittente. L'app mittente o l'app Trasmetti si riferisce a un'app in esecuzione anche sul mittente. L'app Ricevitore web si riferisce all'applicazione HTML in esecuzione sul dispositivo compatibile con Google Cast.
Il framework del mittente utilizza un design asincrono di callback per informare l'app del mittente degli eventi e per passare da uno stato all'altro del ciclo di vita dell'app di trasmissione.
Flusso dell'app
I seguenti passaggi descrivono il flusso di esecuzione tipico di alto livello per un'app per Android mittente:
- Il framework di trasmissione avvia automaticamente il rilevamento dei dispositivi
MediaRouter
in base al ciclo di vitaActivity
. - Quando l'utente fa clic sul pulsante Trasmetti, il framework presenta la finestra di dialogo Trasmetti con l'elenco dei dispositivi di trasmissione rilevati.
- Quando l'utente seleziona un dispositivo di trasmissione, il framework tenta di avviare l'app Ricevitore web sul dispositivo di trasmissione.
- Il framework richiama i callback nell'app del mittente per confermare che l'app Web Receiver è stata avviata.
- Il framework crea un canale di comunicazione tra le app del mittente e del ricevitore web.
- Il framework utilizza il canale di comunicazione per caricare e controllare la riproduzione dei contenuti multimediali sul ricevitore web.
- Il framework sincronizza lo stato di riproduzione dei contenuti multimediali tra il mittente e il ricevitore web: quando l'utente esegue azioni dell'interfaccia utente del mittente, il framework trasmette le richieste di controllo dei contenuti multimediali al ricevitore web e, quando quest'ultimo invia gli aggiornamenti dello stato dei contenuti multimediali, il framework aggiorna lo stato dell'interfaccia utente del mittente.
- Quando l'utente fa clic sul pulsante Trasmetti per disconnettersi dal dispositivo di trasmissione, il framework disconnette l'app del mittente dal ricevitore web.
Per un elenco completo di tutti i corsi, i metodi e gli eventi nell'SDK Google Cast per Android, consulta il riferimento API di Google Cast Sender per Android. Nelle sezioni che seguono viene spiegata la procedura per aggiungere Cast all'app Android.
Configurare il file manifest Android
Il file AndroidManifest.xml dell'app richiede la configurazione dei seguenti elementi per l'SDK Cast:
usa-sdk
Imposta i livelli API minimi e target di Android supportati da Cast SDK. Attualmente il livello minimo è il livello API 21 e il target è il livello API 28.
<uses-sdk
android:minSdkVersion="21"
android:targetSdkVersion="28" />
android:theme
Imposta il tema dell'app in base alla versione minima dell'SDK Android. Ad esempio, se non implementi il tuo tema, devi utilizzare una variante di Theme.AppCompat
quando scegli come target una versione minima dell'SDK Android pre-Lollipop.
<application
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/Theme.AppCompat" >
...
</application>
Inizializza il contesto di trasmissione
Il framework ha un oggetto singleton globale, CastContext
, che coordina
tutte le interazioni del framework.
La tua app deve implementare l'interfaccia
OptionsProvider
per fornire le opzioni necessarie per inizializzare il
singolo CastContext
. OptionsProvider
fornisce un'istanza di
CastOptions
che contiene opzioni che influiscono sul comportamento del framework. Il più
importante di questi è l'ID applicazione web Ricevitore, che viene utilizzato per filtrare
i risultati del rilevamento e per avviare l'app Web Receiver all'avvio della
sessione di trasmissione.
class CastOptionsProvider : OptionsProvider { override fun getCastOptions(context: Context): CastOptions { return Builder() .setReceiverApplicationId(context.getString(R.string.app_id)) .build() } override fun getAdditionalSessionProviders(context: Context): List<SessionProvider>? { return null } }
public class CastOptionsProvider implements OptionsProvider { @Override public CastOptions getCastOptions(Context context) { CastOptions castOptions = new CastOptions.Builder() .setReceiverApplicationId(context.getString(R.string.app_id)) .build(); return castOptions; } @Override public List<SessionProvider> getAdditionalSessionProviders(Context context) { return null; } }
Devi dichiarare il nome completo dell'elemento OptionsProvider
implementato come campo di metadati nel file AndroidManifest.xml dell'app del mittente:
<application>
...
<meta-data
android:name=
"com.google.android.gms.cast.framework.OPTIONS_PROVIDER_CLASS_NAME"
android:value="com.foo.CastOptionsProvider" />
</application>
CastContext
viene inizializzato lentamente quando viene chiamato l'elemento CastContext.getSharedInstance()
.
class MyActivity : FragmentActivity() { override fun onCreate(savedInstanceState: Bundle?) { val castContext = CastContext.getSharedInstance(this) } }
public class MyActivity extends FragmentActivity { @Override public void onCreate(Bundle savedInstanceState) { CastContext castContext = CastContext.getSharedInstance(this); } }
Widget UX di Cast
Il framework Cast fornisce i widget conformi all'elenco di controllo della progettazione di Cast:
Overlay di lancio: il framework fornisce una vista personalizzata,
IntroductoryOverlay
, che viene mostrata all'utente per richiamare l'attenzione sul pulsante Trasmetti la prima volta che è disponibile un ricevitore. L'app Mittente può personalizzare il testo e la posizione del testo del titolo.Pulsante Trasmetti: il pulsante Trasmetti è visibile quando viene rilevato un ricevitore che supporta la tua app. Quando l'utente fa clic per la prima volta sul pulsante Trasmetti, viene visualizzata una finestra di dialogo che elenca i dispositivi rilevati. Quando l'utente fa clic sul pulsante Trasmetti mentre il dispositivo è connesso, visualizza i metadati multimediali correnti (come titolo, nome dello studio di registrazione e immagine in miniatura) oppure consente all'utente di disconnettersi dal dispositivo di trasmissione.
Mini controller: quando l'utente trasmette contenuti ed è uscito dalla pagina dei contenuti corrente o da un altro controller espanso a un'altra schermata dell'app del mittente, il mini controller viene visualizzato nella parte inferiore dello schermo per consentire all'utente di visualizzare i metadati multimediali trasmessi attualmente e per controllare la riproduzione.
Controller espanso: quando l'utente trasmette contenuti, se fa clic sulla notifica multimediale o sul mini controller, viene avviato il controller espanso, che mostra i contenuti multimediali attualmente in riproduzione e dispone di diversi pulsanti per controllare la riproduzione dei contenuti multimediali.
Notifica: solo Android. Quando l'utente trasmette contenuti e si allontana dall'app del mittente, viene visualizzata una notifica multimediale che mostra i metadati dei contenuti multimediali e i controlli di riproduzione che stai trasmettendo.
Schermata di blocco: solo Android. Quando l'utente trasmette contenuti e naviga (o il dispositivo è scaduto) alla schermata di blocco, viene visualizzato un controllo della schermata di blocco per i contenuti multimediali che mostra i controlli per la riproduzione e i metadati multimediali per la trasmissione al momento.
La seguente guida include descrizioni di come aggiungere questi widget all'app.
Aggiungi un pulsante Trasmetti
Le API Android MediaRouter
sono progettate per consentire la visualizzazione e la riproduzione di contenuti multimediali sui dispositivi secondari.
Le app Android che utilizzano l'API MediaRouter
devono includere un pulsante Trasmetti nell'interfaccia utente
per consentire agli utenti di selezionare un percorso multimediale per riprodurre i contenuti multimediali su
un dispositivo secondario come un dispositivo di trasmissione.
Il framework semplifica l'aggiunta di MediaRouteButton
come Cast button
. Devi prima aggiungere una voce di menu o un MediaRouteButton
nel file XML che definisce il menu e utilizzare CastButtonFactory
per collegarlo al framework.
// To add a Cast button, add the following snippet.
// menu.xml
<item
android:id="@+id/media_route_menu_item"
android:title="@string/media_route_menu_title"
app:actionProviderClass="androidx.mediarouter.app.MediaRouteActionProvider"
app:showAsAction="always" />
// Then override the onCreateOptionMenu() for each of your activities. // MyActivity.kt override fun onCreateOptionsMenu(menu: Menu): Boolean { super.onCreateOptionsMenu(menu) menuInflater.inflate(R.menu.main, menu) CastButtonFactory.setUpMediaRouteButton( applicationContext, menu, R.id.media_route_menu_item ) return true }
// Then override the onCreateOptionMenu() for each of your activities. // MyActivity.java @Override public boolean onCreateOptionsMenu(Menu menu) { super.onCreateOptionsMenu(menu); getMenuInflater().inflate(R.menu.main, menu); CastButtonFactory.setUpMediaRouteButton(getApplicationContext(), menu, R.id.media_route_menu_item); return true; }
Quindi, se il tuo Activity
eredita da
FragmentActivity
,
puoi aggiungere un
MediaRouteButton
al layout.
// activity_layout.xml
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:gravity="center_vertical"
android:orientation="horizontal" >
<androidx.mediarouter.app.MediaRouteButton
android:id="@+id/media_route_button"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_weight="1"
android:mediaRouteTypes="user"
android:visibility="gone" />
</LinearLayout>
// MyActivity.kt override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_layout) mMediaRouteButton = findViewById<View>(R.id.media_route_button) as MediaRouteButton CastButtonFactory.setUpMediaRouteButton(applicationContext, mMediaRouteButton) mCastContext = CastContext.getSharedInstance(this) }
// MyActivity.java @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_layout); mMediaRouteButton = (MediaRouteButton) findViewById(R.id.media_route_button); CastButtonFactory.setUpMediaRouteButton(getApplicationContext(), mMediaRouteButton); mCastContext = CastContext.getSharedInstance(this); }
Per impostare l'aspetto del pulsante Trasmetti utilizzando un tema, consulta la pagina Personalizza il pulsante Trasmetti.
Configura il rilevamento del dispositivo
Il rilevamento dei dispositivi è completamente gestito tramite
CastContext
.
Quando inizializzi CastContext, l'app del mittente specifica l'ID applicazione
del destinatario web e, facoltativamente, può richiedere il filtro degli spazi dei nomi impostando
supportedNamespaces
in
CastOptions
.
CastContext
contiene un riferimento all'elemento MediaRouter
internamente e avvierà il processo di rilevamento quando l'app del mittente entra in primo piano e si interrompe quando l'app del mittente entra in background.
class CastOptionsProvider : OptionsProvider { companion object { const val CUSTOM_NAMESPACE = "urn:x-cast:custom_namespace" } override fun getCastOptions(appContext: Context): CastOptions { val supportedNamespaces: MutableList<String> = ArrayList() supportedNamespaces.add(CUSTOM_NAMESPACE) return CastOptions.Builder() .setReceiverApplicationId(context.getString(R.string.app_id)) .setSupportedNamespaces(supportedNamespaces) .build() } override fun getAdditionalSessionProviders(context: Context): List<SessionProvider>? { return null } }
class CastOptionsProvider implements OptionsProvider { public static final String CUSTOM_NAMESPACE = "urn:x-cast:custom_namespace"; @Override public CastOptions getCastOptions(Context appContext) { List<String> supportedNamespaces = new ArrayList<>(); supportedNamespaces.add(CUSTOM_NAMESPACE); CastOptions castOptions = new CastOptions.Builder() .setReceiverApplicationId(context.getString(R.string.app_id)) .setSupportedNamespaces(supportedNamespaces) .build(); return castOptions; } @Override public List<SessionProvider> getAdditionalSessionProviders(Context context) { return null; } }
Come funziona la gestione delle sessioni
L'SDK Cast introduce il concetto di sessione Google Cast, il cui scopo consiste nel combinare i passaggi per connettersi a un dispositivo, lanciare (o partecipare) a un'app Ricevitore web, connettersi a quell'app e inizializzare un canale di controllo dei contenuti multimediali. Consulta la guida al ciclo di vita dell'applicazione per ulteriori informazioni sulle sessioni di trasmissione e sul ciclo di vita del ricevitore web.
Le sessioni sono gestite dal corso SessionManager
, a cui la tua app può accedere tramite CastContext.getSessionManager()
.
Le singole sessioni sono rappresentate da sottoclassi del corso Session
.
Ad esempio, CastSession
rappresenta le sessioni con dispositivi di trasmissione. La tua app può accedere alla sessione di trasmissione attualmente attiva tramite SessionManager.getCurrentCastSession()
.
L'app può utilizzare la classe SessionManagerListener
per monitorare gli eventi della sessione, come creazione, sospensione, ripresa e terminazione. Il framework tenta automaticamente di riprendere da una chiusura anomala/improvvisa durante una sessione attiva.
Le sessioni vengono create e eliminate automaticamente in risposta ai gesti dell'utente
nelle finestre di dialogo di MediaRouter
.
Per comprendere meglio gli errori di avvio della trasmissione, le app possono utilizzare CastContext#getCastReasonCodeForCastStatusCode(int)
per convertire l'errore di avvio della sessione in CastReasonCodes
.
Tieni presente che alcuni errori di avvio della sessione (ad esempio CastReasonCodes#CAST_CANCELLED
) sono comportamenti previsti e non devono essere registrati come errori.
Se devi conoscere le modifiche dello stato della sessione, puoi implementare SessionManagerListener
. Questo esempio ascolta la disponibilità di CastSession
in un Activity
.
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 inner class SessionManagerListenerImpl : SessionManagerListener<CastSession?> { override fun onSessionStarting(session: CastSession?) {} override fun onSessionStarted(session: CastSession?, sessionId: String) { invalidateOptionsMenu() } override fun onSessionStartFailed(session: CastSession?, error: Int) { val castReasonCode = mCastContext.getCastReasonCodeForCastStatusCode(error) // Handle error } override fun onSessionSuspended(session: CastSession?, reason Int) {} override fun onSessionResuming(session: CastSession?, sessionId: String) {} override fun onSessionResumed(session: CastSession?, wasSuspended: Boolean) { invalidateOptionsMenu() } override fun onSessionResumeFailed(session: CastSession?, error: Int) {} override fun onSessionEnding(session: CastSession?) {} override fun onSessionEnded(session: CastSession?, error: Int) { finish() } } override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) mCastContext = CastContext.getSharedInstance(this) mSessionManager = mCastContext.sessionManager } override fun onResume() { super.onResume() mCastSession = mSessionManager.currentCastSession mSessionManager.addSessionManagerListener(mSessionManagerListener, CastSession::class.java) } override fun onPause() { super.onPause() mSessionManager.removeSessionManagerListener(mSessionManagerListener, CastSession::class.java) mCastSession = null } }
public class MyActivity extends Activity { private CastContext mCastContext; private CastSession mCastSession; private SessionManager mSessionManager; private SessionManagerListener<CastSession> mSessionManagerListener = new SessionManagerListenerImpl(); private class SessionManagerListenerImpl implements SessionManagerListener<CastSession> { @Override public void onSessionStarting(CastSession session) {} @Override public void onSessionStarted(CastSession session, String sessionId) { invalidateOptionsMenu(); } @Override public void onSessionStartFailed(CastSession session, int error) { int castReasonCode = mCastContext.getCastReasonCodeForCastStatusCode(error); // Handle error } @Override public void onSessionSuspended(CastSession session, int reason) {} @Override public void onSessionResuming(CastSession session, String sessionId) {} @Override public void onSessionResumed(CastSession session, boolean wasSuspended) { invalidateOptionsMenu(); } @Override public void onSessionResumeFailed(CastSession session, int error) {} @Override public void onSessionEnding(CastSession session) {} @Override public void onSessionEnded(CastSession session, int error) { finish(); } } @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); mCastContext = CastContext.getSharedInstance(this); mSessionManager = mCastContext.getSessionManager(); } @Override protected void onResume() { super.onResume(); mCastSession = mSessionManager.getCurrentCastSession(); mSessionManager.addSessionManagerListener(mSessionManagerListener, CastSession.class); } @Override protected void onPause() { super.onPause(); mSessionManager.removeSessionManagerListener(mSessionManagerListener, CastSession.class); mCastSession = null; } }
Trasferimento dello streaming
La conservazione dello stato della sessione è la base del trasferimento dello streaming, in cui gli utenti possono spostare gli stream audio e video esistenti sui vari dispositivi utilizzando i comandi vocali, l'app Google Home o smart display. La riproduzione dei contenuti multimediali viene interrotta su un dispositivo (l'origine) e continua su un altro (la destinazione). Qualsiasi dispositivo di trasmissione con il firmware più recente può fungere da origine o destinazione in un trasferimento di streaming.
Per acquistare il nuovo dispositivo di destinazione durante un trasferimento o un'espansione del flusso, registra un Cast.Listener
utilizzando CastSession#addCastListener
.
Quindi chiama il numero CastSession#getCastDevice()
durante il callback onDeviceNameChanged
.
Per ulteriori informazioni, consulta Trasferimento dello streaming sul ricevitore web.
Riconnessione automatica
Il framework fornisce un
ReconnectionService
che può essere abilitato dall'app del mittente per gestire la riconnessione in molti
casi d'angolo, tra cui:
- Esegui il ripristino in seguito a una perdita temporanea del Wi-Fi
- Recupera dal sonno del dispositivo
- Recupera dall'app in background
- Ripristino in caso di arresto anomalo dell'app
Questo servizio è attivo per impostazione predefinita e può essere disattivato in CastOptions.Builder
.
Questo servizio può essere unito automaticamente al manifest dell'app se l'unione automatica è abilitata nel file Gradle.
Il framework avvierà il servizio al termine di una sessione multimediale e lo interromperà al termine di quest'ultima.
Come funziona il controllo dei contenuti multimediali
Il framework Cast ritira la classe RemoteMediaPlayer
da Cast 2.x a favore di una nuova classe RemoteMediaClient
, che offre la stessa funzionalità in un insieme di API più comode ed evita di dover passare in un GoogleApiClient.
Quando la tua app stabilisce un'istanza CastSession
con un'app Ricevitore web che supporta lo spazio dei nomi multimediale, il framework creerà automaticamente un'istanza di RemoteMediaClient
; la tua app può accedervi chiamando il metodo getRemoteMediaClient()
sull'istanza CastSession
.
Tutti i metodi di RemoteMediaClient
che inviano richieste al ricevitore web restituiscono un oggetto PendingResult che può essere utilizzato per monitorare la richiesta.
Si prevede che l'istanza di RemoteMediaClient
possa essere condivisa da più parti dell'app e dai componenti interni del framework, come i mini controller permanenti e il servizio di notifica.
A tal fine, questa istanza supporta la registrazione di più istanze di RemoteMediaClient.Listener
.
Imposta metadati multimediali
La classe MediaMetadata
rappresenta le informazioni su un elemento multimediale che vuoi trasmettere. L'esempio seguente crea una nuova istanza di MediaMetadata di un film e imposta il titolo, il sottotitolo e due immagini.
val movieMetadata = MediaMetadata(MediaMetadata.MEDIA_TYPE_MOVIE) movieMetadata.putString(MediaMetadata.KEY_TITLE, mSelectedMedia.getTitle()) movieMetadata.putString(MediaMetadata.KEY_SUBTITLE, mSelectedMedia.getStudio()) movieMetadata.addImage(WebImage(Uri.parse(mSelectedMedia.getImage(0)))) movieMetadata.addImage(WebImage(Uri.parse(mSelectedMedia.getImage(1))))
MediaMetadata movieMetadata = new MediaMetadata(MediaMetadata.MEDIA_TYPE_MOVIE); movieMetadata.putString(MediaMetadata.KEY_TITLE, mSelectedMedia.getTitle()); movieMetadata.putString(MediaMetadata.KEY_SUBTITLE, mSelectedMedia.getStudio()); movieMetadata.addImage(new WebImage(Uri.parse(mSelectedMedia.getImage(0)))); movieMetadata.addImage(new WebImage(Uri.parse(mSelectedMedia.getImage(1))));
Consulta la sezione Selezione delle immagini sull'utilizzo delle immagini con metadati multimediali.
Carica contenuti multimediali
L'app può caricare un elemento multimediale, come mostrato nel codice seguente. Per prima cosa, utilizza MediaInfo.Builder
con i metadati dei media per creare un'istanza MediaInfo
. Scarica
RemoteMediaClient
da CastSession
corrente, quindi carica MediaInfo
in quel
RemoteMediaClient
. Utilizza RemoteMediaClient
per riprodurre, mettere in pausa e controllare in altro modo l'app di un lettore multimediale in esecuzione sul ricevitore web.
val mediaInfo = MediaInfo.Builder(mSelectedMedia.getUrl()) .setStreamType(MediaInfo.STREAM_TYPE_BUFFERED) .setContentType("videos/mp4") .setMetadata(movieMetadata) .setStreamDuration(mSelectedMedia.getDuration() * 1000) .build() val remoteMediaClient = mCastSession.getRemoteMediaClient() remoteMediaClient.load(MediaLoadRequestData.Builder().setMediaInfo(mediaInfo).build())
MediaInfo mediaInfo = new MediaInfo.Builder(mSelectedMedia.getUrl()) .setStreamType(MediaInfo.STREAM_TYPE_BUFFERED) .setContentType("videos/mp4") .setMetadata(movieMetadata) .setStreamDuration(mSelectedMedia.getDuration() * 1000) .build(); RemoteMediaClient remoteMediaClient = mCastSession.getRemoteMediaClient(); remoteMediaClient.load(new MediaLoadRequestData.Builder().setMediaInfo(mediaInfo).build());
Consulta anche la sezione sull'utilizzo delle tracce multimediali.
Formato video 4K
Per verificare il formato del video, utilizza getVideoInfo()
in MediaStatus per ottenere l'istanza attuale di VideoInfo
.
Questa istanza contiene il tipo di formato TV HDR e l'altezza e la larghezza di visualizzazione in pixel. Le varianti in formato 4K sono indicate da costanti
HDR_TYPE_*
.
Notifiche di controllo remoto per più dispositivi
Quando un utente trasmette contenuti, anche altri dispositivi Android sulla stessa rete ricevono una notifica che consente di controllare la riproduzione. Chiunque abbia il proprio dispositivo ricevuto tali notifiche può disattivarle nell'app Impostazioni di Google > Google Cast > Mostra notifiche di controllo remoto. Le notifiche includono una scorciatoia all'app Impostazioni. Per maggiori dettagli, consulta la pagina Trasmettere le notifiche di controllo remoto.
Aggiungi mini controller
In base all'elenco di controllo della progettazione di Google Cast, un'app mittente deve fornire un controllo permanente noto come mini controller che dovrebbe essere visualizzato quando l'utente abbandona la pagina dei contenuti corrente a un'altra parte dell'app mittente. Il mini controller fornisce un promemoria visibile all'utente della sessione di trasmissione corrente. Se tocca il mini controller, l'utente può tornare alla visualizzazione espansa del controller a schermo intero di Google Cast.
Il framework fornisce una vista personalizzata, MiniControllerFragment, che puoi aggiungere alla parte inferiore del file di layout di ogni attività in cui vuoi mostrare il mini controller.
<fragment
android:id="@+id/castMiniController"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:layout_alignParentBottom="true"
android:visibility="gone"
class="com.google.android.gms.cast.framework.media.widget.MiniControllerFragment" />
Quando l'app del mittente sta riproducendo un video stream o un live streaming audio, l'SDK mostra automaticamente un pulsante di riproduzione/interruzione al posto del pulsante di riproduzione/pausa nel mini controller.
Per impostare l'aspetto del testo del titolo e del sottotitolo di questa visualizzazione personalizzata e per scegliere i pulsanti, vedi Personalizzare il mini controller.
Aggiungi controller espanso
L'elenco di controllo di Google Cast Design richiede che un'app mittente fornisca un controller espanso per i contenuti multimediali trasmessi. Il controller espanso è una versione a schermo intero del mini controller.
L'SDK Cast fornisce un widget per il controller espanso denominato
ExpandedControllerActivity
.
Si tratta di una classe astratta che è necessaria per aggiungere un pulsante Trasmetti.
Innanzitutto, crea un nuovo file di risorse di menu per consentire al controller espanso di fornire il pulsante Trasmetti:
<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>
Crea un nuovo corso che includa ExpandedControllerActivity
.
class ExpandedControlsActivity : ExpandedControllerActivity() { override fun onCreateOptionsMenu(menu: Menu): Boolean { super.onCreateOptionsMenu(menu) menuInflater.inflate(R.menu.expanded_controller, menu) CastButtonFactory.setUpMediaRouteButton(this, menu, R.id.media_route_menu_item) return true } }
public class ExpandedControlsActivity extends ExpandedControllerActivity { @Override public boolean onCreateOptionsMenu(Menu menu) { super.onCreateOptionsMenu(menu); getMenuInflater().inflate(R.menu.expanded_controller, menu); CastButtonFactory.setUpMediaRouteButton(this, menu, R.id.media_route_menu_item); return true; } }
Ora dichiara la tua nuova attività nel file manifest dell'app all'interno del tag application
:
<application>
...
<activity
android:name=".expandedcontrols.ExpandedControlsActivity"
android:label="@string/app_name"
android:launchMode="singleTask"
android:theme="@style/Theme.CastVideosDark"
android:screenOrientation="portrait"
android:parentActivityName="com.google.sample.cast.refplayer.VideoBrowserActivity">
<intent-filter>
<action android:name="android.intent.action.MAIN"/>
</intent-filter>
</activity>
...
</application>
Modifica CastOptionsProvider
e modifica NotificationOptions
e
CastMediaOptions
per impostare l'attività target sulla tua nuova attività:
override fun getCastOptions(context: Context): CastOptions? { val notificationOptions = NotificationOptions.Builder() .setTargetActivityClassName(ExpandedControlsActivity::class.java.name) .build() val mediaOptions = CastMediaOptions.Builder() .setNotificationOptions(notificationOptions) .setExpandedControllerActivityClassName(ExpandedControlsActivity::class.java.name) .build() return CastOptions.Builder() .setReceiverApplicationId(context.getString(R.string.app_id)) .setCastMediaOptions(mediaOptions) .build() }
public CastOptions getCastOptions(Context context) { NotificationOptions notificationOptions = new NotificationOptions.Builder() .setTargetActivityClassName(ExpandedControlsActivity.class.getName()) .build(); CastMediaOptions mediaOptions = new CastMediaOptions.Builder() .setNotificationOptions(notificationOptions) .setExpandedControllerActivityClassName(ExpandedControlsActivity.class.getName()) .build(); return new CastOptions.Builder() .setReceiverApplicationId(context.getString(R.string.app_id)) .setCastMediaOptions(mediaOptions) .build(); }
Aggiorna il metodo LocalPlayerActivity
loadRemoteMedia
per visualizzare
la nuova attività quando viene caricato il supporto remoto:
private fun loadRemoteMedia(position: Int, autoPlay: Boolean) { val remoteMediaClient = mCastSession?.remoteMediaClient ?: return remoteMediaClient.registerCallback(object : RemoteMediaClient.Callback() { override fun onStatusUpdated() { val intent = Intent(this@LocalPlayerActivity, ExpandedControlsActivity::class.java) startActivity(intent) remoteMediaClient.unregisterCallback(this) } }) remoteMediaClient.load( MediaLoadRequestData.Builder() .setMediaInfo(mSelectedMedia) .setAutoplay(autoPlay) .setCurrentTime(position.toLong()).build() ) }
private void loadRemoteMedia(int position, boolean autoPlay) { if (mCastSession == null) { return; } final RemoteMediaClient remoteMediaClient = mCastSession.getRemoteMediaClient(); if (remoteMediaClient == null) { return; } remoteMediaClient.registerCallback(new RemoteMediaClient.Callback() { @Override public void onStatusUpdated() { Intent intent = new Intent(LocalPlayerActivity.this, ExpandedControlsActivity.class); startActivity(intent); remoteMediaClient.unregisterCallback(this); } }); remoteMediaClient.load(new MediaLoadRequestData.Builder() .setMediaInfo(mSelectedMedia) .setAutoplay(autoPlay) .setCurrentTime(position).build()); }
Quando l'app del mittente sta riproducendo un video stream o un live streaming audio, l'SDK visualizza automaticamente un pulsante di riproduzione/interruzione al posto del pulsante di riproduzione/pausa nel controller espanso.
Per impostare l'aspetto utilizzando i temi, scegliere quali pulsanti visualizzare e aggiungere pulsanti personalizzati, consulta la pagina Personalizzare il controller espanso.
Controllo del volume
Il framework gestisce automaticamente il volume per l'app del mittente. Il framework sincronizza automaticamente le app del mittente e del ricevitore web, in modo che l'UI del mittente segnali sempre il volume specificato dal ricevitore web.
Controllo del volume del pulsante fisico
Su Android, i pulsanti fisici del dispositivo del mittente possono essere utilizzati per modificare per impostazione predefinita il volume della sessione di trasmissione sul ricevitore web per qualsiasi dispositivo che utilizzi Jelly Bean o versioni successive.
Controllo fisico del volume dei pulsanti prima di Jelly Bean
Per utilizzare i tasti del volume fisico per controllare il volume del dispositivo ricevitore web sui dispositivi Android più vecchi di Jelly Bean, l'app del mittente deve eseguire l'override di dispatchKeyEvent
nelle proprie attività e chiamare CastContext.onDispatchVolumeKeyEventBeforeJellyBean()
:
class MyActivity : FragmentActivity() { override fun dispatchKeyEvent(event: KeyEvent): Boolean { return (CastContext.getSharedInstance(this) .onDispatchVolumeKeyEventBeforeJellyBean(event) || super.dispatchKeyEvent(event)) } }
class MyActivity extends FragmentActivity { @Override public boolean dispatchKeyEvent(KeyEvent event) { return CastContext.getSharedInstance(this) .onDispatchVolumeKeyEventBeforeJellyBean(event) || super.dispatchKeyEvent(event); } }
Aggiungi controlli multimediali alle notifiche e alla schermata di blocco
Solo su Android, l'elenco di controllo di Google Cast Design richiede che un'app di mittenti implementi i controlli multimediali in una notifica e nella schermata di blocco, in cui il mittente trasmette, ma l'app del mittente non è attiva. Il
framework fornisce
MediaNotificationService
e
MediaIntentReceiver
per aiutare l'app del mittente a creare controlli multimediali in una notifica e nella schermata
di blocco.
MediaNotificationService
viene eseguito quando il mittente sta trasmettendo. Viene visualizzata una notifica con la miniatura dell'immagine e informazioni sull'elemento trasmesso corrente, un pulsante di riproduzione/pausa e un pulsante di interruzione.
MediaIntentReceiver
è un BroadcastReceiver
che gestisce le azioni degli utenti
dalla notifica.
La tua app può configurare il controllo multimediale e delle notifiche dalla schermata di blocco tramite NotificationOptions
.
L'app può configurare quali pulsanti di controllo mostrare nella notifica e quale Activity
aprire quando la notifica viene toccata dall'utente. Se le azioni non vengono specificate esplicitamente, verranno utilizzati i valori predefiniti, MediaIntentReceiver.ACTION_TOGGLE_PLAYBACK
e MediaIntentReceiver.ACTION_STOP_CASTING
.
// Example showing 4 buttons: "rewind", "play/pause", "forward" and "stop casting". val buttonActions: MutableList<String> = ArrayList() buttonActions.add(MediaIntentReceiver.ACTION_REWIND) buttonActions.add(MediaIntentReceiver.ACTION_TOGGLE_PLAYBACK) buttonActions.add(MediaIntentReceiver.ACTION_FORWARD) buttonActions.add(MediaIntentReceiver.ACTION_STOP_CASTING) // Showing "play/pause" and "stop casting" in the compat view of the notification. val compatButtonActionsIndices = intArrayOf(1, 3) // Builds a notification with the above actions. Each tap on the "rewind" and "forward" buttons skips 30 seconds. // Tapping on the notification opens an Activity with class VideoBrowserActivity. val notificationOptions = NotificationOptions.Builder() .setActions(buttonActions, compatButtonActionsIndices) .setSkipStepMs(30 * DateUtils.SECOND_IN_MILLIS) .setTargetActivityClassName(VideoBrowserActivity::class.java.name) .build()
// Example showing 4 buttons: "rewind", "play/pause", "forward" and "stop casting". List<String> buttonActions = new ArrayList<>(); buttonActions.add(MediaIntentReceiver.ACTION_REWIND); buttonActions.add(MediaIntentReceiver.ACTION_TOGGLE_PLAYBACK); buttonActions.add(MediaIntentReceiver.ACTION_FORWARD); buttonActions.add(MediaIntentReceiver.ACTION_STOP_CASTING); // Showing "play/pause" and "stop casting" in the compat view of the notification. int[] compatButtonActionsIndices = new int[]{1, 3}; // Builds a notification with the above actions. Each tap on the "rewind" and "forward" buttons skips 30 seconds. // Tapping on the notification opens an Activity with class VideoBrowserActivity. NotificationOptions notificationOptions = new NotificationOptions.Builder() .setActions(buttonActions, compatButtonActionsIndices) .setSkipStepMs(30 * DateUtils.SECOND_IN_MILLIS) .setTargetActivityClassName(VideoBrowserActivity.class.getName()) .build();
I controlli multimediali dalle notifiche e dalla schermata di blocco sono attivi per impostazione predefinita e possono essere disattivati chiamando setNotificationOptions
con null in CastMediaOptions.Builder
.
Al momento la funzionalità di schermata di blocco viene attivata purché
la notifica sia attiva.
// ... continue with the NotificationOptions built above val mediaOptions = CastMediaOptions.Builder() .setNotificationOptions(notificationOptions) .build() val castOptions: CastOptions = Builder() .setReceiverApplicationId(context.getString(R.string.app_id)) .setCastMediaOptions(mediaOptions) .build()
// ... continue with the NotificationOptions built above CastMediaOptions mediaOptions = new CastMediaOptions.Builder() .setNotificationOptions(notificationOptions) .build(); CastOptions castOptions = new CastOptions.Builder() .setReceiverApplicationId(context.getString(R.string.app_id)) .setCastMediaOptions(mediaOptions) .build();
Quando l'app del mittente riproduce un live streaming audio o video, l'SDK visualizza automaticamente un pulsante di riproduzione/interruzione al posto del pulsante di riproduzione/pausa sul controllo di notifica, ma non sul controllo della schermata di blocco.
Nota: per visualizzare i controlli della schermata di blocco sui dispositivi pre-Lollipop,
RemoteMediaClient
richiederà automaticamente l'impostazione dell'impostazione audio per tuo conto.
Gestire gli errori
È molto importante che le app dei mittenti gestiscano tutti i callback di errore e decidano la risposta migliore per ogni fase del ciclo di vita di trasmissione. L'app può visualizzare le finestre di dialogo di errore per l'utente o decidere di interrompere la connessione al ricevitore web.