以下程序可讓您以 CastContext 單例模式，將 Android 傳送端應用程式從 Cast SDK v2 轉換為 CAF 傳送者。
Cast CAF Sender SDK 會使用 CastContext 代您管理 GoogleAPIClient。CastContext 會為您管理生命週期、錯誤和回呼，大幅簡化 Cast 應用程式的開發流程。
簡介
- CAF 傳送者仍使用 Android SDK Manager 做為 Google Play 服務的一部分進行發布
- 新增套件，必須負責遵守 Google Cast 設計檢查清單 (
com.google.android.gms.cast.framework.*) - CAF 傳送者提供的小工具符合 Cast 使用者體驗規定；v2 並未提供任何 UI 元件，因此您必須實作這些小工具。
- 使用 Cast API 時不再需要使用 GoogleApiClient。
- CAF 傳送者中的隱藏式輔助字幕與 v2 類似。
依附元件
V2 和 CAF 在支援程式庫和 Google Play 服務 (9.2.0 以上版本) 上的依附元件，如支援程式庫功能指南所述
CAF 支援的最低 Android SDK 版本為 9 (Gingerbread)。
初始化
在 CAF 中，投放架構需要明確的初始化步驟。這包括使用適當的 OptionsProvider 指定 Web Receiver 應用程式 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);
}
第 2 版不需要執行這些步驟。
探索裝置
在 CAF 中，當應用程式進入前景並分別進入背景時，架構會自動啟動和停止探索程序。不應使用 MediaRouteSelector 和 MediaRouter.Callback。
投放按鈕和投放對話方塊
與第 2 版一樣，這些元件是由 MediaRouter 支援資料庫提供。
投放按鈕仍會由 MediaRouteButton 實作，且可使用 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 架構，以覆寫每個活動的 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 Receiver 應用程式。傳送者與網路接收器之間的互動現在會以「工作階段」表示。SessionManager 類別會處理工作階段生命週期，並根據使用者手勢自動啟動及停止工作階段：當使用者在投放對話方塊中選取投放裝置時，就會啟動工作階段，並在使用者輕觸投放對話方塊中的「停止投放」按鈕或傳送端應用程式終止時結束。使用 SessionManager 註冊 SessionManagerListener，即可讓傳送方應用程式收到工作階段生命週期事件的通知。SessionManagerListener 回呼會定義所有工作階段生命週期事件的回呼方法。
CastSession 類別代表投放裝置的工作階段。該類別備有可控制裝置音量和靜音狀態的方法，這些方法先前是在 v2 中使用 Cast.CastApi 上的方法完成。
在第 2 版中，Cast.Listener 回呼會提供裝置狀態變更的通知，包括音量、靜音狀態、待機狀態等。
在 CAF 中，仍可透過 Cast.Listener 中的回呼方法傳送音量/靜音狀態變更通知；這些事件監聽器是透過 CastSession 註冊。所有其他裝置狀態通知都會透過 CastStateListener 回呼傳送；這些事件監聽器會註冊 CastSession。當相關片段、活動或應用程式進入背景時，請確保您取消註冊事件監聽器。
重新連線邏輯
與 v2 相同，CAF 會嘗試重新建立因 Wi-Fi 訊號暫時中斷或其他網路錯誤而中斷的網路連線。這項作業現已在工作階段層級完成；工作階段可在連線中斷時進入「已暫停」狀態，並在恢復連線時切換回「已連線」狀態。在這個過程中，架構會負責重新連線至 Web Receiver 應用程式，並重新連結任何投放頻道。
此外，CAF 也會新增自動繼續工作階段的功能，此功能預設為啟用，而且可以透過 CastOptions 停用。如果傳送端應用程式傳送到背景，或在投放工作階段期間終止 (滑過或因當機而終止)，架構會在傳送者應用程式返回前景或重新啟動時嘗試繼續執行該工作階段；這由 SessionManager 自動處理，會在任何已註冊的 SessionManagerListener 執行個體中發出適當的回呼。
註冊自訂管道
在第 2 版中，系統會使用 Cast.CastApi 註冊自訂管道 (使用 Cast.MessageReceivedCallback 實作)。在 CAF 中，改為使用 CastSession 執行個體註冊自訂管道。您可以在 SessionManagerListener.onSessionStarted 回呼方法中完成註冊。針對媒體應用程式，不再需要透過 Cast.CastApi.setMessageReceivedCallbacks 明確註冊媒體控制管道；詳情請參閱下一節。
媒體管理
v2 類別 RemoteMediaPlayer 已淘汰，不建議使用。在 CAF 中，該類別則由新的 RemoteMediaClient 類別取代，該類別可在更便利的 API 中提供對等的功能。不需要明確初始化或註冊此物件；如果連線的 Web Receiver 應用程式支援媒體命名空間，架構會自動在工作階段啟動時將物件例項化，並註冊基礎媒體管道。
RemoteMediaClient 可做為 CastSession 物件的 getRemoteMediaClient 方法存取。
在第 2 版中，RemoteMediaPlayer 發出的所有媒體要求都會透過 PendingResult 回呼傳回 RemoteMediaPlayer.MediaChannelResult。
在 CAF 中，在 RemoteMediaClient 發出的所有媒體要求都會透過 PendingResult 回呼傳回 RemoteMediaClient.MediaChannelResult，可用於追蹤要求的進度和最終結果。
第 2 版 RemoteMediaPlayer 會透過 RemoteMediaPlayer.OnStatusUpdatedListener，在網路接收器的狀態變更時傳送通知。
在 CAF 中，RemoteMediaClient 會透過其 RemoteMediaClient.Listener 介面提供對等的回呼。任何數量的事件監聽器都可以使用 RemoteMediaClient 註冊，讓多個傳送者元件共用與工作階段相關聯的單一 RemoteMediaClient 執行個體。
在第 2 版中，傳送方應用程式必須承受讓使用者介面與網路接收器的狀態保持同步的負擔。
在 CAF 中，UIMediaController 類別會負責處理大部分的這項責任。
簡介重疊元素
V2 不提供簡介重疊使用者介面。
CAF 提供自訂檢視 IntroductoryOverlay，可在首次向使用者顯示時醒目顯示「投放」按鈕。
迷你控制器
在第 2 版中，您必須在傳送端應用程式中從頭開始實作迷你控制器。
在 CAF 中，SDK 提供自訂檢視 MiniControllerFragment，您可以將其新增至要顯示迷你控制器的活動應用程式版面配置檔案。
通知和螢幕鎖定畫面
在第 2 版中，通知和螢幕鎖定畫面的控制器不會由 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();
}
展開的控制器
在第 2 版中，您必須在傳送端應用程式中從頭開始實作展開的控制器。
CAF 提供 UIMediaController 輔助類別，可讓您輕鬆建構自己的擴充控制器。
CAF 會新增預先建構的展開控制器小工具 ExpandedControllerActivity，您可以直接將其新增至應用程式，您不必再使用 UIMediaController 實作自訂展開控制器。
音訊焦點
在 v2 中，您必須使用 MediaSessionCompat 管理音訊焦點。
在 CAF 中，系統會自動管理音訊焦點，
偵錯記錄功能
CAF 中沒有記錄選項。
範例應用程式
我們提供使用 CAF 的程式碼研究室教學課程和範例應用程式。