Это руководство было обновлено 6 сентября 2019 г. Если вы уже прошли его раньше, вам нужно будет повторить его. Самым большим изменением является то, что теперь вы получаете адаптивную веб-страницу для добавления каналов и станций.

Создайте свой собственный навык Alexa Radio с любимыми потоковыми станциями или аудиокнигами. После развертывания вы можете сказать «Alexa, открой радио», и Alexa начнет потоковую передачу вашей пользовательской станции.

Добавление и удаление ваших станций очень просто благодаря адаптивной веб-странице, которую ваш API будет обслуживать автоматически. Легко добавляйте каналы, которые представляют собой набор станций. Если вы добавляете аудиокнигу, название канала будет Игра престолов, а каждая станция будет отдельными книгами.

Вы можете запросить у Alexa канал или станцию ​​по названию. Если вы скажете «Алекса, попроси радио сыграть блюз», навык сначала будет искать канал с таким названием, а затем станции. Если канал найден, воспроизводится случайная радиостанция с этого канала. Если это аудиокнига, воспроизведение возобновится с того места, где вы остановились в последний раз.

Вы также можете настроить, что будет говорить Alexa, когда вы перейдете к следующей станции или при обнаружении ошибки, используя веб-страницу.

Список возможностей

  • Адаптивная веб-страница для добавления и удаления ваших каналов и станций.
  • Ответы Alexa можно настроить с помощью веб-страницы. Измените то, что говорит навык для «Сейчас играет», «Далее» и т. Д. Меняйте их так часто, как хотите.
  • Поддержка аудиокниг. Если ссылка на поток является файлом MP3, прогресс сохраняется. Если ваш канал содержит несколько файлов MP3, специалист умения автоматически поставит следующий файл в очередь.
  • Модель взаимодействия с Alexa обновлена: теперь используется настраиваемый слот, включен нечеткий поиск. Если ваш канал называется The Hitchhiker’s Guide to the Galaxy, вы можете сказать «Алекса», попроси радио включить guide to the galaxy
  • Вы можете увидеть статус каждой станции на веб-странице, например unplayed, streamable и failed

Посмотрите живую демонстрацию - Alexa Radio

использование

Развернуть его невероятно просто благодаря Стандартной библиотеке. Он включает в себя два шага, частое нажатие кнопок и копирование макаронных изделий.

Шаг 1

Первый шаг - развернуть ваш код в Стандартной библиотеке. Щелкните правой кнопкой мыши кнопку ниже и откройте ссылку для развертывания.

На новой странице нажмите кнопку Создать личность. После этого нажмите кнопку Развернуть проект под ним, чтобы развернуть код.

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

Теперь нажмите кнопку dev, чтобы увидеть все конечные точки вашего проекта.

Запишите второй URL. Он понадобится вам на следующем шаге. Если вам интересно, нажмите на первую ссылку, и вы увидите веб-страницу для добавления и удаления ваших пользовательских станций.

Шаг 2

Перейдите на developer.amazon.com, чтобы создать новый навык Alexa Skill. Если вы еще не зарегистрировались в учетной записи разработчика Amazon, сделайте это сейчас. После входа в систему вы должны увидеть кнопку Создать навык.

Дайте своему умению название, например радио, и выберите язык по умолчанию. Выберите Пользовательский для модели, которую нужно добавить к вашему навыку, и нажмите Создать навык.

На следующем экране выберите Начать с нуля.

Создав навык Alexa Skill, нажмите Редактор JSON в левом нижнем углу. Удалите все внутри него.

Щелкните правой кнопкой мыши и откройте файл AlexaInteractionModel.json в репозитории Github. Скопируйте содержимое файла.

Вернитесь на портал разработчика Alexa и вставьте его в редактор JSON. Нажмите Сохранить модель, чтобы сохранить модель.

имя вызова установлено как radio . Чтобы изменить имя, просто измените значение invocationName в верхней части файла JSON.

Мы почти закончили. Нажмите Конечная точка, чтобы связать развернутый код нашей стандартной библиотеки с навыком Alexa. Введите указанный ранее URL-адрес API стандартной библиотеки.

Ваша конечная точка должна выглядеть как https://[username].api.stdlib.com/alexa-radio@dev/alexa. Убедитесь, что вы выбрали вариант Моя конечная точка разработки является субдоменом домена в раскрывающемся меню.

Затем нажмите Интерфейсы и включите интерфейс Аудиоплеер. Без этого навык работать не будет.

Это все, что вам нужно сделать. На портале разработки Alexa нажмите Build Model. Это может занять пару минут.

Когда появится всплывающее окно с сообщением, что сборка выполнена успешно, нажмите вкладку Тест рядом с Сборкой в консоли разработчика Alexa. Включите тестирование и введите open radio. Вы должны получить ответ с просьбой перейти на веб-страницу, чтобы добавить свои станции.

Если вы получили ответ на консоли, это означает, что навык также активен на вашем устройстве Alexa. Задайте тот же вопрос своему устройству, и вы получите такой же ответ.

Теперь давайте добавим несколько каналов со станциями. Перейдите к основному URL-адресу стандартной библиотеки, который является первым URL-адресом, указанным ниже.

Добавление ваших станций

При нажатии на ссылку выше откроется веб-страница, на которой вы можете добавить каналы и станции, а также настроить ответы Alexa.

Давайте сначала добавим канал. Каналы похожи на плейлисты, основанные на настроении или жанре. В случае аудиокниги это будет название серии книг. Нажмите кнопку Канал, чтобы добавить новый канал.

Откроется модальное окно, в котором вы можете добавить информацию о своем канале. Здесь вы можете добавить несколько станций. Несколько замечаний:

  • URL станции должен начинаться с https
  • Если вы добавляете файлы MP3 как часть аудиокниги, убедитесь, что перемешивание отключено.
  • Зайдите на shoutcast.com, чтобы найти свои любимые радиостанции. Воспользуйтесь ссылкой Любой проигрыватель (.m3u). При необходимости добавьте s для URL-адреса, чтобы это была ссылка https.

  • Попробуйте archive.org, чтобы найти отличные аудиокниги, которые вы можете добавить. Используйте прямую ссылку для скачивания MP3 в качестве URL-адреса станции

После добавления канала нажмите кнопку Сохранить. Вы, конечно, можете добавить больше каналов, если хотите.

Вы также можете переименовать любой из каналов, станций или изменить URL, нажав на них.

Настройка ответов Alexa

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

Используйте SSML, если хотите, чтобы придать ему больше индивидуальности.

Примечания

  • Все URL-адреса потоковой передачи должны быть https.
  • Если URL не сработает, ваш навык скажет stream failed to play. Статус канала на веб-странице будет обновлен до failed. Если игра прошла успешно, в статусе будет указано streamable.
  • Симулятор тестирования на портале Alexa Developer не воспроизводит звук.
  • Любой, кто знает URL вашей станции, может изменить содержимое вашей библиотеки.
  • Чтобы использовать навык, не нужно публиковать его.

Если вы где-то застряли, или если у вас есть обратная связь, напишите мне. Вы можете найти репозиторий кода здесь.