Cast SDK v2에서 Cast 애플리케이션 프레임워크 (CAF)로 iOS 발신기 앱 이전

다음 절차에 따라 iOS SDK 앱을 Cast SDK v2에서 GCKCastContext 싱글톤을 기반으로 하는 CAF Sender로 변환할 수 있습니다.

소개

  • CAF 발신자는 계속해서 v2와 같은 Google Cast 개발자 웹사이트 및 CocoaPods에 배포됩니다.
  • Google Cast 디자인 체크리스트 준수를 담당하는 새로운 클래스가 추가되었습니다.
  • CAF 발신자는 Cast UX 요구사항을 준수하는 위젯을 제공합니다. v2는 UI 구성요소를 제공하지 않았으므로 이러한 위젯을 구현해야 합니다.
  • CAF Sender 디자인은 Cast Android SDK 설계와 일치합니다.
  • CAF Sender는 v2와 같은 비트코드를 지원합니다.
  • CAF의 자막은 v2와 유사합니다.

종속 항목

CAF Sender는 iOS 버전 8 이상을 지원합니다.

초기화

CAF에서는 Cast 프레임워크에 명시적인 초기화 단계가 필요합니다. 여기에는 적절한 GCKCastOptions를 사용하여 웹 수신기 애플리케이션 ID 및 기타 전역 옵션을 지정하는 GCKCastContext 싱글톤을 초기화합니다. 이 작업은 일반적으로 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는 지원 중단되었으므로 사용해서는 안 됩니다. 이제 발신자와 웹 수신자 간의 상호작용이 '세션'으로 표시됩니다. CAF GCKSessionManager 클래스는 세션 수명 주기를 처리하고 사용자 동작에 응답하여 세션을 자동으로 시작하고 중지합니다. 사용자가 전송 대화상자에서 Cast 기기를 선택하면 세션이 시작되고 전송 대화상자에서 '전송 중지' 버튼을 탭하거나 발신자 앱 자체가 종료되면 세션이 종료됩니다. GCKSessionManager로 GCKSessionManagerListener를 등록하여 발신자 애플리케이션에 세션 수명 주기 이벤트에 대한 알림을 제공할 수 있습니다. GCKSessionManagerListener 프로토콜은 모든 세션 수명 주기 이벤트의 콜백 메서드를 정의합니다.

GCKCastSession 클래스는 Cast 기기와의 세션을 나타냅니다. 이 클래스에는 기기 볼륨과 음소거 상태를 제어하는 메서드가 있으며, 이는 v2에서 이전에 GCKDeviceManager의 메서드를 사용하여 실행되었습니다.

v2에서 GCKDeviceManagerDelegate 프로토콜은 볼륨, 음소거 상태, 대기 상태 등 기기 상태 변경에 관한 알림을 제공했습니다. CAF에서 볼륨/음소거 상태 변경 알림은 GCKSessionManagerListener 프로토콜의 콜백 메서드를 통해 전달됩니다. 이러한 리스너는 GCKSessionManager에 등록됩니다. 나머지 모든 기기 상태 알림은 GCKCastDeviceStatusListener 프로토콜을 통해 전달됩니다. 이러한 리스너는 GCKCastSession에 등록됩니다.

재연결 로직

v2와 마찬가지로 CAF는 일시적인 Wi-Fi 신호 손실이나 기타 네트워크 오류로 인해 연결이 끊긴 네트워크 연결을 다시 설정하려고 시도합니다. 이 작업은 이제 세션 수준에서 실행됩니다. 연결이 끊어지면 세션은 '정지됨' 상태로 전환될 수 있고, 연결이 복원되면 '연결됨' 상태로 다시 전환됩니다. 프레임워크는 이 프로세스의 일부로 웹 수신기 애플리케이션에 다시 연결하고 Cast 채널을 다시 연결합니다.

또한 CAF는 자동 세션 재개도 추가합니다. 전송 세션이 진행 중일 때 발신기 애플리케이션이 백그라운드로 전송되거나 스와이프해서 종료되거나 비정상 종료로 인해 종료된 경우, 발신자 애플리케이션이 포그라운드로 돌아가거나 다시 실행될 때 프레임워크에서 해당 세션을 재개하려고 시도합니다. 그러면 GCKSessionManager에 의해 자동으로 처리되어 등록된 GCKSessionManagerListener 인스턴스에 적절한 콜백이 실행됩니다.

맞춤 채널 등록

