Get Started

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.

App components

Here's what you need to build a Cast app.

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

  1. For all Google Cast devices, do the following:

    1. 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.

    2. 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.

    3. 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.

  2. For Android TV, see Android TV with Google Cast.

  3. For Google Cast for audio devices, see Audio Devices.

  4. Review the User Experience Guidelines showing you how to implement a UI that is consistent with other Cast apps.

  5. Get the API libraries for sender and receiver apps.

  6. Try the Sample Apps to help you get started.

  7. Register your application.

    You will receive an app ID to include with your API calls.

  8. Develop your app.

Install API libraries

The Google Cast SDK and API libraries support the development of Android, iOS, and Chrome sender applications, and the development of Web Receiver applications in JavaScript - written for the Chrome browser.

iOS Sender API library

Follow the setup instructions to get started with the iOS Sender API.

Libraries without guest mode have been provided for situations where your app does not require the feature or you do not wish to require Bluetooth® permissions, which have been introduced in iOS 13. Please see the iOS 13 Changes document for more information.

Download the Cast 4.6.0 iOS Sender API libraries:

Static with Guest Mode Static without Guest Mode

Dynamic with Guest Mode Dynamic without Guest Mode

Right-click GoogleCast.framework in your project, and select Show In Finder.

Drag the GoogleCastCoreResources.bundle and GoogleCastUIResources.bundle into the top-level directory of your Xcode project. When prompted, ensure Copy items into destination group's folder is NOT selected.

Android Sender API library

Follow the setup instructions to get started with the Android Sender API.

Chrome Sender API library

Follow the setup instructions to get started with the Chrome Sender API.

Web Receiver API library

The Web Receiver SDK includes an API which is available to the Web Receiver application once you register your receivers and devices for development. Follow the setup instructions to get started with the Web Receiver API.

Download Cast icons

Download the Cast Icons for Android, iOS, and Chrome.

This file includes both bitmaps and vectors for the icons. These are also included with the Android v7mediarouter library.