このページは Cloud Translation API によって翻訳されました。

iOS Sender アプリを Cast SDK v2 から Cast Application Framework（CAF）に移行する

次の手順で、iOS センダーアプリを Cast SDK から変換できます v2 を CAF 送信者にマッピングします。 GCKCastContext あります。

はじめに

CAF 送信者は引き続き Google Cast デベロッパー向けウェブサイト CocoaPods（v2 など）。
これらのポリシーの遵守について責任を負う新しいクラスが追加されました。 Google Cast の設計チェックリストをご覧ください。
CAF Sender は Cast UX 要件を満たすウィジェットを提供します。v2 UI コンポーネントは提供されておらず、入手できます
CAF Sender の設計は、Cast Android SDK の設計と一致しています。
CAF 送信者はビットコード（v2 など）をサポートしています。
CAF の字幕は v2 と同様です。

依存関係

CAF 送信者は iOS バージョン 8 以降をサポートしています。

初期化

CAF では、キャストフレームワークに明示的な初期化ステップが必要です。この初期化が含まれます。 GCKCastContext 使用して適切なレイヤを GCKCastOptions Web Receiver アプリケーション ID とその他のグローバル。これは通常、AppDelegate で行います。 -[application:didFinishLaunchingWithOptions:] メソッド:

GCKCastOptions *options = [[GCKCastOptions alloc]
    initWithReceiverApplicationID:applicationID];
[GCKCastContext setSharedInstanceWithOptions:options];

この手順は v2 では必要ありませんでした。

デバイス検出

CAF では、検出プロセスの開始と停止は、アプリがフォアグラウンドに移って、バックグラウンドに移動したときに、できます。v2 の GCKDeviceScanner クラスと GCKFilterCriteria クラスは次のとおりです。非推奨です。使用しないでください。

キャストアイコンとキャストダイアログ

CAF では、キャストアイコンとダイアログはフレームワークによって提供されます。キャストボタンは、次のようにインスタンス化してナビゲーションバーに追加できます。

GCKUICastButton *castButton =
    [[GCKUICastButton alloc] initWithFrame:CGRectMake(0, 0, 24, 24)];
castButton.tintColor = [UIColor whiteColor];
self.navigationItem.rightBarButtonItem =
    [[UIBarButtonItem alloc] initWithCustomView:castButton];

ストーリーボードにキャストアイコンを追加することもできます。

誰かがボタンをタップすると、キャストダイアログが自動的に表示されます。

デバイスコントロール

CAF では、デバイスコントロールの大部分がフレームワークによって処理されます。送信者アプリケーション側でデバイスへの接続や起動を処理する必要はウェブレシーバーアプリケーション。v2 クラス GCKDeviceManager 非推奨となり、使用されません。送信者とウェブ受信者とのやり取りが "session"。CAF GCKSessionManager クラスがセッションのライフサイクルを処理し、ユーザーの操作に応じて、セッションを自動的に開始および停止します。ユーザーがキャストダイアログでキャストデバイスを選択すると開始され、終了するユーザーが [キャストを停止] をタップしたとき] ボタンを使用する場合や、送信側アプリ自体が終了します送信側アプリケーションに、セッションが成功したことをライフサイクルイベントを登録して、 GCKSessionManagerListener 新しい GCKSessionManager。「 GCKSessionManagerListener プロトコルは、すべてのセッションライフサイクルイベントのコールバックメソッドを定義します。

「 GCKCastSession クラスはキャストデバイスとのセッションを表します。クラスデバイスの音量とミュート状態を制御するメソッドが用意されています。これは、v2 のメソッドを使用して GCKDeviceManager。

v2 では、 GCKDeviceManagerDelegate プロトコルによって提供される変更の通知デバイスの状態（音量、ミュート状態、スタンバイステータスなど）に応じて変更できます。 CAF では、音量/ミュート状態の変化の通知はコールバックを介して配信されます。メソッドを GCKSessionManagerListener プロトコル。これらのリスナーは GCKSessionManager。その他のデバイスの状態の通知はすべて、を介して配信されます。 GCKCastDeviceStatusListener プロトコル。これらのリスナーは GCKCastSession。

再接続ロジック

v2 と同様に、CAF は、ネットワークと通信するための一時的な Wi-Fi 信号の損失やその他のネットワークエラーが原因で失われた。現在はセッションレベルで行われますセッションは「一時停止」ステータス、Pod が切断され、「接続済み」状態に戻ります。状態を接続が回復しますフレームワークはネットワークへの再接続をウェブレシーバーアプリを使用してキャストチャンネルを再接続します。

