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

Обязательное свойство.

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

audio_player.item

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

Свойство

Описание

stream

object

Обязательное свойство.

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

metadata

object

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

audio_player.item.stream

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

Свойство

Описание

url

string

Обязательное свойство.

URL аудиопотока.

offset_ms

number

Обязательное свойство.

Временная метка, с которой необходимо проигрывать трек. Чтобы проиграть трек с начала, нужно передать значение 0.

token

string

Обязательное свойство.

Идентификатор потока. Может быть использован для кеширования изображений или для постановки трека в очередь на стороне навыка.

audio_player.item.metadata

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

Свойство

Описание

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 — остановка трека.

Предыдущая
ItemsList
Следующая
start_account_linking