Questa pagina è stata tradotta dall'API Cloud Translation.

Aggiungi funzionalità avanzate alla tua app Android

Interruzioni pubblicitarie

L'SDK Android Sender fornisce supporto per interruzioni pubblicitarie e annunci companion all'interno di un un determinato stream multimediale.

Consulta le Panoramica delle interruzioni pubblicitarie di Web receiver per saperne di più informazioni sul funzionamento delle interruzioni pubblicitarie.

Anche se le interruzioni possono essere specificate sia sul mittente sia sul destinatario, è consigliabile che specificato sul WebRicevitore e Ricevitore Android TV per garantire coerenza il comportamento degli utenti sulle varie piattaforme.

Su Android, specifica le interruzioni pubblicitarie in un comando di caricamento utilizzando AdBreakClipInfo e AdBreakInfo:

Kotlin

val breakClip1: AdBreakClipInfo =
    AdBreakClipInfo.Builder("bc0")
        .setTitle("Clip title")
        .setPosterUrl("https://www.some.url")
        .setDuration(60000)
        .setWhenSkippableInMs(5000)  // Set this field so that the ad is skippable
        .build()

val breakClip2: AdBreakClipInfo = …
val breakClip3: AdBreakClipInfo = …

val break1: AdBreakClipInfo =
    AdBreakInfo.Builder(/* playbackPositionInMs= */ 10000)
        .setId("b0")
        .setBreakClipIds({"bc0","bc1","bc2"})
        …
        .build()

val mediaInfo: MediaInfo = MediaInfo.Builder()
    …
    .setAdBreaks({break1})
    .setAdBreakClips({breakClip1, breakClip2, breakClip3})
    .build()

val mediaLoadRequestData: MediaLoadRequestData = MediaInfo.Builder()
    …
    .setMediaInfo(mediaInfo)
    .build()

remoteMediaClient.load(mediaLoadRequestData)

Java

AdBreakClipInfo breakClip1 =
    new AdBreakClipInfo.Builder("bc0")
        .setTitle("Clip title")
        .setPosterUrl("https://www.some.url")
        .setDuration(60000)
        .setWhenSkippableInMs(5000)  // Set this field so that the ad is skippable
        .build();

AdBreakClipInfo breakClip2 = …
AdBreakClipInfo breakClip3 = …

AdBreakInfo break1 =
    new AdBreakInfo.Builder(/* playbackPositionInMs= */ 10000)
        .setId("b0")
        .setBreakClipIds({"bc0","bc1","bc2"})
        …
        .build();

MediaInfo mediaInfo = new MediaInfo.Builder()
    …
    .setAdBreaks({break1})
    .setAdBreakClips({breakClip1, breakClip2, breakClip3})
    .build();

MediaLoadRequestData mediaLoadRequestData = new MediaInfo.Builder()
    …
    .setMediaInfo(mediaInfo)
    .build();

remoteMediaClient.load(mediaLoadRequestData);

Aggiungere azioni personalizzate

Un'app mittente può estendere MediaIntentReceiver per gestire azioni personalizzate o eseguirne l'override. Se hai implementato proprio MediaIntentReceiver, devi aggiungerlo al file manifest e impostare anche nome in CastMediaOptions. Questo esempio fornisce azioni personalizzate che superano l'attivazione/la disattivazione della riproduzione multimediale da remoto, la pressione del pulsante multimediale e altri tipi di azioni.

// In AndroidManifest.xml
<receiver android:name="com.example.MyMediaIntentReceiver" />

Kotlin

// In your OptionsProvider
var mediaOptions = CastMediaOptions.Builder()
    .setMediaIntentReceiverClassName(MyMediaIntentReceiver::class.java.name)
    .build()

// Implementation of MyMediaIntentReceiver
internal class MyMediaIntentReceiver : MediaIntentReceiver() {
    override fun onReceiveActionTogglePlayback(currentSession: Session) {
    }

