feat: adds a new multi region sample (GoogleCloudPlatform#1246)

Author: b-loved-dreamer

speech/src/multi_region_gcs.php

@@ -0,0 +1,60 @@
+<?php
+/**
+ * Copyright 2021 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.
+ */
+
+# [START speech_transcribe_with_multi_region_gcs]
+# Includes the autoloader for libraries installed with composer
+require __DIR__ . '/../vendor/autoload.php';
+
+# Imports the Google Cloud client library
+use Google\Cloud\Speech\V1\SpeechClient;
+use Google\Cloud\Speech\V1\RecognitionAudio;
+use Google\Cloud\Speech\V1\RecognitionConfig;
+use Google\Cloud\Speech\V1\RecognitionConfig\AudioEncoding;
+
+# The name of the audio file to transcribe
+$gcsURI = "gs://cloud-samples-data/speech/brooklyn_bridge.raw";
+
+# set string as audio content
+$audio = (new RecognitionAudio())
+    ->setUri($gcsURI);
+
+# The audio file's encoding, sample rate and language
+$config = new RecognitionConfig([
+    'encoding' => AudioEncoding::LINEAR16,
+    'sample_rate_hertz' => 16000,
+    'language_code' => 'en-US'
+]);
+
+# Specify a new endpoint.
+$options = ['apiEndpoint' => 'eu-speech.googleapis.com'];
+
+# Instantiates a client
+$client = new SpeechClient($options);
+
+# Detects speech in the audio file
+$response = $client->recognize($config, $audio);
+
+# Print most likely transcription
+foreach ($response->getResults() as $result) {
+    $alternatives = $result->getAlternatives();
+    $mostLikely = $alternatives[0];
+    $transcript = $mostLikely->getTranscript();
+    printf('Transcript: %s' . PHP_EOL, $transcript);
+}
+
+$client->close();
+# [END speech_transcribe_with_multi_region_gcs]

speech/src/profanity_filter.php

@@ -12,7 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# [START profanity_filter]
+# [START speech_profanity_filter]
 
 # Includes the autoloader for libraries installed with composer
 require __DIR__ . '/../vendor/autoload.php';
@@ -64,4 +64,4 @@
 
 $client->close();
 
-# [END profanity_filter]
+# [END speech_profanity_filter]

speech/src/profanity_filter_gcs.php

@@ -12,7 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-# [START profanity_filter_gcs]
+# [START speech_profanity_filter_gcs]
 # Includes the autoloader for libraries installed with composer
 require __DIR__ . '/../vendor/autoload.php';
 
@@ -63,4 +63,4 @@
 
 $client->close();
 
-# [END profanity_filter_gcs]
+# [END speech_profanity_filter_gcs]

speech/test/speechTest.php

@@ -76,7 +76,7 @@ public function testTranscribe($command, $audioFile, $requireGrpc = false)
         if ($requireGrpc && !extension_loaded('grpc')) {
             self::markTestSkipped('Must enable grpc extension.');
         }
-        if (!self::$bucketName && in_array($command, ['transcribe_gcs', 'transcribe_async_gcs', 'profanity_filter_gcs'])) {
+        if (!self::$bucketName && '_gcs' == substr($command, -4)) {
             $this->requireEnv('GOOGLE_STORAGE_BUCKET');
         }
         $output = $this->runSnippet($command, [$audioFile]);
@@ -99,6 +99,7 @@ public function provideTranscribe()
             ['transcribe_async_gcs', 'gs://' . self::$bucketName . '/speech/audio32KHz.raw'],
             ['transcribe_async_words', __DIR__ . '/data/audio32KHz.raw'],
             ['profanity_filter_gcs', 'gs://' . self::$bucketName . '/speech/audio32KHz.raw'],
+            ['multi_region_gcs', 'gs://' . self::$bucketName . '/speech/audio32KHz.raw'],
             ['profanity_filter', __DIR__ . '/data/audio32KHz.raw'],
             ['streaming_recognize', __DIR__ . '/data/audio32KHz.raw', true],
         ];