<mux-video/>
` if you want to use the browser built-in HTML5 video element for playback you would have to wire up [Hls.js](https://github.com/video-dev/hls.js) and [Mux Data](https://docs.mux.com/guides/data/monitor-hls-js) yourself.
`` will automatically handle recoverable errors that happen during video playback. This is particularly handy for live streams that may experience disconnects.
`` will use the optimial Hls.js settings for Mux Video so you don't have to worry about that. `` will also periodically test new versions of Hls.js and upgrade to known stable versions so you don't have to worry about upgrading to a new version of Hls.js yourself.
## Usage
Loading this library in the browser will register a [custom web component](https://developer.mozilla.org/en-US/docs/Web/Web_Components) for ``.
Now you are free to use this web component in your HTML, just as you would with the HTML5 `` element.
```html
` element.
All the other attributes that you would use on a `` element like `poster`, `controls`, `muted` and `autoplay` are available and will work the same as they do with the HTML5 video element. One sidenote about `autoplay` though -- [read this to understand why that might not always work as expected](https://docs.mux.com/guides/video/web-autoplay-your-videos).
### Advanced: more metadata
To go above and beyond `metadata-*` attributes
To set other available metadata fields use the `metadata` property on the `` element like so:
```html
```
Instead of using the `metadata` property, you also have the option to specify a remote URL for fetching metadata asynchronously. In the example below you would have an API server running at `https://api.myapp.com/` and the specified endpoint should respond with JSON in the form of something like this:
```json
{
"experiment_name": "landing_page_v3",
"video_content_type": "clip",
"video_series": "season 1"
}
```
When `metadata-url` is specified then `` will asychronously fetch the extra metadata without blocking the initial startup time.
```html
```
Take a look at the [metadata guide](https://docs.mux.com/guides/data/make-your-data-actionable-with-metadata) to view an exhaustive list of available values.
### Advanced: prefer-mse
By default `` will try to use native playback via the underlying `
```
### Advanced: type
By default `` will try to figure out the type of media you're trying to play (for example, an HLS/m3u8 media source, an mp4, etc.) based the extension of the file from the `src` attribute's url. This allows `` to determine whether it can/should use an in-code player or native playback. By way of example, the code below has an identifiable "mp4" extension, so `` will rely on native plyaback via the underlying `
```
Sometimes, however, your `src` URL may not have an identifiable extension. In these cases, we recommend relying on the `type` attribute, similar to the `
```
Or, for convenience, we also support the shorthand `type="hls`:
```html
```
### Advanced: Signed URLs and other playback query params
Mux supports a number of query parameters on HLS playback URLs. Most commonly is the `token=` param [used for signed URLs](https://docs.mux.com/guides/video/secure-video-playback).
In order to use `token=` -- or any other query params, pass them through with the `playback-id` attribute:
```
playback-id="DS00Spx1CV902MCtPj5WknGlR102V5HFkDe?token=jwt-signed-token"
```
### Advanced: Use with React+TypeScript
Even though we don't (yet!) have our own `React` version of ``, you can still use it in your `React` app. However, if you're also using TypeScript, make sure you add the following TypeScript definitions, since custom elements (like as ``) will not be recognized as [Intrinsic Elements](https://www.typescriptlang.org/docs/handbook/jsx.html#intrinsic-elements):
```typescript
interface MuxVideoHTMLAttributes extends React.VideoHTMLAttributes {
debug?: boolean;
autoplay?: boolean;
}
declare global {
namespace JSX {
interface IntrinsicElements {
'mux-video': React.DetailedHTMLProps, HTMLVideoElement>;
}
}
}
```
# FAQ
### If I'm using Mux, do I have to use this library?
No, you do not. The way Mux delivers HLS video is compliant with the HLS spec. Any video player that supports HLS will work with Mux Video.
### If I'm not using Mux Video, can I still use this library?
You sure can! Instead of passing in `playback-id=""` attribute, pass in `src=""` with an HLS url. You can still use `env-key=""` to get all the features of Mux Data with your non-Mux video.
# Introduction
`