Revert "removes async_recognize, speech v1 now requires gcs uri" (GoogleCloudPlatform#347)

This reverts commit a93570d.

Author: bshaffer

speech/api/composer.json

@@ -12,6 +12,7 @@
         },
         "files": [
             "src/functions/streaming_recognize.php",
+            "src/functions/transcribe_async.php",
             "src/functions/transcribe_async_gcs.php",
             "src/functions/transcribe_sync.php",
             "src/functions/transcribe_sync_gcs.php"

speech/api/src/TranscribeCommand.php

@@ -17,7 +17,6 @@
 
 namespace Google\Cloud\Samples\Speech;
 
-use LogicException;
 use Symfony\Component\Console\Command\Command;
 use Symfony\Component\Console\Input\InputArgument;
 use Symfony\Component\Console\Input\InputInterface;
@@ -109,7 +108,7 @@ protected function execute(InputInterface $input, OutputInterface $output)
             }
         } else {
             if ($input->getOption('async')) {
-                throw new LogicException('Async requests require a GCS URI');
+                transcribe_async($audioFile, $languageCode, $options);
             }
             if ($input->getOption('stream')) {
                 $encodingInt = constant("google\cloud\speech\\v1\RecognitionConfig\AudioEncoding::$encoding");

speech/api/src/functions/transcribe_async.php

@@ -0,0 +1,70 @@
+
+/**
+ * Copyright 2016 Google Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * For instructions on how to run the full sample:
+ *
+ * @see https://github.com/GoogleCloudPlatform/php-docs-samples/tree/master/speech/api/README.md
+ */
+
+namespace Google\Cloud\Samples\Speech;
+
+use Exception;
+# [START transcribe_async]
+use Google\Cloud\Speech\SpeechClient;
+use Google\Cloud\Core\ExponentialBackoff;
+
+/**
+ * Transcribe an audio file using Google Cloud Speech API
+ * Example:
+ * ```
+ * transcribe_async('/path/to/audiofile.wav');
+ * ```.
+ *
+ * @param string $audioFile path to an audio file.
+ * @param string $languageCode The language of the content to
+ *     be recognized. Accepts BCP-47 (e.g., `"en-US"`, `"es-ES"`).
+ * @param array $options configuration options.
+ *
+ * @return string the text transcription
+ */
+function transcribe_async($audioFile, $languageCode = 'en-US', $options = [])
+{
+    $speech = new SpeechClient([
+        'languageCode' => $languageCode,
+    ]);
+    $operation = $speech->beginRecognizeOperation(
+        fopen($audioFile, 'r'),
+        $options
+    );
+    $backoff = new ExponentialBackoff(10);
+    $backoff->execute(function () use ($operation) {
+        print('Waiting for operation to complete' . PHP_EOL);
+        $operation->reload();
+        if (!$operation->isComplete()) {
+            throw new Exception('Job has not yet completed', 500);
+        }
+    });
+
+    if ($operation->isComplete()) {
+        if (empty($results = $operation->results())) {
+            $results = $operation->info();
+        }
+        print_r($results);
+    }
+}
+# [END transcribe_async]

speech/api/test/TranscribeCommandTest.php

@@ -60,33 +60,14 @@ public function testTranscribe($audioFile, $encoding, $sampleRate, $options = []
         $this->expectOutputRegex("/how old is the Brooklyn Bridge/");
     }
 
-    /**
-     * @expectedException \LogicException
-     * @expectedExceptionMessage Async requests require a GCS URI
-     */
-    public function testTranscribeAsyncThrowsException()
-    {
-        $application = new Application();
-        $application->add(new TranscribeCommand());
-        $commandTester = new CommandTester($application->get('transcribe'));
-        $commandTester->execute(
-            [
-                'audio-file' => __DIR__ . '/data/audio32KHz.raw',
-                '--encoding' => 'LINEAR16',
-                '--sample-rate' => '32000',
-                '--async' => true,
-            ],
-            ['interactive' => false]
-        );
-    }
-
     public function provideTranscribe()
     {
         self::$bucketName = getenv('GOOGLE_BUCKET_NAME');
         return [
             [__DIR__ . '/data/audio32KHz.raw', 'LINEAR16', '32000'],
             [__DIR__ . '/data/audio32KHz.flac', 'FLAC', '32000'],
             [__DIR__ . '/data/audio32KHz.raw', 'LINEAR16', '32000', ['--stream' => true]],
+            [__DIR__ . '/data/audio32KHz.raw', 'LINEAR16', '32000', ['--async' => true]],
             ['gs://' . self::$bucketName . '/audio32KHz.raw', 'LINEAR16', '32000'],
             ['gs://' . self::$bucketName . '/audio32KHz.raw', 'LINEAR16', '32000', ['--async' => true]],
         ];