Google Cast


You must register your application if you are using the Styled Media Receiver or you are building a Custom Receiver. Once you've registered your application, you'll receive an app ID that your sender application must use to perform API calls such as to launch the receiver application.

You must also register your Google Cast device so that it may access your receiver application before you publish it. Once you publish your receiver application, it will be available to all Google Cast devices.

Register your application

You must register your Styled Media Receiver or Custom Receiver in order to receive an app ID that's used with API calls from the sender application.

To register your receiver app:

  1. Sign in to the Google Cast SDK Developer Console.
  2. From either the Overview page or Applications page, click Add New Application.
  3. Select the type of receiver app you will use:
    Custom Receiver
    Select this if your app requires user interface components or interaction patterns that are not provided by the Styled Media Receiver. Selecting Custom Receiver may also be necessary if your content type is not listed as one of Styled Media Receiver's supported media types.

    Be aware that this option requires that you build a complete web app for the receiver app.

    For details, read Custom Receiver Application.

    Styled Media Receiver
    Select this if your app streams video or audio content using one of the supported media types and you'd like to provide a user interface on the TV that uses either the default media player UI or a set of custom styles on top of the default media player UI.

    The custom styles you may provide allow you to define the look for various elements of the player UI (such as the splash screen and progress bar) simply by providing a CSS file—you do not need to build a receiver app.

    For details, read Styled Media Receiver.

  4. Fill in the details for you receiver app:
    1. Enter your app name.
    2. Specify the receiver app's appearance:
      • For a Custom Receiver, specify the app URL.

        Enter a URL that the Google Cast device should request when loading your receiver app. During development the URL can use HTTP but when the app is published it has to use HTTPS. The URL may be for an HTML page or other file type accessible from a web browser. It's okay for your receiver to be on an internal (NAT-registered) IP address, but not on localhost, as it is rarely a top level domain. Although the receiver app must be served over SSL (HTTPS) when published, the content loaded on the receiver app may be served over HTTP.

        Although the receiver app must be served over SSL (HTTPS), the content loaded on the receiver app may be served over HTTP.

      • For a Styled Media Receiver, specify the app style.

        Select Default for the default media player UI. (You can later switch to Custom if you decide to provide your own UI styles.)

        Select Custom to provide your own CSS file that specifies the appearance for several elements of the media player UI. In the input field that appears, provide an HTTPS URL that points to your CSS file located on your own web site or on Google Drive.

        Click Preview at the bottom to view your receiver app's appearance using mock media content.

    3. Select whether the app should be published for end-users.

      Leave this set to No while developing and testing your app with a registered Google Cast device.

      When you're ready to publish your app for end-users, set this to Yes.

    4. Select the platforms on which your sender app will be available and provide the relevant identification information.
  5. Click Save.

In the list of Applications, your new app is listed with a unique Application ID. Copy this ID for use in the code for your sender app.

If you selected Styled Media Receiver, there's nothing else you need to do for the receiver app, other than provide optional CSS styling as described in the Styled Media Receiver guide.

If you selected Custom Receiver, you must provide a web app as described in the Custom Receiver Application guide.

Note: A third type of receiver app, the Default Media Receiver, does not require you to register in the Google Cast SDK Developer Console. It uses an API constant as the app ID and does not allow you to provide any stying to the media player UI.

Register your Google Cast device

By default, Google Cast devices (such as a Chromecast) are not enabled for development and testing. To turn your device into a development device and gain access to your receiver app while it is not yet published, you must register the device. Registering also makes the receiver app accessible from a remote browser window for debugging (see Debugging).

To register your Google Cast device:

  1. Sign in to the Google Cast SDK Developer Console.
  2. From either the Overview page or Devices page, click Add New Device.
  3. Enter the serial number of your development device. This is a 12-digit alphanumeric string printed on the device.

    The serial number on a Chromecast is laser-etched (not printed) and begins with a 3, 4 or 5. It may be easier to read if you take a picture of the serial number then enlarge it.

  4. Enter a description. This is just a friendly name for your device (it does not need to match the name you gave to the device during user setup).
  5. Click OK.

    It may take several minutes for the device to become registered and available as your development device. Once registration is complete, the Status for the device will say "Ready for Testing."

  6. Restart the Google Cast device that you have registered. Check whether you can access http://<cast-device-ip>:9222 from a chrome browser on the same WiFi network; if you can, then your device is ready for development.

Authentication required

You need to be signed in with Google+ to do that.

Signing you in...

Google Developers needs your permission to do that.