Подключение API

Подключить YandexAudio API можно следующими способами:

  • как CommonJS-модуль;
  • используя тег <script>.

Подключение API как CommonJS-модуля

Если веб-приложение использует библиотеку Browserify или ее аналоги, то YandexAudio API можно загрузить как npm-пакет:

npm install ya-music-audio

Далее необходимо подключить модуль в клиентском JavaScript-файле:

var YandexAudio = require('ya-music-audio');

В дальнейшем нужно обращаться к объекту YandexAudio. Например: 

// Создание плеера.
var player = new YandexAudio();
Внимание. Несмотря на то что YandexAudio API можно загрузить как npm-пакет, библиотека не предназначена для использования в Node.js-приложениях. На данный момент API работает только в браузерах.

Загрузка API через <script>

Для загрузки API через тег <script> в HEAD-заголовок страницы необходимо добавить строку:

<script src="https://music.yandex.ru/api/audio/dist/index.js"></script>
Примечание.

Загрузить обфусцированную версию API можно по ссылке:

<script src="https://music.yandex.ru/api/audio/dist/index.min.js"></script>

Чтобы в режиме отладки был представлен не обфусцированный код, следует загрузить карту кода: 

<script src="https://music.yandex.ru/api/audio/dist/index.map.json"></script>

После загрузки API все программные сущности (классы, функции) становятся доступными в пространстве имен ya.music. Например: 

// Создание плеера.
var player = new ya.music.Audio();