    override fun onReceiveActionMediaButton(currentSession: Session, intent: Intent) {
    }

    override fun onReceiveOtherAction(context: Context?, action: String, intent: Intent) {
    }
}

Java

// In your OptionsProvider
CastMediaOptions mediaOptions = new CastMediaOptions.Builder()
        .setMediaIntentReceiverClassName(MyMediaIntentReceiver.class.getName())
        .build();

// Implementation of MyMediaIntentReceiver
class MyMediaIntentReceiver extends MediaIntentReceiver {
    @Override
    protected void onReceiveActionTogglePlayback(Session currentSession) {
    }

    @Override
    protected void onReceiveActionMediaButton(Session currentSession, Intent intent) {
    }

    @Override
    protected void onReceiveOtherAction(Context context, String action, Intent intent) {
    }
}

Aggiungi un canale personalizzato

Affinché l'app del mittente possa comunicare con l'app del destinatario, l'app deve per creare un canale personalizzato. Il mittente può utilizzare il canale personalizzato per inviare messaggi di stringa al destinatario. Ogni canale personalizzato è definito da un spazio dei nomi e deve iniziare con il prefisso urn:x-cast:, ad esempio urn:x-cast:com.example.custom. È possibile avere più query ciascuno con uno spazio dei nomi univoco. L'app ricevente può anche inviare e ricevere messaggi utilizzando lo stesso spazio dei nomi.

Il canale personalizzato è implementato con Cast.MessageReceivedCallback dell'interfaccia:

Kotlin

class HelloWorldChannel : MessageReceivedCallback {
    val namespace: String
        get() = "urn:x-cast:com.example.custom"

    override fun onMessageReceived(castDevice: CastDevice, namespace: String, message: String) {
        Log.d(TAG, "onMessageReceived: $message")
    }
}

Java

class HelloWorldChannel implements Cast.MessageReceivedCallback {
    public String getNamespace() {
        return "urn:x-cast:com.example.custom";
    }
    @Override
    public void onMessageReceived(CastDevice castDevice, String namespace, String message) {
        Log.d(TAG, "onMessageReceived: " + message);
    }
}

Una volta che l'app del mittente è collegata all'app del destinatario, il canale personalizzato può da creare utilizzando setMessageReceivedCallbacks :

Kotlin

try {
    mCastSession.setMessageReceivedCallbacks(
        mHelloWorldChannel.namespace,
        mHelloWorldChannel)
} catch (e: IOException) {
    Log.e(TAG, "Exception while creating channel", e)
}

Java

try {
    mCastSession.setMessageReceivedCallbacks(
            mHelloWorldChannel.getNamespace(),
            mHelloWorldChannel);
} catch (IOException e) {
    Log.e(TAG, "Exception while creating channel", e);
}

Una volta creato il canale personalizzato, il mittente può utilizzare sendMessage per inviare messaggi stringa al destinatario su quel canale:

Kotlin

private fun sendMessage(message: String) {
    if (mHelloWorldChannel != null) {
        try {
            mCastSession.sendMessage(mHelloWorldChannel.namespace, message)
                .setResultCallback { status ->
                    if (!status.isSuccess) {
                        Log.e(TAG, "Sending message failed")
                    }
                }
        } catch (e: Exception) {
            Log.e(TAG, "Exception while sending message", e)
        }
    }
}

Java

private void sendMessage(String message) {
    if (mHelloWorldChannel != null) {
        try {
            mCastSession.sendMessage(mHelloWorldChannel.getNamespace(), message)
                .setResultCallback( status -> {
                    if (!status.isSuccess()) {
                        Log.e(TAG, "Sending message failed");
                    }
                });
        } catch (Exception e) {
            Log.e(TAG, "Exception while sending message", e);
        }
    }
}

Supporto della riproduzione automatica

Consulta la sezione API di riproduzione automatica e coda.

Sostituisci la selezione delle immagini per i widget UX

