为 Android 应用添加高级功能

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

广告插播时间点

Android 发送者 SDK 支持在给定媒体流内投放广告插播时间点和随播广告。

如需详细了解广告插播时间点的工作原理,请参阅网络接收器广告插播概览

虽然可以在发送器和接收器上指定休息点,但建议在网络接收器Android TV 接收器上指定休息点,以跨平台保持一致的行为。

在 Android 上,使用 AdBreakClipInfoAdBreakInfo 在加载命令中指定广告插播时间点:

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

添加自定义操作

发送者应用可以扩展 MediaIntentReceiver 来处理自定义操作或替换其行为。如果您已实现自己的 MediaIntentReceiver,则需要将其添加到清单中,并在 CastMediaOptions 中设置其名称。此示例提供了一些自定义操作,用于替换开启/关闭远程媒体播放、按下媒体按钮和其他类型的操作。

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

添加自定义渠道

为了让发送者应用与接收者应用通信,您的应用需要创建自定义渠道。发送者可以使用自定义渠道向接收者发送字符串消息。每个自定义渠道均由唯一的命名空间定义,并且必须以前缀 urn:x-cast: 开头,例如 urn:x-cast:com.example.custom。可以有多个自定义渠道,每个自定义渠道都有一个唯一的命名空间。接收器应用还可以使用同一命名空间收发消息

自定义渠道是通过 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);
    }
}

发送者应用连接到接收者应用后,可以使用 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);
}

创建自定义渠道后,发送者可以使用 sendMessage 方法通过该通道向接收者发送字符串消息:

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

支持自动播放

请参阅自动播放和队列 API 部分。

替换用户体验微件的图片选择

框架的各个组件(即“投射”对话框、迷你控制器和 UIMediaController(如果已配置))将显示当前投射媒体的海报图片。图片图片的网址通常包含在媒体的 MediaMetadata 中,但发送者应用可能具有网址的备用来源。

ImagePicker 类定义了一种根据图片(例如,通知缩略图或全屏背景)对图片的使用方式,从 MediaMetadata 的图片列表中选择适当的图片。默认的 ImagePicker 实现会始终选择第一张图片,如果 MediaMetadata 中没有图片,则返回 null。您的应用可以创建 ImagePicker 的子类并替换 onPickImage(MediaMetadata, ImageHints) 方法,以提供替代实现,然后使用 CastMediaOptions.BuildersetImagePicker 方法选择该子类。ImageHintsImagePicker 提供关于选择要在界面中显示的图片类型和大小的提示。

自定义 Cast 对话框

SessionManager 是管理会话生命周期的中心位置。SessionManager 会监听 Android MediaRouter 路由选择状态更改以启动、恢复和结束会话。选择路由后,SessionManager 将创建一个 Session 对象,并尝试启动或恢复该路由。如果未选择路由,SessionManager 将结束当前会话。

因此,为确保 SessionManager 正确管理会话生命周期,您必须确保:

根据您创建 Cast 对话框的方式,可能需要执行其他操作:

后续步骤

您可以添加到 Android 发送者应用的功能到这里就结束了。您现在可以针对其他平台(iOSWeb)构建发送者应用,或者构建 Web 接收器应用