--- updatedAt: 2026-07-20T12:03:55.000Z agentTools: siteIndex: https://developer.bitmovin.com/llms.txt projectIndex: https://developer.bitmovin.com/playback/llms.txt --- # Remote Control Google Cast and WebSocket remote control configuration ## GoogleCastReceiverVersion > Enum ## Enumeration Members ### v2 > **v2**: `"v2"` *** ### v3 > **v3**: `"v3"` *** ## GoogleCastRemoteControlConfig > Interface Configuration interface for remote control of Google Cast (e.g. Chromecast) receivers. Example (enable casting with Bitmovin receiver app and custom style): ```js { type: 'googlecast', customReceiverConfig: { receiverStylesheetUrl: 'https://mycdn.com/mycustomreceiverstyle.css', }, } ``` Example (custom receiver): ```js { type: 'googlecast', receiverApplicationId: '1234ABCD', customReceiverConfig: { customPropertyName: 'customValue', }, } ``` ## Extends * [`RemoteControlConfig`](https://developer.bitmovin.com/playback/reference/web-sdk-remote-control#remotecontrolconfig) ## Properties ### customReceiverConfig? > `optional` **customReceiverConfig?**: [`RemoteControlCustomReceiverConfig`](https://developer.bitmovin.com/playback/reference/web-sdk-remote-control#remotecontrolcustomreceiverconfig) An arbitrary configuration object that is sent to the receiver when a connection is established. This object can carry configuration values that are of no concern to and are handled outside of the RemoteControl/ RemoteControlReceiver architecture. #### Inherited from [`RemoteControlConfig`](https://developer.bitmovin.com/playback/reference/web-sdk-remote-control#remotecontrolconfig).[`customReceiverConfig`](https://developer.bitmovin.com/playback/reference/web-sdk-remote-control#customreceiverconfig) *** ### messageNamespace? > `optional` **messageNamespace?**: `string` The message namespace for communication of advanced player functionality not covered by the Cast media controls. Only overwrite this if you are implementing your own custom receiver. *** ### receiverApplicationId? > `optional` **receiverApplicationId?**: `string` The application ID of the Cast application that should be launched when connecting to a Cast receiver. Set this if you want to use your own custom receiver application. If unset, the Bitmovin player cast application is used. *** ### receiverVersion? > `optional` **receiverVersion?**: `"v2"` | `"v3"` The receiver app version. This is only necessary if providing custom [receiverApplicationId](https://developer.bitmovin.com/playback/reference/web-sdk-remote-control#receiverapplicationid) and it is using receiver app v3. Default is 'v2' **Since:** 8.43.0 *** ### rejoinActiveSession? > `optional` **rejoinActiveSession?**: `boolean` Specifies, whether an existing Cast session shall be re-joined rather than creating a new one when casting starts. Default is `false`. **Since:** 8.67.0 *** ### type > **type**: `"googlecast"` ## Methods ### prepareMediaInfo()? > `optional` **prepareMediaInfo**(`mediaInfo`): `Promise`<`any`> Callback providing the possibility to prepare/alter the media info object before it is loaded onto Chromecast receiver app to change its media/source. Example: ```js prepareMediaInfo: function(mediaInfo) { // Signal fMP4 container format for audio and video mediaInfo.hlsSegmentFormat = chrome.cast.media.HlsSegmentFormat.FMP4; mediaInfo.hlsVideoSegmentFormat = chrome.cast.media.HlsVideoSegmentFormat.FMP4; return Promise.resolve(mediaInfo); } ``` Note: This callback is only supported with Chromecast v3 (CAF) receivers. #### Parameters ##### mediaInfo `any` The object representing the media to be loaded on the receiver, see [chrome.cast.media.MediaInfo](https://developers.google.com/cast/docs/reference/web_sender/chrome.cast.media.MediaInfo) #### Returns `Promise`<`any`> A promise resloving with the altered object that the player will load on the receiver. **Since:** 8.78.0 *** ## RemoteControlConfig > Interface Configuration interface for a `RemoteControl`. ## Extended by * [`GoogleCastRemoteControlConfig`](https://developer.bitmovin.com/playback/reference/web-sdk-remote-control#googlecastremotecontrolconfig) * [`WebSocketRemoteControlConfig`](https://developer.bitmovin.com/playback/reference/web-sdk-remote-control#websocketremotecontrolconfig) ## Properties ### customReceiverConfig? > `optional` **customReceiverConfig?**: [`RemoteControlCustomReceiverConfig`](https://developer.bitmovin.com/playback/reference/web-sdk-remote-control#remotecontrolcustomreceiverconfig) An arbitrary configuration object that is sent to the receiver when a connection is established. This object can carry configuration values that are of no concern to and are handled outside of the RemoteControl/ RemoteControlReceiver architecture. *** ## WebSocketRemoteControlConfig > Interface Configuration interface for WebSocket-based player remote control. Requires a running WebSocket server available at . Example: ```js { type: 'websocket', url: 'ws://your-server-ip:29100', customReceiverConfig: { receiverStylesheetUrl: 'https://mycdn.com/mycustomreceiverstyle.css', }, } ``` ## Extends * [`RemoteControlConfig`](https://developer.bitmovin.com/playback/reference/web-sdk-remote-control#remotecontrolconfig) ## Properties ### customReceiverConfig? > `optional` **customReceiverConfig?**: [`RemoteControlCustomReceiverConfig`](https://developer.bitmovin.com/playback/reference/web-sdk-remote-control#remotecontrolcustomreceiverconfig) An arbitrary configuration object that is sent to the receiver when a connection is established. This object can carry configuration values that are of no concern to and are handled outside of the RemoteControl/ RemoteControlReceiver architecture. #### Inherited from [`RemoteControlConfig`](https://developer.bitmovin.com/playback/reference/web-sdk-remote-control#remotecontrolconfig).[`customReceiverConfig`](https://developer.bitmovin.com/playback/reference/web-sdk-remote-control#customreceiverconfig) *** ### type > **type**: `"websocket"` *** ### url > **url**: `string` The URL of the WebSocket server managing communication between WebSocket remote controls and WebSocket remote receivers. *** ## CastConfig > Interface Example: ```js cast : { enable : true, application_id : 'A12B45C6' } ``` ## Properties ### application\_id? > `optional` **application\_id?**: `string` The ChromeCast application ID retrieved from Google when a Cast receiver app is registered. To use ChromeCast with player version 6 an higher, it is not necessary to use this option. For versions pre v6, please use ‘121122A0’, or your dedicated ID, in case you want to use a custom ChromeCast receiver app. Starting with player 6, the application ID needs only be set if you want to use your own custom receiver app. By default, Bitmovin's Cast receiver app is used. *** ### enable? > `optional` **enable?**: `boolean` ChromeCast support is disabled (`false`) per default. To enable it, set this attribute to `true`. *** ### message\_namespace? > `optional` **message\_namespace?**: `string` A custom message namespace as defined in the Cast receiver app. To use ChromeCast, it is not necessary to use this option! This is only needed if one wants to create a custom ChromeCast receiver app. *** ### receiverStylesheetUrl? > `optional` **receiverStylesheetUrl?**: `string` A URL to a CSS file the Chromecast receiver app loads. Can be used to style the receiver app. **Since:** 7.1 *** ## RemoteControlCustomReceiverConfig > Interface ## Indexable > \[`key`: `string`]: `string` Arbitrary configuration values that are sent to the remote control receiver. ## Properties ### receiverStylesheetUrl? > `optional` **receiverStylesheetUrl?**: `string` A URL to a stylesheet that customizes the receiver UI style.