Download the PHP package jeyroik/extas-alice without Composer
On this page you can find all versions of the php package jeyroik/extas-alice. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package extas-alice
Extas-alice
Библиотека для создания навыков для голосового помощника Алисы от компании Яндекс.
Данная библиотека поддерживает сценарии (см. руководство ниже).
Установка
composer require jeyroik/extas-alice:1.*
Использование
Пример использования библиотеки смотрите в репозитории alice-extas-example
Реализация навыка
- Регистрируем навык в Яндекс.Диалогах (https://dialogs.yandex.ru/developer/).
- Получаем идентификатор навыка (skill_id).
-
Добавялем запись о навыке в extas.json в секцию skills:
-
Добавляем в extas.json шаги, которые потребуются для навыка:
-
Добавляем в extas.json сценарии навыка:
- В схеме доступны два варианта идентификаторов сообщения:
- N, где N - целое число, идентификатор сообщения (см. детали https://yandex.ru/dev/dialogs/alice/doc/protocol-docpage/ описание по message_id)
- Пример: message_1, message_2
- x - для реакции на все сообщения пользователя;
- Пример: message_x
- N, где N - целое число, идентификатор сообщения (см. детали https://yandex.ru/dev/dialogs/alice/doc/protocol-docpage/ описание по message_id)
- В схеме доступны два варианта идентификаторов сообщения:
- При необходимости можно также заранее прописать карточки и кнопки (см. extas.json для примера).
- Устанавливаем навык:
alice-extas# vendor/bin/extas i
- Запускаем навык:
alice-extas# php -S 0.0.0.0:8080 -t resources
- См.
resources/index.php
для примера запуска.
- См.
Использование сценария
- Сценарий состоит из реакций.
- Реакция состоит из проверки условий и имени шага.
- Шаг состоит из имени и описания.
Шаги можно установить предварительно.
Установка шагов
Как видно, шаги не зависят от сценария и могут переиспользоваться. По каждому шагу запускается следующие стадии (события):
- step.<name шага>
- <name сценария>.step.<name шага>
- <name навыка>.<name сценария>.step.<name шага>
Таким образом возможно реализовать как общую логику (и ограничения), так и персонально для каждого сценария и навыка.
Установка сценария
Схема сценария может содержать следующие секции:
message_N
, гдеN
- любое целое число, представляющее идентификатор сообщения (см. документацию по навыкам). Данная секция содержит реакции на конкретное по порядку сообщение.message_x
- данная секция содержит реакции для вариативных по порядку сообщений.
Каждая реакция состоит из
condition
- проверка условия. Если данная реакция должна применяться всегда, поле оставляется пустым, в противном случае здесь указывается имя класса. Класс реакции должен реализовывать метод__invoke(IAliceCall $call)
и возвращатьbool
(true
илиfalse
). Еслиtrue
, то будет запущен соответствующий реакции шаг.step
- имя шага, который нужно запустить, если условия подходят.
All versions of extas-alice with dependencies
jeyroik/extas-base Version 2.*
vlucas/phpdotenv Version *