audio_player

Внимание. Чтобы начать проигрывание трека без ожидания запроса пользователя, перед описанием директивы укажите "should_listen": false.

Директива audio_player позволяет управлять плеером.

Команда Play начинает проигрывание композиции и содержит свойства аудиопотока. Команда Stop только останавливает воспроизведение.

В ответе навык передает свойство response.directives.audio_player.

Команда Play

Пример ответа навыка для начала проигрывания:

{
    "response": {
        "text": "вот хорошая песня",
        "tts": "вот хорошая песня",
        "end_session": false,
        "should_listen": false,
        "directives": {
            "audio_player": {
                "action": "Play",
                "item": {
                    "stream": {
                        "url": "https://example.com/stream-audio-url",
                        "offset_ms": 0,
                        "token": "token"
                    },
                    "metadata": {
                        "title": "Песня",
                        "sub_title": "Артист",
                        "art": {
                            "url": "https://example.com/art.png"
                        },
                        "background_image": {
                            "url": "https://example.com/background-image.png"
                       }
                    }
                }
            }
        }
    },
    "version": "1.0"
}

audio_player

Директива управления плеером.


Свойство	Описание
`action`	string Обязательное свойство. Команда директиве. `Play` — проигрывание трека, начинается сразу после отправки директивы. Проигрывание текущего трека приостанавливается.
`item`	object Обязательное свойство. Описание трека и аудиопотока.


Свойство	Описание
`action`	string Обязательное свойство. Команда директиве. `Play` — проигрывание трека, начинается сразу после отправки директивы. Проигрывание текущего трека приостанавливается.
`item`	object Обязательное свойство. Описание трека и аудиопотока.

audio_player.item

Описание трека и аудиопотока.


Свойство	Описание
`stream`	object Обязательное свойство. Описание аудиопотока.
`metadata`	object Метаданные проигрываемого трека.


Свойство	Описание
`stream`	object Обязательное свойство. Описание аудиопотока.
`metadata`	object Метаданные проигрываемого трека.

audio_player.item.stream

Описание аудиопотока.


Свойство	Описание
`url`	string Обязательное свойство. URL аудиопотока.
`offset_ms`	number Обязательное свойство. Временная метка, с которой необходимо проигрывать трек. Чтобы проиграть трек с начала, нужно передать значение `0`.
`token`	string Обязательное свойство. Идентификатор потока. Может быть использован для кеширования изображений или для постановки трека в очередь на стороне навыка.


Свойство	Описание
`url`	string Обязательное свойство. URL аудиопотока.
`offset_ms`	number Обязательное свойство. Временная метка, с которой необходимо проигрывать трек. Чтобы проиграть трек с начала, нужно передать значение `0`.
`token`	string Обязательное свойство. Идентификатор потока. Может быть использован для кеширования изображений или для постановки трека в очередь на стороне навыка.

audio_player.item.metadata

Метаданные проигрываемого трека.


Свойство	Описание
`title`	string Описание трека. Например, название композиции.
`sub_title`	string Дополнительное описание трека. Например, имя артиста.
`art`	object Обложка альбома трека.
`background_image`	object Фоновое изображение.


Свойство	Описание
`title`	string Описание трека. Например, название композиции.
`sub_title`	string Дополнительное описание трека. Например, имя артиста.
`art`	object Обложка альбома трека.
`background_image`	object Фоновое изображение.

audio_player.item.metadata.art

Обложка альбома трека.


Свойство	Описание
`url`	string URL обложки альбома.

audio_player.item.metadata.background_image

Фоновое изображение.


Свойство	Описание
`url`	string URL фонового изображения.

Команда Stop

Пример ответа навыка для остановки проигрывания:

{
    "audio_player": {
        "action": "Stop"
    }
}

audio_player

Директива управления плеером.


Свойство	Описание
`action`	string Обязательное свойство. Команда директиве. `Stop` — остановка трека.