Brightcove Native Player for iOS Reference
Google Cast Plugin for Brightcove Player SDK for iOS, version 22.214.171.1249
iOS 10.0 and above.
The Google Cast Plugin for Brightcove Player SDK provides a static library framework for installation.
The Google Cast plugin supports version 4.3.3 of the Google Cast SDK for iOS. The Podspec for the Google Cast Plugin for Brightcove Player SDK for iOS references version 4.3.3 of the Google Cast iOS SDK as instructed by the GoogleCast SDK Release Notes.
You can use CocoaPods to add the Google Cast Plugin for Brightcove Player SDK to your project. You can find the latest
Brightcove-Player-GoogleCast podspec here. The pod will incorporate the correct version of GoogleCast automatically. CocoaPods 1.0 or newer is required.
CocoaPod Podfile example:
source 'https://github.com/brightcove/BrightcoveSpecs.git' source 'https://github.com/CocoaPods/Specs' platform :ios, '10.0' use_frameworks! target 'ExampleApp' do pod 'Brightcove-Player-GoogleCast' end
When updating your installation, it’s a good idea to refresh the local copy of your BrightcoveSpecs repository so that you have the latest podspecs locally, just like you would update your CococaPods master repository.
Typically if you use
pod update in Terminal this will happen automatically, or alternatively you can update explicitly with
pod repo update brightcove. (Your BrightcoveSpecs repository may have a different name if you explicitly added it to your list of podspecs repos.)
To add the Google Cast Plugin for Brightcove Player SDK to your project manually:
- Follow the Google Cast SDK Manual Setup guide.
- Follow the Brightcove Player SDK Manual Installation guide.
- Download the Google Cast Plugin for Brightcove Player SDK framework.
- On the “General” tab of your application target, add BrightcoveGoogleCast.framework from the Google Cast Plugin for Brightcove Player SDK download to the list of Embedded Binaries.
- On the “Build Settings” tab of your application target, ensure that the “Framework Search Paths” include the paths to the frameworks. This should have been done automatically unless the framework is stored under a different root directory than your project.
The Google Cast Plugin for Brightcove Player SDK can be imported into code a few different ways;
#import <BrightcoveGoogleCast/BrightcoveGoogleCast.h> or
#import <BrightcoveGoogleCast/[specific class].h>. You can import the
BrightcovePlayerSDK modules in similar fashion.
Before You Begin
Before attempting to utilize this plugin you should already be familiar with the following:
- Register your application. This will walk you through creating your reciever application and grant you an application ID. Starting out you can use the demo application ID ‘4F8B3483’.
- Setup for Developing with the Cast Application Framework (CAF) for iOS . This will walk you through setting up the necessary entitlements for your app.
- Initialze the Cast Context. This will walk you through initializing the Cast Context with your receiver application ID.
- Add Mini Controllers. This will walk you through how to take advantage of the Google Cast SDK’s mini media controls.
This snippet shows its basic usage. ```  BCOVGoogleCastManager *castManager = [BCOVGoogleCastManager sharedManager];
 id<BCOVPlaybackController> playbackController = [BCOVPlayerSDKManager.sharedManager createPlaybackController];  [playbackController addSessionConsumer:self.castManager];
Breaking the code down into steps: 1. Create a reference to the BCOVGoogleCastManager singleton. 1. Create an instance of BCOVPlaybackController to use. 1. Add your BCOVGoogleCastManager reference as a session consumer to your BCOVPlaybackController instance. If you have questions or need help, we have a support forum for Brightcove's native Player SDKs at [https://groups.google.com/forum/#!forum/brightcove-native-player-sdks][forum] . Delegate Methods ========== BCOVGoogleCastManagerDelegate has four delegate methods that you can use to know when major casting-related events have occured. These are: * `- (void)switchedToLocalPlayback:(NSTimeInterval)lastKnownStreamPosition` is called when a cast session ends. * `- (void)switchedToRemotePlayback` is called when a cast session starts. * `- (void)currentCastedVideoDidComplete` is called when a casted video has finished playing. * `- (void)suitableSourceNotFound` is called when no suitable source is found to cast. To take advantage of these events, simply set a delegate on the BCOVGoogleCastManager singleton.
[BCOVGoogleCastManager sharedManager].delegate = self;
The BCOVGoogleCastManager will attempt to find a suitable source to use. It will look for sources in this order:
- HTTPS HLS v3
- HTTPS DASH
- HTTPS MP4
- HTTP HLS v3
- HTTP DASH
- HTTP MP4
If none of these are found, the delegate method
suitableSourceNotFound will be called.
Your Video Cloud account will need to be set up to support HLS v3, ensure that DASH is enabled or have an MP4 source available for each video.
There are two properties, in addition to the delegate property, that you can set on the BCOVGoogleCastManager class. These are:
GCKImage *fallbackPosterImage: The GCKImage that will be used when there is no poster image available for a video.
CGSize posterImageSize: The height and width that you want to use for the GCKImage object image that is created. Defaults to 480h x 720w.
- DRM is not supported when using the Cast plugin with the Google sample receiver app.
- Multiple Audio Tracks are not supported when using the Cast plugin with the Google sample receiver app.
- Client-side and Server-side Advertising is not supported when using the Cast plugin with the Google sample receiver app.
- Live and Live DVR streams are not supported when using the Cast plugin with the Google sample receiver app.