Agrega funciones avanzadas a tu app para Android

Pausas publicitarias

El SDK de Android Sender admite las pausas publicitarias y los anuncios complementarios dentro de un flujo de contenido multimedia determinado.

Consulta la descripción general de las pausas publicitarias del receptor web para obtener más información sobre cómo funcionan.

Si bien las pausas se pueden especificar en el remitente y el receptor, se recomienda que se especifiquen en el receptor web y el receptor de Android TV para mantener un comportamiento coherente en todas las plataformas.

En Android, especifica las pausas publicitarias en un comando de carga con AdBreakClipInfo y 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);

Agrega acciones personalizadas

Una app del remitente puede extender MediaIntentReceiver para controlar acciones personalizadas o anular su comportamiento. Si implementaste tu MediaIntentReceiver, debes agregarlo al manifiesto y también establecer su nombre en CastMediaOptions. En este ejemplo, se proporcionan acciones personalizadas que anula la activación y desactivación de la reproducción de contenido multimedia remoto, presiona el botón multimedia y otros tipos de acciones.

// 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) {
    }
}

Cómo agregar un canal personalizado

Para que la app del remitente se comunique con la app del destinatario, esta debe crear un canal personalizado. El remitente puede usar el canal personalizado para enviar mensajes de cadena al destinatario. Cada canal personalizado se define con un espacio de nombres único y debe comenzar con el prefijo urn:x-cast:, por ejemplo, urn:x-cast:com.example.custom. Es posible tener varios canales personalizados, cada uno con un espacio de nombres único. La app del receptor también puede enviar y recibir mensajes con el mismo espacio de nombres.

El canal personalizado se implementa con la interfaz Cast.MessageReceivedCallback:

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

Nota: Este procedimiento no usa el método setSupportedNamespaces().

Una vez que la app del remitente se conecte a la app del receptor, se puede crear el canal personalizado con el método 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 vez que se crea el canal personalizado, el remitente puede usar el método sendMessage para enviar mensajes de cadena al receptor a través de ese canal:

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

Compatibilidad con la reproducción automática

Consulta la sección APIs de reproducción automática y creación de filas.

Anula la selección de imágenes para los widgets de UX

Varios componentes del framework (es decir, el diálogo de Cast, el controlador en miniatura y el UIMediaController, si está configurado de esa manera) mostrarán el material gráfico del contenido multimedia que se está transmitiendo. Por lo general, las URLs de los materiales gráficos de las imágenes se incluyen en el MediaMetadata del contenido multimedia, pero es posible que la app del remitente tenga una fuente alternativa para las URLs.

La clase ImagePicker define un medio para seleccionar una imagen adecuada de la lista de imágenes en un MediaMetadata, según el uso de la imagen, por ejemplo, la miniatura de la notificación o el fondo de pantalla completa. La implementación predeterminada de ImagePicker siempre elige la primera imagen o muestra un valor nulo si no hay ninguna imagen disponible en MediaMetadata. Tu app puede crear una subclase de ImagePicker y anular el método onPickImage(MediaMetadata, ImageHints) para proporcionar una implementación alternativa y, luego, seleccionar esa subclase con el método setImagePicker de CastMediaOptions.Builder. ImageHints proporciona sugerencias a un ImagePicker sobre el tipo y el tamaño de una imagen que se seleccionará para mostrarse en la IU.

Personaliza los diálogos de Cast

Administra el ciclo de vida de la sesión

SessionManager es el lugar central para administrar el ciclo de vida de la sesión. SessionManager escucha los cambios de estado de selección de ruta de Android MediaRouter para iniciar, reanudar y finalizar sesiones. Cuando se seleccione una ruta, SessionManager creará un objeto Session y tratará de iniciarlo o reanudarlo. Cuando se anula la selección de una ruta, SessionManager finalizará la sesión actual.

Por lo tanto, para garantizar que SessionManager administre los ciclos de vida de las sesiones correctamente, debes asegurarte de lo siguiente:

• En el diálogo del selector de ruta, llama a MediaRouter.selectRoute(MediaRouter.RouteInfo) cuando un usuario seleccione un dispositivo.
• En el diálogo del controlador de ruta (en el estado conectado o en el estado de transmisión), llama a MediaRouter.unselect(int) cuando el usuario deje de transmitir.

Según cómo crees los diálogos de Cast, es posible que debas realizar acciones adicionales:

• Si creas diálogos de Cast con MediaRouteChooserDialog y MediaRouteControllerDialog, estos diálogos actualizarán automáticamente la selección de ruta en MediaRouter, por lo que no es necesario hacer nada.
• Si configuras el botón de Cast con CastButtonFactory.setUpMediaRouteButton(Context, Menu, int) o CastButtonFactory.setUpMediaRouteButton(Context, MediaRouteButton), los diálogos se crean con MediaRouteChooserDialog y MediaRouteControllerDialog, por lo que tampoco es necesario hacer nada.
• En otros casos, crearás diálogos de Cast personalizados, por lo que debes seguir las instrucciones anteriores para actualizar el estado de selección de ruta en MediaRouter.

Estado de dispositivos cero

Si creas diálogos de Cast personalizados, tu MediaRouteChooserDialog personalizado debería controlar correctamente el caso de que no se encuentre ningún dispositivo. El diálogo debe tener indicadores que les aclaren a los usuarios cuándo la app aún intenta encontrar dispositivos y cuándo el intento de descubrimiento ya no está activo.

Si usas el MediaRouteChooserDialog predeterminado, ya se controla el estado de cero dispositivos.

Próximos pasos

Con esto, se concluyen las funciones que puedes agregar a tu app de remitente para Android. Ahora puedes compilar una app de remitente para otra plataforma (iOS o Web) o compilar una app de receptor web.