Добавление звуков в приложение

Обновлено 15 декабря 2023

Code

Graph

SmartApp API

Звуки в приложениях воспроизводятся ассистентом и помогают разнообразить опыт пользователей.

Вы можете загружать собственные звуки или использовать звуки из библиотеки.

К загружаемым звукам предъявляются следующие требования:

• формат wav;
• 1 канал (моно);
• кодирование 16-bit (PCM) LE signed, с заголовком;
• частота дискретизации 24 кГц;
• размер файла не более 10 Мб.

Для добавления звуков в приложение, разработанное в Graph, используйте блок Аудио.

Добавление звуков с помощью Code

Чтобы добавить звуки в приложение с помощью Code:

1. Загрузите необходимые звуки в раздел Контент редактора кода.

После загрузки звук начинает интегрироваться в приложение в фоновом режиме. В редких случаях интеграция занимает длительное время, это не зависит от размера аудио-файла.

2. Скопируйте адрес звука по ссылке Скопируйте URL файла.

3. С помощью тега audio: добавьте звук в необходимое место сценария:

   Чтобы воспроизвести звук из загруженного файла, укажите его адрес и источник user. Для каждого звука вы можете задать необязательный параметр name.

   state: Hello
       q!: hi
       a: hi
       audio: https://sberdevices2.s3pd01.sbercloud.ru/preprod-botadmin/263/264/audio/ovDnhCDSVZmHeWrw.wav || name = "sample.wav", source  = "user"

   Чтобы воспроизвести звук из библиотеки файла, укажите название звука и источник library (название звукового файла указано в библиотеке):

   state: Hello
       q!: hi
       a: hi
       audio: sm-sounds-human-cheer-1 || name = "Аплодисменты", source  = "library"

   Чтобы ассистент выбрал звук случайным образом, используйте тег random::

```sc
state: Hello
    q!: hi
    random:
    audio: sm-sounds-human-cheer-1 || name = "Аплодисменты", source  = "library"
    audio: https://sberdevices2.s3pd01.sbercloud.ru/preprod-botadmin/263/264/audio/     ovDnhCDSVZmHeWrw.wav || name = "002_Бумажная версия книги — копия.wav", source  = "user"
```

Добавление звуков с помощью SmartApp API

Используйте разметку синтеза речи, чтобы добавлять собственные звуки в приложения, созданные с помощью SmartApp API.

Чтобы добавить звуки в приложение с помощью Code:

1. Создайте проект Code.
2. Загрузите необходимые звуки в раздел Редактор → Контент.

После загрузки звук начинает интегрироваться в приложение в фоновом режиме. В редких случаях интеграция занимает длительное время, это не зависит от размера аудио-файла.

3. Скопируйте адрес звука по ссылке Скопируйте URL файла.

4. В поле pronounceText ответа ANSWER_TO_USER добавьте тег audio с адресом звука:

   <speak><audio text="sm:example/example/filename.wav"/></speak>

5. В поле pronounceTextType укажите значение application/ssml.

Пример:

{
    "messageName": "ANSWER_TO_USER",
    "sessionId": "...",
    "messageId": ...,
    "uuid": {...},
    "payload": {
        "pronounceText": "<speak><audio text='sm:/25664/25665/audio/xTxeMSHzX1u9j3EM.wav'/></speak>",
        "pronounceTextType": "application/ssml",
        "emotion": {
            "emotionId": "oups"
        },
        "items": [
            {
                "bubble": {
                    "text": "Привет!"
                }
            }
        ],
        "intent": "hi",
        "projectName": "hello",
        "device": {
            "platformType": "android",
            "platformVersion": "1.0.2",
            "surface": "COMPANION",
            "surfaceVersion": "1.0.2",
            "features": {
                "appTypes": ["DIALOG", "WEB_APP"]
            },
            "capabilities": {
                "screen": { "available": true },
                "mic": { "available": true },
                "speak": { "available": true }
            },
            "additionalInfo": {}
        }
    }
}