通过以下步骤，您可以将 Android 发送器应用从 Cast SDK v2 转换为 CAF 发送器，后者基于 CastContext 单例。
Cast CAF Sender SDK 使用 CastContext 代表您管理 GoogleAPIClient。CastContext 会为您管理生命周期、错误和回调，从而大大简化了 Cast 应用的开发。
简介
- CAF Sender 仍会使用 Android SDK 管理器作为 Google Play 服务的一部分进行分发
- 添加了新的软件包，负责确保符合 Google Cast 设计核对清单 (
com.google.android.gms.cast.framework.*) - CAF Sender 提供符合 Cast 用户体验要求的微件；v2 未提供任何界面组件，并且要求您实现这些微件。
- 使用 Cast API 不再需要使用 GoogleApiClient。
- CAF Sender 中的字幕与 v2 类似。
依赖项
V2 和 CAF 对支持库和 Google Play 服务（9.2.0 或更高版本）的依赖项相同，如支持库功能指南中所述
CAF 支持的最低 Android SDK 版本为 9 (Gingerbread)。
初始化
在 CAF 中，Cast 框架需要执行显式初始化步骤。这涉及使用适当的 OptionsProvider 指定 Web 接收器应用 ID 和任何其他全局选项，从而初始化 CastContext 单例。
public class CastOptionsProvider implements OptionsProvider {
@Override
public CastOptions getCastOptions(Context context) {
return new CastOptions.Builder()
.setReceiverApplicationId(context.getString(R.string.app_id))
.build();
}
@Override
public List<SessionProvider> getAdditionalSessionProviders(Context context) {
return null;
}
}
在应用 AndroidManifest.xml 文件的“application”标记内声明 OptionsProvider：
<application>
...
<meta-data
android:name=
"com.google.android.gms.cast.framework.OPTIONS_PROVIDER_CLASS_NAME"
android:value="com.google.sample.cast.refplayer.CastOptionsProvider" />
</application>
在每个 activity 的 onCreate 方法中延迟初始化 CastContext：
private CastContext mCastContext;
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.video_browser);
setupActionBar();
mCastContext = CastContext.getSharedInstance(this);
}
在 v2 中，这些步骤不是必需的。
设备发现
在 CAF 中，当应用进入前台和进入后台时，框架会分别自动启动和停止发现过程。不应使用 MediaRouteSelector 和 MediaRouter.Callback。
“投放”按钮和“投放”对话框
与 v2 中的组件一样，这些组件由 MediaRouter 支持库提供。
“投屏”按钮仍由 MediaRouteButton 实现，可以添加到 activity 中（使用 ActionBar 或 Toolbar），作为菜单中的菜单项。
<item
android:id="@+id/media_route_menu_item"
android:title="@string/media_route_menu_title"
app:actionProviderClass="android.support.v7.app.MediaRouteActionProvider"
app:showAsAction="always"/>
使用 CastButtonFactory 将 MediaRouteButton 连接到 Cast 框架，以替换每个 activity 的 onCreateOptionMenu() 方法：
private MenuItem mediaRouteMenuItem;
public boolean onCreateOptionsMenu(Menu menu) {
super.onCreateOptionsMenu(menu);
getMenuInflater().inflate(R.menu.browse, menu);
mediaRouteMenuItem =
CastButtonFactory.setUpMediaRouteButton(getApplicationContext(),
menu,
R.id.media_route_menu_item);
return true;
}
当用户点按该按钮时，系统会自动显示“投屏”对话框。
设备控制
在 CAF 中，设备控制主要由框架处理。发送器应用无需处理（也不应尝试处理）使用 GoogleApiClient 连接到设备并启动 Web 接收器应用。发送器和 Web 接收器之间的互动现在表示为“会话”。SessionManager 类会处理会话生命周期，并根据用户手势自动启动和停止会话：当用户在 Cast 对话框中选择 Cast 设备时，会话会启动；当用户点按 Cast 对话框中的“停止投放”按钮或发送方应用本身终止时，会话会结束。发送方应用可以通过向 SessionManager 注册 SessionManagerListener 来接收会话生命周期事件的通知。SessionManagerListener 回调用于定义所有会话生命周期事件的回调方法。
CastSession 类表示与 Cast 设备的会话。该类包含用于控制设备音量和静音状态的方法，之前在 v2 中，这些操作是使用 Cast.CastApi 的方法完成的。
在 v2 中，Cast.Listener 回调会提供有关设备状态更改的通知，包括音量、静音状态、待机状态等。
在 CAF 中，音量/静音状态更改通知仍通过 Cast.Listener 中的回调方法传递；这些监听器已注册到 CastSession。所有其余的设备状态通知均通过 CastStateListener 回调传递；这些监听器已向 CastSession 注册。请确保在关联的 fragment、activity 或应用进入后台时，仍取消注册监听器。
重新连接逻辑
与 v2 一样，CAF 会尝试重新建立因临时 Wi-Fi 信号丢失或其他网络错误而断开的网络连接。现在，这项操作是在会话级别完成的；当连接断开时，会话可能会进入“暂停”状态，并会在连接恢复后切换回“已连接”状态。在此过程中，该框架会负责重新连接到 Web 接收器应用并重新连接所有 Cast 渠道。
此外，CAF 还添加了自动会话恢复功能，该功能默认处于启用状态（可通过 CastOptions 停用）。如果发送方应用在 Cast 会话进行期间被发送到后台或被终止（通过滑动关闭或因崩溃而终止），框架会在发送方应用返回前台或重新启动时尝试恢复该会话；这由 SessionManager 自动处理，该函数会对所有已注册的 SessionManagerListener 实例发出适当的回调。
自定义渠道注册
在 v2 中，自定义渠道（使用 Cast.MessageReceivedCallback 实现）会向 Cast.CastApi 注册。在 CAF 中，自定义渠道会改为注册到 CastSession 实例。可以在 SessionManagerListener.onSessionStarted 回调方法中进行注册。对于媒体应用，不再需要通过 Cast.CastApi.setMessageReceivedCallbacks 显式注册媒体控制通道；如需了解详情，请参阅以下部分。
媒体控件
v2 类 RemoteMediaPlayer 已废弃，不应再使用。在 CAF 中，它已被新的 RemoteMediaClient 类取代，后者通过更便捷的 API 提供等效的功能。无需显式初始化或注册此对象；如果要连接到的 Web 接收器应用支持媒体命名空间，框架会在会话开始时自动实例化该对象并注册底层媒体通道。
RemoteMediaClient 可以作为 CastSession 对象的 getRemoteMediaClient 方法进行访问。
在 v2 中，针对 RemoteMediaPlayer 发出的所有媒体请求都会通过 PendingResult 回调返回 RemoteMediaPlayer.MediaChannelResult。
在 CAF 中，针对 RemoteMediaClient 发出的所有媒体请求都会通过 PendingResult 回调返回 RemoteMediaClient.MediaChannelResult，该回调可用于跟踪请求的进度和最终结果。
v2 RemoteMediaPlayer 会通过 RemoteMediaPlayer.OnStatusUpdatedListener 发送有关 Web 接收器上媒体播放器状态变化的通知。
在 CAF 中，RemoteMediaClient 通过其 RemoteMediaClient.Listener 接口提供等效的回调。您可以向 RemoteMediaClient 注册任意数量的监听器，这样多个发送方组件就可以共享与会话关联的单个 RemoteMediaClient 实例。
在 v2 中，发送器应用必须承担使界面与 Web 接收器上的媒体播放器状态保持同步的重担。
在 CAF 中，类 UIMediaController 承担了大部分责任。
介绍性叠加层
V2 不提供介绍性叠加层界面。
CAF 提供了一个自定义视图 IntroductoryOverlay，可用于在首次向用户显示“投屏”按钮时突出显示此按钮。
迷你控制器
在 v2 中，您需要在发送器应用中从头开始实现迷你控制器。
在 CAF 中，SDK 提供了一个自定义视图 MiniControllerFragment，可添加到您想要在其中显示迷你控制器的 activity 的应用布局文件。
通知和锁定屏幕
在 v2 中，SDK 不提供通知和锁定屏幕的控制器。对于该 SDK，您需要使用 Android 框架 API 将这些功能构建到发件人应用中。
在 CAF 中，SDK 提供了一个 NotificationsOptions.Builder 来帮助您在发送设备应用中构建通知和锁定屏幕的媒体控件。在初始化 CastContext 时，可以使用 CastOptions 启用通知和锁定屏幕控件。
public CastOptions getCastOptions(Context context) {
NotificationOptions notificationOptions = new NotificationOptions.Builder()
.setTargetActivityClassName(VideoBrowserActivity.class.getName())
.build();
CastMediaOptions mediaOptions = new CastMediaOptions.Builder()
.setNotificationOptions(notificationOptions)
.build();
return new CastOptions.Builder()
.setReceiverApplicationId(context.getString(R.string.app_id))
.setCastMediaOptions(mediaOptions)
.build();
}
展开的控制器
在 v2 中，您需要在发送器应用中从头开始实现展开式控制器。
CAF 提供了 UIMediaController 辅助类，可让您轻松构建自己的展开式控制器。
CAF 添加了一个预构建的展开式控制器 widget ExpandedControllerActivity，您可以将其直接添加到应用中。您无需再使用 UIMediaController 实现自定义展开式控制器。
音频焦点
在 v2 中，您需要使用 MediaSessionCompat 来管理音频焦点。
在 CAF 中，系统会自动管理音频焦点。
调试日志记录
CAF 中没有日志记录选项。
示例应用
我们提供了使用 CAF 的 Codelab 教程和示例应用。