{
    "componentChunkName": "component---src-templates-doc-page-js",
    "path": "/docs/ru/JS_API/built_in_services/reactions/ttsWithVariables/",
    "result": {"data":{"site":{"siteMetadata":{"title":"Gatsby-doc-engine"}},"markdownRemark":{"id":"22df857a-44bb-5737-8812-b95dbc4d2372","excerpt":"$reactions.ttsWithVariables Метод задает аудио и шаблон текста для синтеза речи с переменными.!> В настройках телефонного канала должны быть активны…","html":"<h1>$reactions.ttsWithVariables</h1>\n<hr>\n<p>Метод задает аудио и шаблон текста для <a href=\"/1.11.7/docs/ru/telephony/tts-with-variables/yandex-adaptive\">синтеза речи с переменными</a>.</p>\n<p class='tip'>В <a href=/1.11.7/docs/ru/telephony/recognition_synthesis_settings#yandex-v3  >настройках телефонного канала</a> должны быть активны переключатели <em>Включить Yandex v3</em> и <em>Использовать переменные</em>.\nВ противном случае вызов метода приведет к ошибке.</p>\n<h2>Синтаксис</h2>\n<p>Метод принимает объект с полями <code class=\"language-text\">audioTemplate</code> и <code class=\"language-text\">textTemplate</code>.</p>\n<h3>audioTemplate</h3>\n<p><code class=\"language-text\">audioTemplate</code> — описание аудио, в которое будет вставлена переменная. Содержит поля:</p>\n<ul>\n<li><code class=\"language-text\">audio</code> — ссылка на аудиофайл с шаблоном фразы.</li>\n</ul>\n<p class='tip'>Файл должен быть публично доступен по протоколу HTTP/HTTPS и удовлетворять <a href=https://cloud.yandex.ru/docs/speechkit/tts/brand-voice/income-data-format#recording target=\"_blank\" rel=\"noopener noreferrer\">требованиям, предъявляемым к аудиозаписям</a>.</p>\n<ul>\n<li>\n<p><code class=\"language-text\">textTemplate</code> — описание расшифровки аудиофайла:</p>\n<ul>\n<li><code class=\"language-text\">template</code> — текст шаблона. Переменные должны быть обозначены соответствующими именами в фигурных скобках.</li>\n<li><code class=\"language-text\">textVariables</code> — массив объектов, описывающих использованные переменные. Каждый объект содержит поля:\n<ul>\n<li><code class=\"language-text\">name</code> — название переменной.</li>\n<li><code class=\"language-text\">value</code> — расшифровка переменной, использованной в шаблоне.</li>\n</ul>\n</li>\n</ul>\n</li>\n<li>\n<p><code class=\"language-text\">audioVariables</code> — массив объектов, описывающих расположение переменных в аудиозаписи. Каждый объект содержит поля:</p>\n<ul>\n<li><code class=\"language-text\">name</code> — название переменной.</li>\n<li><code class=\"language-text\">startMs</code> — время от начала аудиозаписи до начала воспроизведения переменной в миллисекундах.</li>\n<li><code class=\"language-text\">lengthMs</code> — длительность воспроизведения переменной в миллисекундах.</li>\n</ul>\n</li>\n</ul>\n<h3>textTemplate</h3>\n<p><code class=\"language-text\">textTemplate</code> — описание фразы, которую должен синтезировать бот в диалоге с клиентом. Содержит поля:</p>\n<ul>\n<li><code class=\"language-text\">template</code> — текст шаблона. Переменные должны быть обозначены соответствующими именами в фигурных скобках.</li>\n<li><code class=\"language-text\">textVariables</code> — массив объектов с переменными, которые должны быть подставлены в шаблон. Каждый объект содержит поля:\n<ul>\n<li><code class=\"language-text\">name</code> — название переменной.</li>\n<li><code class=\"language-text\">value</code> — расшифровка переменной.</li>\n</ul>\n</li>\n</ul>\n<p class='warn'>Структура <code class=\"language-text\">audioTemplate</code> и <code class=\"language-text\">textTemplate</code> повторяет формат <a href=https://cloud.yandex.ru/docs/speechkit/tts/api-ref/grpc/tts_service#AudioTemplate target=\"_blank\" rel=\"noopener noreferrer\"><code class=\"language-text\">AudioTemplate</code></a> и <a href=https://cloud.yandex.ru/docs/speechkit/tts/api-ref/grpc/tts_service#TextTemplate target=\"_blank\" rel=\"noopener noreferrer\"><code class=\"language-text\">TextTemplate</code></a>,\nописанный в документации Yandex SpeechKit.</p>\n<h2>Использование</h2>\n<p>Пример вызова метода из сценария:</p>\n<div class=\"gatsby-highlight\" data-language=\"js\"><pre class=\"language-js\"><code class=\"language-js\">$reactions<span class=\"token punctuation\">.</span><span class=\"token function\">ttsWithVariables</span><span class=\"token punctuation\">(</span><span class=\"token punctuation\">{</span>\n    <span class=\"token string-property property\">\"audioTemplate\"</span><span class=\"token operator\">:</span> <span class=\"token punctuation\">{</span>\n        <span class=\"token string-property property\">\"audio\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"https://mybucket.s3-ap-southeast-1.amazonaws.com/myfilename.wav\"</span><span class=\"token punctuation\">,</span>\n        <span class=\"token string-property property\">\"textTemplate\"</span><span class=\"token operator\">:</span> <span class=\"token punctuation\">{</span>\n            <span class=\"token string-property property\">\"template\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"Вам одобрен кредитный лимит в размере {limit} рублей. Ну что, давайте оформим доставку?\"</span><span class=\"token punctuation\">,</span>\n            <span class=\"token string-property property\">\"textVariables\"</span><span class=\"token operator\">:</span> <span class=\"token punctuation\">[</span>\n                <span class=\"token punctuation\">{</span>\n                    <span class=\"token string-property property\">\"name\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"limit\"</span><span class=\"token punctuation\">,</span>\n                    <span class=\"token string-property property\">\"value\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"сто двух тысяч\"</span>\n                <span class=\"token punctuation\">}</span>\n            <span class=\"token punctuation\">]</span>\n        <span class=\"token punctuation\">}</span><span class=\"token punctuation\">,</span>\n        <span class=\"token string-property property\">\"audioVariables\"</span><span class=\"token operator\">:</span> <span class=\"token punctuation\">[</span>\n            <span class=\"token punctuation\">{</span>\n                <span class=\"token string-property property\">\"name\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"limit\"</span><span class=\"token punctuation\">,</span>\n                <span class=\"token string-property property\">\"startMs\"</span><span class=\"token operator\">:</span> <span class=\"token number\">1850</span><span class=\"token punctuation\">,</span>\n                <span class=\"token string-property property\">\"lengthMs\"</span><span class=\"token operator\">:</span> <span class=\"token number\">1400</span>\n            <span class=\"token punctuation\">}</span>\n        <span class=\"token punctuation\">]</span>\n    <span class=\"token punctuation\">}</span><span class=\"token punctuation\">,</span>\n    <span class=\"token string-property property\">\"textTemplate\"</span><span class=\"token operator\">:</span> <span class=\"token punctuation\">{</span>\n        <span class=\"token string-property property\">\"template\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"Вам одобрен кредитный лимит в размере {limit} рублей. Ну что, давайте оформим доставку?\"</span><span class=\"token punctuation\">,</span>\n        <span class=\"token string-property property\">\"textVariables\"</span><span class=\"token operator\">:</span> <span class=\"token punctuation\">[</span>\n            <span class=\"token punctuation\">{</span>\n                <span class=\"token string-property property\">\"name\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"limit\"</span><span class=\"token punctuation\">,</span>\n                <span class=\"token string-property property\">\"value\"</span><span class=\"token operator\">:</span> <span class=\"token string\">\"пятисот тринадцати тысяч\"</span>\n            <span class=\"token punctuation\">}</span>\n        <span class=\"token punctuation\">]</span>\n    <span class=\"token punctuation\">}</span>\n<span class=\"token punctuation\">}</span><span class=\"token punctuation\">)</span><span class=\"token punctuation\">;</span></code></pre></div>\n<p>В аудиофайле для данного примера в качестве суммы кредитного лимита озвучено число <em>сто двух тысяч</em>.\nВ поле <code class=\"language-text\">audioTemplate</code> передано описание данного аудиофайла с указанием переменной части.</p>\n<p class='warn'>Чтобы улучшить читабельность кода, рекомендуем хранить описания аудио отдельно от места, где вызывается метод, —\nнапример, в <a href=/1.11.7/docs/ru/common/bot_structure/yaml  >YAML-справочнике</a>.</p>\n<p>Поле <code class=\"language-text\">textTemplate</code> содержит описание фразы, которую бот воспроизведет в стейте, где вызван метод.\nНа месте переменной <code class=\"language-text\">limit</code> бот произнесет фразу <em>пятисот тринадцати тысяч</em>.\nВ реальном сценарии расшифровки переменных должны отличаться в зависимости от контекста.</p>","frontmatter":{"title":"","description":null},"headings":[{"value":"$reactions.ttsWithVariables"}]}},"pageContext":{"slug":"/docs/ru/JS_API/built_in_services/reactions/ttsWithVariables/","previous":{"fields":{"slug":"/docs/ru/common/bot_structure/zb_common/car/"},"frontmatter":{"title":"","description":null}},"next":{"fields":{"slug":"/docs/ru/JS_API/built_in_services/reactions/transition/"},"frontmatter":{"title":"","description":null}}}},
    "staticQueryHashes": ["1209419333"]}