また、CAF ではセッションの自動再開も追加されています。送信者がアプリがバックグラウンドに移動して終了したり（スワイプやためなど）では、キャストセッションの進行中にフレームワークが送信側アプリケーションがセッションを再開したときに、そのセッションの再開を試行します。起動されるか、再起動されます。アラートの取り込み時に GCKSessionManager これにより、登録済みのすべての GCKSessionManagerListener 説明します。

カスタムチャンネル登録

v2 では、カスタムチャネル（ GCKCastChannel サブクラスまたは GCKGenericChannel 委任など）は、 GCKDeviceManager。 CAF では、代わりにカスタムチャネルは GCKCastSession 作成します。登録は GCKSessionManagerListener -[sessionManager:didStartCastSession:] コールバックメソッドを指定します。メディアアプリケーションの場合、インフラストラクチャを登録し、 GCKMediaControlChannel、詳しくは次のセクションをご覧ください。

メディアコントロール

v2 クラス GCKMediaControlChannel サポートが終了しているため、使用しないでください。CAF では、 GCKRemoteMediaClient 同等の機能を便利な API で提供します。このオブジェクトを明示的に初期化または登録する必要はありません。フレームワークが自動的にオブジェクトをインスタンス化し、基盤となる Web Receiver アプリケーションが接続されている場合、セッション開始時刻のメディアチャネル Media Namespace をサポートしています。

「 GCKRemoteMediaClient gcloud SDK の -[remoteMediaClient] プロパティの GCKCastSession 渡されます。

v2 で発行されたすべてのメディアリクエストは、 GCKMediaControlChannel リクエスト ID は数値で、メソッドは GCKMediaControlChannelDelegate は、リクエストの完了に関する通知を送信するときにこの ID を提供します。失敗します。

CAF で発行されたすべてのメディアリクエストは、 GCKRemoteMediaClient は GCKRequest object;このオブジェクトには GCKRequestDelegate プロトコルリクエストの進行状況と最終的な結果を追跡するために使用できます。

バージョン 2 GCKMediaControlChannel、は、ウェブレシーバーでメディアプレーヤーの状態の変化に関する通知を送信します。経由: GCKMediaControlChannelDelegate。 CAF では、 GCKRemoteMediaClient コールバックは、 GCKRemoteMediaClientListener 構成されます。任意の数のリスナーを GCKRemoteMediaClient: 複数の送信者コンポーネントがセッションに関連付けられている GCKRemoteMediaClient の単一インスタンス。

v2 では、ユーザーを維持する負担を送信者アプリケーションが担う必要がありましたインターフェースは、Web Receiver のメディアプレーヤーの状態と同期します。CAF では、クラスは GCKUIMediaController 主にこの責任を担います詳しくは、 Codelab チュートリアルドキュメントをご覧ください。

案内用のオーバーレイ

V2 では、導入用のオーバーレイ UI。

CAF がクラスを追加する GCKCastContext メソッドを使用 -[presentCastInstructionsViewControllerOnce] 送信側アプリが最初に表示されたときにキャストアイコンをハイライト表示するために使用できるコードです。提供します。

ミニコントローラ

v2 では、ミニコントローラをゼロから実装する必要があります。。

CAF では、フレームワークにコントロールバー、 GCKUIMiniMediaControlsViewController それを永続化したいシーンに追加できます。できます。ミニコントローラを送信アプリに追加する方法は 2 つあります。

ラッピングにより、Cast フレームワークにミニコントローラのレイアウトを管理させる既存のビューコントローラを GCKUICastContainerViewController そして GCKUIMiniMediaControlsViewController クリックします。
次のコマンドを使用して、ミニコントローラを既存のビューコントローラに直接追加します。 -[createMiniMediaControlsViewController] 作成してみましょう。 GCKUIMiniMediaControlsViewController コンテナのビューコントローラにサブビューとして追加できます。

拡張コントローラ

v2 では、拡張コントローラをゼロから実装する必要があります。。

CAF による追加 GCKUIMediaController 拡張コントローラを簡単に実装できます

CAF に事前構築済みの拡張コントローラウィジェットを追加 GCKUIExpandedMediaControlsViewController これをアプリに追加できます。カスタム拡張広告を実装する必要がなくなり GCKUIMediaController を使ってコントローラを操作します。

デバッグログ

「 GCKLogger および GCKLoggerDelegate v2 のクラスは CAF に引き継がれていますが、いくつかの変更と機能強化が行われています。

「 GCKLoggerDelegate -[logFromFunction:message:] メソッドの内容非推奨になりました。 -[logMessage:fromFunction:]。

フレームワークログメッセージをフィルタするために、 GCKLoggerFilter [インスタンスを作成] で [インスタンスの管理] を次の -[filter] プロパティ: GCKLogger シングルトン。

サンプルアプリ

詳しくは、 Codelabs と CAF 用に作成されたサンプルアプリ。