Casting Media
This feature is currently a Work In Progress, and is only available in v3.3b at this time
Casting Remote Media
By definition, remote media includes items such as YouTube videos, Twitch streams etc
It is possible to cast media from several hundred sites
To start casting, send a HTTP POST request to /cast
with the following json-encoded body parameter:
- JSON
- Schema
- Response
Once the media has finished playing, the cast will automatically close
Casting Local Media
Local Media files are those that are somewhere on the operating system.
Having the ability to cast local media, means that it is now possible to have Assistant Relay trigger a ringing sound when your doorbell is pressed, an alarm if someone breaks into your house, or anything else you could think of.
To cast a local file, send a HTTP POST request to /cast
with the following json-encoded body:
- JSON
- Schema
- Response
NOTE: There is a bug with Smart Speakers and Displays where the cast session stays in progress after local media has been played. This can be seen by the black screen with the cast icon inside it. With the latest version of CATT, there is a workaround that will kill the Cast session once finished. You may hear the cast sound again whilst the session is being killed.
Casting Custom Media
Custom Media files are those that live within the
/bin/media/
folder inside Assistant Relay.
Having the ability to cast custom media, means that it is now possible to have Assistant Relay trigger a ringing sound when your doorbell is pressed, an alarm if someone breaks into your house, or anything else you could think of.
To cast a custom media file, send a HTTP POST request to /cast
with the following json-encoded body:
- JSON
- Schema
- Response
NOTE: There is a bug with Smart Speakers and Displays where the cast session stays in progress after local media has been played. This can be seen by the black screen with the cast icon inside it. With the latest version of CATT, there is a workaround that will kill the Cast session once finished. You may hear the cast sound again whilst the session is being killed.
Casting Websites
CATT
also allows you to cast websites straight to your Chromecasts or Smart Displays
To cast a website, send a HTTP POST request to /cast
with the following json-encoded body:
- JSON
- Schema
- Response
NOTE: Smart Displays have no keyboard interface, so a website must provide its own text entry method if needed