此页面由 Cloud Translation API 翻译。

为您的 Android 应用添加高级功能

广告插播时间点

Android 发送者 SDK 支持指定媒体流中的广告插播时间点和随播广告。

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

虽然可以在发送器和接收器上指定广告插播时间点，但建议您在网络接收器和 Android TV 接收器上指定这些断点，以在不同平台之间保持一致的行为。

在 Android 上，使用 AdBreakClipInfo 和 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);

添加自定义操作

发送者应用可以扩展 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 部分。

替换用户体验 widget 的图片选择

该框架的各个组件（即投放对话框、迷你控制器和 UIMediaController（如果已配置））都将显示当前投放媒体的图片。图片艺术作品的网址通常包含在媒体的 MediaMetadata 中，但发送者应用的网址可能是备用来源。

ImagePicker 类定义了一种根据图片使用行为（例如，通知缩略图或全屏背景）从 MediaMetadata 的图片列表中选择相应图片的方法。默认的 ImagePicker 实现始终选择第一张图片，如果 MediaMetadata 中没有图片，则返回 null。您的应用可以子类化 ImagePicker 并替换 onPickImage(MediaMetadata, ImageHints) 方法以提供替代实现，然后使用 CastMediaOptions.Builder 的 setImagePicker 方法选择该子类。ImageHints 会向 ImagePicker 提供关于选择要在界面中显示的图片类型和尺寸的提示。

自定义 Cast 对话框

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

因此，为了确保 SessionManager 正确管理会话生命周期，您必须确保：

在路由选择器对话框中，当用户选择设备时调用 MediaRouter.selectRoute(MediaRouter.RouteInfo)。
在路由控制器对话框中（处于已连接状态或投射状态），当用户停止投射时，调用 MediaRouter.unselect(int)。

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

如果您使用 MediaRouteChooserDialog 和 MediaRouteControllerDialog 创建 Cast 对话框，这些对话框会自动更新 MediaRouter 中的路由选择，因此您无需执行任何操作。
如果您使用 CastButtonFactory.setUpMediaRouteButton(Context, Menu, int) 或 CastButtonFactory.setUpMediaRouteButton(Context, MediaRouteButton) 设置“投射”按钮，则对话框实际上是使用 MediaRouteChooserDialog 和 MediaRouteControllerDialog 创建的，因此也无需执行任何操作。
对于其他情况，您需要创建自定义 Cast 对话框，因此您需要按照上述说明在 MediaRouter 中更新路由选择状态。

后续步骤

至此，您可以向“Android 发送器”应用添加的功能到这里就结束了。现在，您可以为其他平台（iOS 或 Web）构建发送器应用，或者构建 Web Receiver 应用。

输出切换器

ExoPlayer 集成