# google-cast

Options for the Google Cast extension that configures the receiver and load request

Adds the [Google Cast extension](https://videojs.org/docs/framework/html/guides/architecture) to the player’s media. It renders nothing — place it inside the player as a sibling of the media element, and pair it with a [CastButton](https://videojs.org/docs/framework/html/reference/components/cast-button). See [Cast to AirPlay and Chromecast](https://videojs.org/docs/framework/html/guides/casting) for the complete setup.

## Import

```bash
pnpm add @videojs/html @videojs/google-cast
```

```ts
import '@videojs/html/extensions/google-cast';
```

Or load it from the [CDN](https://videojs.org/docs/framework/html/guides/cdn):

```html
<script type="module" src="https://cdn.jsdelivr.net/npm/@videojs/cdn@10.0.0-rc.4/extensions/google-cast.js"></script>
```

## Anatomy

```html
<google-cast></google-cast>
```

## Options

| Attribute | Property | Description |
| --- | --- | --- |
| `receiver` | `receiver` | Cast receiver application ID. Defaults to Google’s Default Media Receiver (`CC1AD845`) |
| `src` | `src` | Source URL loaded on the receiver. Defaults to the source the browser is playing |
| `content-type` | `contentType` | MIME type of the Cast source. When unset, the receiver infers it from the URL |
| `stream-type` | `streamType` | Stream type reported to the receiver. Falls back to the player’s stream type |
| — | `customData` | Custom data sent to the receiver with each load request |

`customData` takes an object, so it’s a property only, with no matching attribute.

When the Cast `src` is an HLS playlist, Video.js detects the segment format and sets the receiver’s `hlsSegmentFormat` and `hlsVideoSegmentFormat` load-request fields. The Default Media Receiver plays HLS natively, so no extra receiver setup is needed.

## See also

- [Cast to AirPlay and Chromecast](https://videojs.org/docs/framework/html/guides/casting): Add remote playback to a player
- [CastButton component reference](https://videojs.org/docs/framework/html/reference/components/cast-button)
- [Remote Playback feature reference](https://videojs.org/docs/framework/html/reference/api/feature-remote-playback)

---

HTML documentation: https://videojs.org/docs/framework/html/llms.txt
All documentation: https://videojs.org/llms.txt