---
title: Fliplet.Media.Audio.Player
description: "Embed an audio player UI in a screen by tagging HTML elements with audio URLs; the framework auto-initializes players on screen load."
type: api-reference
tags: [js-api, audio, player]
v3_relevant: true
deprecated: false
exclude_from_v3_catalog: true
---
# `Fliplet.Media.Audio.Player`

Embed an audio player UI in a screen by tagging HTML elements with audio URLs; the framework auto-initializes players on screen load.

## Install

Add the `fliplet-audio-player` dependency to your screen or app dependencies.

## Usage

Add the following HTML to your screen.

```html
<div data-title="The title of your audio file" data-audio-url="https://path/to/file.mp3"></div>
```

The HTML tag will be automatically detected by the framework on screen load and the audio player UI will be initialized.

If you need to add more tags at runtime, simply run `Fliplet.Media.Audio.Player.init()` to convert any new tag into an audio player.

## Attributes

* `data-audio-url` (Required) URL to the audio file
* `data-title` Add a title to the bottom of the audio player UI
* `data-disable-download` Users can download and cache the audio file on their devices for native apps. To disable the file download, add the `data-disable-download` attribute to the HTML tag.

---

[Back to API documentation](../API-Documentation)
{: .buttons}