v2에서는 맞춤 채널 (GCKCastChannel 서브클래스 또는 GCKGenericChannel 및 대리자를 사용하여 구현됨)이 GCKDeviceManager에 등록되었습니다. CAF에서 커스텀 채널은 GCKCastSession 인스턴스에 대신 등록됩니다. 등록은 GCKSessionManagerListener -[sessionManager:didStartCastSession:] 콜백 메서드에서 실행할 수 있습니다. 미디어 애플리케이션의 경우 더 이상 GCKMediaControlChannel를 명시적으로 등록하지 않아도 됩니다. 자세한 내용은 다음 섹션을 참조하세요.

미디어 제어

v2 클래스 GCKMediaControlChannel는 지원 중단되었으므로 사용해서는 안 됩니다. CAF에서는 더 편리한 API로 동일한 기능을 제공하는 새로운 GCKRemoteMediaClient 클래스로 대체되었습니다. 이 객체를 명시적으로 초기화하거나 등록할 필요가 없습니다. 연결 중인 웹 수신기 애플리케이션이 미디어 네임스페이스를 지원하는 경우 프레임워크는 자동으로 객체를 인스턴스화하고 세션 시작 시간에 기본 미디어 채널을 등록합니다.

GCKCastSession 객체의 -[remoteMediaClient] 속성을 사용하여 GCKRemoteMediaClient에 액세스할 수 있습니다.

v2에서 GCKMediaControlChannel에 실행된 모든 미디어 요청은 숫자 요청 ID를 반환하고 GCKMediaControlChannelDelegate의 메서드는 요청 완료 또는 실패에 대한 알림을 보낼 때 이 ID를 제공합니다.

CAF에서 GCKRemoteMediaClient에 실행된 모든 미디어 요청은 GCKRequest 객체를 반환합니다. 이 객체에는 요청의 진행 상황과 최종 결과를 추적하는 데 사용할 수 있는 관련 GCKRequestDelegate 프로토콜이 있습니다.

v2 GCKMediaControlChannel는 GCKMediaControlChannelDelegate를 통해 웹 수신기의 미디어 플레이어 상태 변경사항에 관한 알림을 전송합니다. CAF에서 GCKRemoteMediaClient는 GCKRemoteMediaClientListener 프로토콜을 통해 동등한 콜백을 제공합니다. GCKRemoteMediaClient에 여러 리스너를 등록할 수 있으며, 이를 통해 여러 발신자 구성요소가 세션과 연결된 GCKRemoteMediaClient의 단일 인스턴스를 공유할 수 있습니다.

v2에서는 발신자 애플리케이션이 웹 수신기의 미디어 플레이어 상태와 사용자 인터페이스를 동기화해야 하는 부담을 감수해야 했습니다. CAF에서 GCKUIMediaController 클래스가 이 책임을 대부분 수행합니다. 이 구성요소의 사용 방법에 관한 예는 Codelab 튜토리얼 문서를 참고하세요.

소개 오버레이

V2는 소개 오버레이 UI를 제공하지 않습니다.

CAF는 전송 앱이 사용자에게 처음 표시될 때 전송 버튼을 강조표시하는 데 사용할 수 있는 -[presentCastInstructionsViewControllerOnce] 메서드와 함께 GCKCastContext 클래스를 추가합니다.

미니 컨트롤러

v2에서는 미니 앱에서 발신자 앱을 처음부터 구현해야 합니다.

CAF에서 프레임워크는 영구 컨트롤을 표시할 장면에 추가할 수 있는 컨트롤 바 GCKUIMiniMediaControlsViewController를 제공합니다. 미니 앱에 발신자 앱을 추가하는 방법에는 두 가지가 있습니다.

확장 컨트롤러

v2의 경우 발신기 앱의 확장된 컨트롤러를 처음부터 구현해야 합니다.

CAF에는 확장된 컨트롤러를 더 쉽게 구현하는 데 사용할 수 있는 GCKUIMediaController가 추가되었습니다.

CAF는 사전 빌드된 확장 컨트롤러 위젯 GCKUIExpandedMediaControlsViewController을 앱에 추가하기만 하면 됩니다. 더 이상 GCKUIMediaController를 사용하여 맞춤 확장 컨트롤러를 구현하지 않아도 됩니다.

디버그 로깅

v2의 GCKLogger 및 GCKLoggerDelegate 클래스는 CAF로 이전되며 일부 변경사항과 개선사항이 있습니다.

GCKLoggerDelegate -[logFromFunction:message:] 메서드가 지원 중단되고 -[logMessage:fromFunction:]로 대체되었습니다.

이제 프레임워크 로그 메시지를 적절한 GCKLoggerFilter 인스턴스를 구성하고 GCKLogger 싱글톤의 -[filter] 속성을 설정하여 할당할 수 있습니다.

샘플 앱

CAF용으로 작성된 Codelab 및 샘플 앱을 참고하시기 바랍니다.