I vari componenti del framework (ovvero la finestra di dialogo Trasmetti, il e UIMediaController, se configurato) mostreranno per i contenuti multimediali attualmente trasmessi. Gli URL dell'artwork delle immagini sono in genere inclusi nel MediaMetadata per i contenuti multimediali, ma l'app mittente potrebbe avere un'origine alternativa per gli URL.

La ImagePicker definisce un mezzo per selezionare un'immagine appropriata dall'elenco di immagini in un MediaMetadata, in base all'uso dell'immagine, ad esempio, notifica una miniatura o uno sfondo a schermo intero. L'implementazione predefinita di ImagePicker sceglie sempre la prima immagine, oppure restituisce null se non è disponibile nessuna immagine MediaMetadata. La tua app può eseguire la sottoclasse ImagePicker e sostituire il onPickImage(MediaMetadata, ImageHints) per fornire un'implementazione alternativa, quindi seleziona quella sottoclasse con setImagePicker di CastMediaOptions.Builder. ImageHints fornisce suggerimenti a ImagePicker sul tipo e sulle dimensioni di un'immagine selezionate per la visualizzazione nell'interfaccia utente.

Personalizzazione delle finestre di dialogo di trasmissione

Gestione del ciclo di vita delle sessioni

SessionManager è il punto centrale per la gestione del ciclo di vita delle sessioni. SessionManager ascolti ad Android MediaRouter lo stato di selezione del percorso viene modificato per iniziare, riprendere e terminare le sessioni. Quando un percorso viene selezionata, SessionManager creerà un Session e tenta di avviarlo o riprenderlo. Quando un percorso non è selezionato, SessionManager terminerà la sessione corrente.

Pertanto, per assicurarti che SessionManager gestisca correttamente i cicli di vita delle sessioni, devi assicurarti che:

Nella finestra di dialogo del selettore del percorso, chiamata MediaRouter.selectRoute(MediaRouter.RouteInfo): quando un utente seleziona un dispositivo.
Nella finestra di dialogo del controller di route (nella sezione o trasmissione state), chiamata MediaRouter.unselect(int) Quando l'utente interrompe la trasmissione.

A seconda di come crei le finestre di dialogo Trasmetti, potrebbero essere necessarie ulteriori azioni Fine:

Se crei finestre di dialogo Trasmetti utilizzando MediaRouteChooserDialog e MediaRouteControllerDialog, queste finestre di dialogo aggiorneranno automaticamente la selezione del percorso in MediaRouter, quindi non occorre fare nulla.
Se hai configurato il pulsante Trasmetti utilizzando CastButtonFactory.setUpMediaRouteButton(Context, Menu, int) o CastButtonFactory.setUpMediaRouteButton(Context, MediaRouteButton), le finestre di dialogo vengono effettivamente create utilizzando MediaRouteChooserDialog e MediaRouteControllerDialog, quindi non devi fare altro.
In altri casi, dovrai creare finestre di dialogo di trasmissione personalizzate, quindi dovrai segui le istruzioni riportate sopra per aggiornare lo stato di selezione del percorso in MediaRouter.

Stato zero dispositivi

Se crei finestre di dialogo di trasmissione personalizzate, i tuoi MediaRouteChooserDialog deve gestire correttamente la presenza di zero dispositivi trovato. La finestra di dialogo dovrebbe contenere indicatori che indicano chiaramente agli utenti quando L'app sta ancora cercando di trovare dispositivi e quando il tentativo di rilevamento non ha esito positivo più attivo.

Se utilizzi il MediaRouteChooserDialog predefinito, lo stato di zero dispositivi è già gestito.

Passaggi successivi

Ecco le funzionalità che puoi aggiungere all'app di invio per Android. Ora puoi creare un'app di invio per un'altra piattaforma (iOS o web) o creare un'app di ricezione web.

Indietro

Selettore di uscita

Avanti

Integrazione con ExoPlayer