@mattebox/cast-receiver
This library connects Google's Cast receiver framework (CAF, version 3) to
<mattebox-player>. You can turn a web page into a Chromecast receiver with
a few lines of code. The library creates no DOM, and importing it has no
side effects.
Install the library and its peer dependencies:
npm install @mattebox/cast-receiver @mattebox/player @mattebox/player-core mattebox
Add Google's framework to your page:
<script src="https://www.gstatic.com/cast/sdk/libs/caf_receiver/v3/cast_receiver_framework.js"></script>
Create the receiver, create the player with the receiver's handlers, and start the receiver:
import { createReceiver } from '@mattebox/cast-receiver';
import { MatteboxPlayerElement } from '@mattebox/player';
import full from 'mattebox/presets/full';
const receiver = createReceiver({ preset: full });
const player = new MatteboxPlayerElement({ handlers: receiver.handlers() });
document.body.append(player);
receiver.start(player);
| The library does this | The library does not do this |
|---|---|
It passes the sender's LOAD through your resolve and loads the player | It does not create or append any element |
| It reports the media status from the video and the engine | It does not know what a token is, or where a license comes from |
| It selects audio and text tracks under stable Cast ids | It does not bundle an engine preset. Your page imports one |
| It sends the player's errors to every sender | It does not load Google's framework. Your page loads it |
| It passes custom namespaces through | It does not ship a fake framework. The library's tests have their own |
The framework's script is never a dependency of the library. The engine, the core and the player are peer dependencies.
You can read the guide in the repository: docs/guide.
License
MIT