Управляемые голосом PHP-приложения с API.ai

 function  send (){ 
     var  text =  $ ( "#query" ). val (); $ . post ( 
         'http://localhost/tester/api-ai/time.php' , 
         { 
             'query' :  text }, 
         function ( response ){ responsiveVoice . speak ( response ); $ ( '#response' ). text ( response ); 
         } 
     ); 
 } 

Конвертер валют

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

Сначала создайте нового агента и назовите его CurrencyConverter .

Под этим агентом создайте новый объект и назовите его currency . Это будет представлять различные валюты, которые мы можем конвертировать. Определите несколько валют, которые мы можем использовать для тестирования, и нажмите «Сохранить».

Затем создайте новое намерение и назовите его convertMoney .

На приведенном выше снимке экрана видно, что мы добавили следующее в разделе «пользователь говорит»:

 @sys . number : number @currency : fromCurrency to @currency : toCurrency convert @sys . number : number @currency : fromCurrency to @currency : toCurrency how much is   @sys . number : number @currency : fromCurrency in   @currency : toCurrency ? 

В разделе «пользователь говорит» мы определяем примеры того, что пользователь может сказать, чтобы вызвать это конкретное намерение. Здесь мы используем сущности в качестве заменителей реальных значений, которые может использовать пользователь. @sys.number может относиться к любому номеру. @currency может ссылаться на любую валюту, которую мы добавили ранее, когда создавали сущность валюты. Использование двоеточия после объекта позволяет нам присвоить ему псевдоним. Этот псевдоним затем может быть использован для получения значения, используемого пользователем в коде.

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

В разделе «Выполнение» мы определяем шаблон для речи, которую мы хотим вывести после использования намерения. Например, мы можем поставить следующее:

 $number $fromCurrency is  equivalent to $result $toCurrency 

Затем он будет доступен для элемента speech в результате, который мы получим. Оттуда мы можем выполнить замену строки, чтобы заменить эти переменные фактическими значениями, которые мы получаем. Но давайте оставим это поле пустым для этого приложения.

Когда вы закончите, нажмите кнопку «Сохранить», чтобы сохранить намерение.

Теперь мы готовы приступить к коду. Создайте файл exchange-rate.php в вашем рабочем каталоге, затем добавьте следующий код:

 <? php require   'vendor/autoload.php' ; 

 use   GuzzleHttp \Client ; $client =   new   Client (); $apiai_key =   'YOUR_API_AI_AGENT_DEVELOPER_ACCESS_TOKEN' ; $apiai_subscription_key =   'YOUR_API_AI_SUBSCRIPTION_KEY' ; $currencylayer_apikey =   'YOUR_CURRENCYLAYER_API_KEY' ; $query =  $_POST [ 'query' ]; $response =  $client -> post ( 'https://api.api.ai/v1/query' ,  array ( 
     'headers'   =>  array ( 
         'Authorization'   =>   "Bearer {$apiai_key}" , 
         'ocp-apim-subscription-key'   =>  $apiai_subscription_key , 
         'Content-Type'   =>   'application/json; charset=utf-8' 
     ), 
     'json'   =>  array ( 
         "query"   =>  $query , 
         "lang"   =>   "en" 
     ) 
 )); $result =  $response -> json (); 

Как видно из приведенного выше кода, он в основном такой же, как мы делали ранее в нашем предыдущем приложении. Только на этот раз мы добавили переменную $currencylayer_apikey . Здесь хранится ключ API, который мы получили от currencylayer.com , API, который позволяет нам получать текущий курс обмена от одной валюты к другой. Если вы хотите продолжить, зарегистрируйтесь и получите ключ API .

Затем мы проверяем, есть ли какие-либо результаты, и извлекаем данные, которые нам нужны. В этом случае нам нужно получить валюту, которую пользователь желает конвертировать, валюту, в которую он будет конвертироваться, а затем сумму.

 if (! empty ( $result [ 'result' ])){ $currency_from =  $result [ 'result' ][ 'parameters' ][ 'fromcurrency' ]; $currency_to =  $result [ 'result' ][ 'parameters' ][ 'tocurrency' ]; $amount =  $result [ 'result' ][ 'parameters' ][ 'number' ]; 
 } 

Затем мы делаем запрос в API и извлекаем курс обмена из результатов:

 $conversion_response =  $client -> get ( "http://apilayer.net/api/live?access_key={$currencylayer_apikey}&source={$currency_from}&currencies={$currency_to}" ); $conversion_result =  $conversion_response -> json (); $rate =  $conversion_result [ 'quotes' ][ $currency_from .  $currency_to ]; 

Результаты, которые мы получаем от API, выглядят так:

 Array 
 ( 
     [ success ]   =>   1 
     [ terms ]   =>  https : //currencylayer.com/terms 
     [ privacy ]   =>  https : //currencylayer.com/privacy 
     [ timestamp ]   =>   1440296829 
     [ source ]   =>  USD [ quotes ]   =>   Array 
         ( 
             [ USDPHP ]   =>   46.655499 
         ) 

 ) 

Теперь, когда у нас есть текущий обменный курс, все, что нам нужно сделать сейчас, это умножить курс на сумму, предоставленную пользователем, и затем вывести результат.

 $converted_amount =  $amount *  $rate ; $speech =   "{$amount} {$currency_from} is equivalent to {$converted_amount} {$currency_to}" ; echo $speech ; 

На стороне клиента мы все еще используем тот же HTML и файлы, которые мы использовали ранее в нашем первом приложении. Вы можете пойти дальше и поместить те же файлы в свой рабочий каталог, если вы следуете.

 <!DOCTYPE html> 
 <html   lang = "en" > 
 <head> 
     <meta   charset = "UTF-8" > 
     <title> exchange rate </title> 
     <link   rel = "stylesheet"   href = "style.css" > 
     <script   src = "http://cdnjs.cloudflare.com/ajax/libs/jquery/2.1.4/jquery.min.js" ></script> 
     <script   src = "responsive-voice.js" ></script> 
 </head> 
 <body> 
     <div> 
         <input   type = "text"   id = "query"   name = "query" >   <button   id = "rec" > Speak </button> 
     </div> 
     <div   id = "response" ></div> 
     <script   src = "speech-recognition.js" ></script> 
     <script   src = "main.js" ></script> 
 </body> 
 </html> 

Единственное отличие — это URL, на который мы отправляем запрос. Укажите, где находится ваш exchange-rate.php :

 function  send (){ 
     var  text =  $ ( "#query" ). val (); $ . post ( 
         'http://localhost/tester/api-ai/exchange-rate.php' , 
         { 
             'query' :  text }, 
         function ( response ){ responsiveVoice . speak ( response ); $ ( '#response' ). text ( response ); 
         } 
     ); 
 } 

Вывод

В этом уроке мы узнали, как использовать Api.ai для создания голосовых приложений PHP. Поддержка браузеров все еще довольно ограничена, потому что Web Speech API все еще не получил широкого применения. Но Api.ai поддерживает другие платформы, кроме Интернета. Android, Cordova, .Net, iOS — несколько примеров. Это означает, что мы можем использовать Api.ai, не беспокоясь о поддержке на этих платформах. Не забудьте проверить их документы, если вы хотите узнать больше. Файлы, которые мы использовали в этом руководстве, доступны в этом репозитории Github .