The Google Cast SDK includes API libraries and sample application code to help your applications go big. These APIs are documented in the API references, and the sample code is discussed in the Android, iOS, and Chrome Sender and the Receiver app guides.
Here's what you need to build a Cast app.
A sender application, written for the Android, iOS, or Chrome platform which uses the following Cast APIs:
A receiver application that handles communication between the sender app and the receiver device. You have the following options:
- The Default Media Receiver presented with the Google Cast branding and styling.
- The Styled Media Receiver for which you can develop the styles and branding. See Styled Media Receiver.
- A custom receiver, as described in Custom receiver that implements the Receiver API and handles custom messages from your sender app; it may also interface with the media player types provided through the Media Player Library.
How you implement your receiver may depend upon which media types your application needs to support.
In accordance with the Google Cast SDK Additional Developer Terms of Service, a Cast media application must use the Media Playback Messages defined for the SDK to control media playback on the receiver. Doing so provides the media app with a consistent user experience across platforms and it ensures that a Cast application will support new and future use cases. These structures also support custom data, where appropriate, and an application may define its own messages for commands not supported by the SDK.
Setup for Development
For all Google Cast devices, do the following:
Install your Cast device and run through the setup instructions.
For Chromecast devices, get the Google Home app or Chrome extension. For other devices, see the manufacturer's instructions.
Run the Google Home app (for a phone or tablet) or extension (for a laptop) on your sender device, following the setup prompts as directed.
Register your Google Cast device at the Google Cast SDK Developer Console.
You must register the device so that you can use it for testing. See Devices for more information about registering devices.
For Android TV, see Android TV with Google Cast.
For Google Cast for audio devices, see Audio Devices.
Review the User Experience Guidelines showing you how to implement a UI that is consistent with other Cast apps.
Get the API libraries for sender and receiver apps.
Try the Sample Apps to help you get started.
Register your application.
You will receive an app ID to include with your API calls.
Develop your app.
Install API libraries
In this section you can download the APIs that will enable your application to cast content to a Google Cast receiver device.
iOS Sender API library
The iOS Sender API library Supports iOS version 9 and later.
You can install iOS Sender API libraries either manually or using Cocoapods, which we recommend.
Follow the instructions at Xcode setup.
Install by Cocoapod
You can install the iOS Sender API libraries via Cocoapods.
Android Sender API library
To set up your Android project, you need to:
- Add the Google Play services library to your project. For setup instructions, read Set Up Google Play Services SDK.
- Add the v7mediarouter library to your project. This library provides the framework and UI components that allow your app to select the Google Cast media route. For setup instructions, read Support Library Setup and be sure you follow the section about Adding libraries with resources.
Chrome Sender API library
Chrome Sender SDK is supported on both Chrome for desktop and Chrome for Android.
Reference to Chrome API Library
To use the Chrome Sender API on either platform, include the following script in your Chrome page:
Omit the string
?loadCastFramework=1 to access the older non-framework version
of Chrome sender.
The Sender API on Chrome for Android requires Chrome version 48 or later, and Android version Jelly Bean 4.1.x (API level 16) or later.
The Sender API on Chrome for Desktop requires either:
- Chrome version 32 to 50 and the Cast Extension version 126.96.36.199 or later.
- Chrome version 51 or later without a Cast Extension (Chrome version 51 builds in the Extension functionality).
Receiver API library
The CAF Receiver SDK includes an API which is available to the receiver application once you register your receivers and devices for development. To use the API, include this reference to the CAF Receiver API library in your receiver application.
The older Receiver 2 SDK includes an API which is available to the receiver application once you register your receivers and devices for development. To use the API, include the following reference in your receiver application:
Download Cast Icons
This file includes both bitmaps and vectors for the icons. These are also included with the Android v7mediarouter library.