google-cloud-speech 0.29.0 → 0.30.0

data/lib/google/cloud/speech/convert.rb

@@ -1,46 +0,0 @@
-# Copyright 2017 Google LLC
-#
-# 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
-#
-#     https://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.
-
-
-require "google/protobuf/duration_pb"
-
-module Google
-  module Cloud
-    module Speech
-      ##
-      # @private Helper module for converting Speech values.
-      module Convert
-        module ClassMethods
-          def number_to_duration number
-            return nil if number.nil?
-
-            Google::Protobuf::Duration.new \
-              seconds: number.to_i,
-              nanos: (number.remainder(1) * 1000000000).round
-          end
-
-          def duration_to_number duration
-            return nil if duration.nil?
-
-            return duration.seconds if duration.nanos.zero?
-
-            duration.seconds + (duration.nanos / 1000000000.0)
-          end
-        end
-
-        extend ClassMethods
-      end
-    end
-  end
-end

data/lib/google/cloud/speech/credentials.rb

@@ -1,57 +0,0 @@
-# Copyright 2016 Google LLC
-#
-# 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
-#
-#     https://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.
-
-
-require "googleauth"
-
-module Google
-  module Cloud
-    module Speech
-      ##
-      # # Credentials
-      #
-      # Represents the authentication and authorization used to connect to the
-      # Speech API.
-      #
-      # @example
-      #   require "google/cloud/speech"
-      #
-      #   keyfile = "/path/to/keyfile.json"
-      #   creds = Google::Cloud::Speech::Credentials.new keyfile
-      #
-      #   speech = Google::Cloud::Speech.new(
-      #     project_id: "my-project",
-      #     credentials: creds
-      #   )
-      #
-      #   speech.project_id #=> "my-project"
-      #
-      class Credentials < Google::Auth::Credentials
-        SCOPE = ["https://www.googleapis.com/auth/cloud-platform"].freeze
-        PATH_ENV_VARS = %w[SPEECH_CREDENTIALS
-                           SPEECH_KEYFILE
-                           GOOGLE_CLOUD_CREDENTIALS
-                           GOOGLE_CLOUD_KEYFILE
-                           GCLOUD_KEYFILE].freeze
-        JSON_ENV_VARS = %w[SPEECH_CREDENTIALS_JSON
-                           SPEECH_KEYFILE_JSON
-                           GOOGLE_CLOUD_CREDENTIALS_JSON
-                           GOOGLE_CLOUD_KEYFILE_JSON
-                           GCLOUD_KEYFILE_JSON].freeze
-        DEFAULT_PATHS = \
-          ["~/.config/gcloud/application_default_credentials.json"].freeze
-      end
-    end
-  end
-end

data/lib/google/cloud/speech/operation.rb

@@ -1,262 +0,0 @@
-# Copyright 2016 Google LLC
-#
-# 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
-#
-#     https://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.
-
-
-require "google/cloud/speech/v1"
-require "google/cloud/errors"
-
-module Google
-  module Cloud
-    module Speech
-      ##
-      # # Operation
-      #
-      # A resource represents the long-running, asynchronous processing of a
-      # speech-recognition operation. The op can be refreshed to retrieve
-      # recognition results once the audio data has been processed.
-      #
-      # See {Project#process} and {Audio#process}.
-      #
-      # @see https://cloud.google.com/speech/docs/basics#async-responses
-      #   Asynchronous Speech API Responses
-      # @see https://cloud.google.com/speech/reference/rpc/google.longrunning#google.longrunning.Operations
-      #   Long-running Operation
-      #
-      # @example
-      #   require "google/cloud/speech"
-      #
-      #   speech = Google::Cloud::Speech.new
-      #
-      #   op = speech.process "path/to/audio.raw",
-      #                       encoding: :linear16,
-      #                       language: "en-US",
-      #                       sample_rate: 16000
-      #
-      #   op.done? #=> false
-      #   op.reload! # API call
-      #   op.done? #=> true
-      #   results = op.results
-      #
-      class Operation
-        ##
-        # @private The Google::Gax::Operation gRPC object.
-        attr_accessor :grpc
-
-        ##
-        # @private Creates a new Job instance.
-        def initialize
-          @grpc = nil
-        end
-
-        ##
-        # The unique identifier for the long running operation.
-        #
-        # @return [String] The unique identifier for the long running operation.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   op = speech.process "path/to/audio.raw",
-        #                       encoding: :linear16,
-        #                       language: "en-US",
-        #                       sample_rate: 16000
-        #
-        #   op.id #=> "1234567890"
-        #
-        def id
-          @grpc.name
-        end
-
-        ##
-        # Checks if the speech-recognition processing of the audio data is
-        # complete.
-        #
-        # @return [boolean] `true` when complete, `false` otherwise.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   op = speech.process "path/to/audio.raw",
-        #                       encoding: :linear16,
-        #                       language: "en-US",
-        #                       sample_rate: 16000
-        #
-        #   op.done? #=> false
-        #
-        def done?
-          @grpc.done?
-        end
-
-        ##
-        # A speech recognition result corresponding to a portion of the audio.
-        #
-        # @return [Array<Result>] The transcribed text of audio recognized. If
-        #   the op is not done this will return `nil`.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   op = speech.process "path/to/audio.raw",
-        #                       encoding: :linear16,
-        #                       language: "en-US",
-        #                       sample_rate: 16000
-        #
-        #   op.done? #=> true
-        #   op.results? #=> true
-        #   results = op.results
-        #
-        def results
-          return nil unless results?
-          @grpc.response.results.map do |result_grpc|
-            Result.from_grpc result_grpc
-          end
-        end
-
-        ##
-        # Checks if the speech-recognition processing of the audio data is
-        # complete.
-        #
-        # @return [boolean] `true` when complete, `false` otherwise.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   op = speech.process "path/to/audio.raw",
-        #                       encoding: :linear16,
-        #                       language: "en-US",
-        #                       sample_rate: 16000
-        #
-        #   op.done? #=> true
-        #   op.results? #=> true
-        #   results = op.results
-        #
-        def results?
-          @grpc.response?
-        end
-
-        ##
-        # The error information if the speech-recognition processing of the
-        # audio data has returned an error.
-        #
-        # @return [Google::Cloud::Error] The error.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   op = speech.process "path/to/audio.raw",
-        #                       encoding: :linear16,
-        #                       language: "en-US",
-        #                       sample_rate: 16000
-        #
-        #   op.done? #=> true
-        #   op.error? #=> true
-        #   error = op.error
-        #
-        def error
-          return nil unless error?
-          Google::Cloud::Error.from_error @grpc.error
-        end
-
-        ##
-        # Checks if the speech-recognition processing of the audio data has
-        # returned an error.
-        #
-        # @return [boolean] `true` when errored, `false` otherwise.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   op = speech.process "path/to/audio.raw",
-        #                       encoding: :linear16,
-        #                       language: "en-US",
-        #                       sample_rate: 16000
-        #
-        #   op.done? #=> true
-        #   op.error? #=> true
-        #   error = op.error
-        #
-        def error?
-          @grpc.error?
-        end
-
-        ##
-        # Reloads the op with current data from the long-running, asynchronous
-        # processing of a speech-recognition operation.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   op = speech.process "path/to/audio.raw",
-        #                       encoding: :linear16,
-        #                       language: "en-US",
-        #                       sample_rate: 16000
-        #
-        #   op.done? #=> false
-        #   op.reload! # API call
-        #   op.done? #=> true
-        #
-        def reload!
-          @grpc.reload!
-          self
-        end
-        alias refresh! reload!
-
-        ##
-        # Reloads the op until the operation is complete. The delay between
-        # reloads will incrementally increase.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   op = speech.process "path/to/audio.raw",
-        #                       encoding: :linear16,
-        #                       language: "en-US",
-        #                       sample_rate: 16000
-        #
-        #   op.done? #=> false
-        #   op.wait_until_done!
-        #   op.done? #=> true
-        #
-        def wait_until_done!
-          @grpc.wait_until_done!
-        end
-
-        ##
-        # @private New Result::Job from a Google::Gax::Operation
-        # object.
-        def self.from_grpc grpc
-          new.tap do |job|
-            job.instance_variable_set :@grpc, grpc
-          end
-        end
-      end
-    end
-  end
-end

data/lib/google/cloud/speech/project.rb

@@ -1,651 +0,0 @@
-# Copyright 2016 Google LLC
-#
-# 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
-#
-#     https://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.
-
-
-require "google/cloud/errors"
-require "google/cloud/speech/service"
-require "google/cloud/speech/audio"
-require "google/cloud/speech/result"
-require "google/cloud/speech/operation"
-require "google/cloud/speech/stream"
-
-module Google
-  module Cloud
-    module Speech
-      ##
-      # # Project
-      #
-      # The Google Cloud Speech API enables developers to convert audio to text
-      # by applying powerful neural network models. The API recognizes over 80
-      # languages and variants, to support your global user base. You can
-      # transcribe the text of users dictating to an application's microphone,
-      # enable command-and-control through voice, or transcribe audio files,
-      # among many other use cases. Recognize audio uploaded in the request, and
-      # integrate with your audio storage on Google Cloud Storage, by using the
-      # same technology Google uses to power its own products.
-      #
-      # See {Google::Cloud#speech}
-      #
-      # @example
-      #   require "google/cloud/speech"
-      #
-      #   speech = Google::Cloud::Speech.new
-      #
-      #   audio = speech.audio "path/to/audio.raw",
-      #                        encoding: :linear16,
-      #                        language: "en-US",
-      #                        sample_rate: 16000
-      #   results = audio.recognize
-      #
-      #   result = results.first
-      #   result.transcript #=> "how old is the Brooklyn Bridge"
-      #   result.confidence #=> 0.9826789498329163
-      #
-      class Project
-        ##
-        # @private The gRPC Service object.
-        attr_accessor :service
-
-        ##
-        # @private Creates a new Speech Project instance.
-        def initialize service
-          @service = service
-        end
-
-        # The Speech project connected to.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new(
-        #     project_id: "my-project",
-        #     credentials: "/path/to/keyfile.json"
-        #   )
-        #
-        #   speech.project_id #=> "my-project"
-        #
-        def project_id
-          service.project
-        end
-        alias project project_id
-
-        ##
-        # Returns a new Audio instance from the given source. No API call is
-        # made.
-        #
-        # @see https://cloud.google.com/speech/docs/basics#audio-encodings
-        #   Audio Encodings
-        # @see https://cloud.google.com/speech/docs/basics#sample-rates
-        #   Sample Rates
-        # @see https://cloud.google.com/speech/docs/basics#languages
-        #   Languages
-        #
-        # @param [String, IO, Google::Cloud::Storage::File] source A string of
-        #   the path to the audio file to be recognized, or a File or other IO
-        #   object of the audio contents, or a Cloud Storage URI of the form
-        #   `"gs://bucketname/path/to/document.ext"`; or an instance of
-        #   Google::Cloud::Storage::File of the text to be annotated.
-        # @param [String, Symbol] encoding Encoding of audio data to be
-        #   recognized. Optional.
-        #
-        #   Acceptable values are:
-        #
-        #   * `linear16` - Uncompressed 16-bit signed little-endian samples.
-        #     (LINEAR16)
-        #   * `flac` - The [Free Lossless Audio
-        #     Codec](http://flac.sourceforge.net/documentation.html) encoding.
-        #     Only 16-bit samples are supported. Not all fields in STREAMINFO
-        #     are supported. (FLAC)
-        #   * `mulaw` - 8-bit samples that compand 14-bit audio samples using
-        #     G.711 PCMU/mu-law. (MULAW)
-        #   * `amr` - Adaptive Multi-Rate Narrowband codec. (`sample_rate` must
-        #     be 8000 Hz.) (AMR)
-        #   * `amr_wb` - Adaptive Multi-Rate Wideband codec. (`sample_rate` must
-        #     be 16000 Hz.) (AMR_WB)
-        #   * `ogg_opus` - Ogg Mapping for Opus. (OGG_OPUS)
-        #
-        #     Lossy codecs do not recommend, as they result in a lower-quality
-        #     speech transcription.
-        #   * `speex` - Speex with header byte. (SPEEX_WITH_HEADER_BYTE)
-        #
-        #     Lossy codecs do not recommend, as they result in a lower-quality
-        #     speech transcription. If you must use a low-bitrate encoder,
-        #     OGG_OPUS is preferred.
-        #
-        # @param [String,Symbol] language The language of the supplied audio as
-        #   a [BCP-47](https://tools.ietf.org/html/bcp47) language code. e.g.
-        #   "en-US" for English (United States), "en-GB" for English (United
-        #   Kingdom), "fr-FR" for French (France). See [Language
-        #   Support](https://cloud.google.com/speech/docs/languages) for a list
-        #   of the currently supported language codes. Optional.
-        # @param [Integer] sample_rate Sample rate in Hertz of the audio data
-        #   to be recognized. Valid values are: 8000-48000. 16000 is optimal.
-        #   For best results, set the sampling rate of the audio source to 16000
-        #   Hz. If that's not possible, use the native sample rate of the audio
-        #   source (instead of re-sampling). Optional.
-        #
-        # @return [Audio] The audio file to be recognized.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   audio = speech.audio "path/to/audio.raw",
-        #                        encoding: :linear16,
-        #                        language: "en-US",
-        #                        sample_rate: 16000
-        #
-        # @example With a Google Cloud Storage URI:
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   audio = speech.audio "gs://bucket-name/path/to/audio.raw",
-        #                        encoding: :linear16,
-        #                        language: "en-US",
-        #                        sample_rate: 16000
-        #
-        # @example With a Google Cloud Storage File object:
-        #   require "google/cloud/storage"
-        #
-        #   storage = Google::Cloud::Storage.new
-        #
-        #   bucket = storage.bucket "bucket-name"
-        #   file = bucket.file "path/to/audio.raw"
-        #
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   audio = speech.audio file,
-        #                        encoding: :linear16,
-        #                        language: "en-US",
-        #                        sample_rate: 16000
-        #
-        def audio source, encoding: nil, language: nil, sample_rate: nil
-          audio = if source.is_a? Audio
-                    source.dup
-                  else
-                    Audio.from_source source, self
-                  end
-          audio.encoding = encoding unless encoding.nil?
-          audio.language = language unless language.nil?
-          audio.sample_rate = sample_rate unless sample_rate.nil?
-          audio
-        end
-
-        ##
-        # Performs synchronous speech recognition. Sends audio data to the
-        # Speech API, which performs recognition on that data, and returns
-        # results only after all audio has been processed. Limited to audio data
-        # of 1 minute or less in duration.
-        #
-        # The Speech API will take roughly the same amount of time to process
-        # audio data sent synchronously as the duration of the supplied audio
-        # data. That is, if you send audio data of 30 seconds in length, expect
-        # the synchronous request to take approximately 30 seconds to return
-        # results.
-        #
-        # @see https://cloud.google.com/speech/docs/basics#synchronous-recognition
-        #   Synchronous Speech API Recognition
-        # @see https://cloud.google.com/speech/docs/basics#phrase-hints
-        #   Phrase Hints
-        #
-        # @param [String, IO, Google::Cloud::Storage::File] source A string of
-        #   the path to the audio file to be recognized, or a File or other IO
-        #   object of the audio contents, or a Cloud Storage URI of the form
-        #   `"gs://bucketname/path/to/document.ext"`; or an instance of
-        #   Google::Cloud::Storage::File of the text to be annotated.
-        # @param [String, Symbol] encoding Encoding of audio data to be
-        #   recognized. Optional.
-        #
-        #   Acceptable values are:
-        #
-        #   * `linear16` - Uncompressed 16-bit signed little-endian samples.
-        #     (LINEAR16)
-        #   * `flac` - The [Free Lossless Audio
-        #     Codec](http://flac.sourceforge.net/documentation.html) encoding.
-        #     Only 16-bit samples are supported. Not all fields in STREAMINFO
-        #     are supported. (FLAC)
-        #   * `mulaw` - 8-bit samples that compand 14-bit audio samples using
-        #     G.711 PCMU/mu-law. (MULAW)
-        #   * `amr` - Adaptive Multi-Rate Narrowband codec. (`sample_rate` must
-        #     be 8000 Hz.) (AMR)
-        #   * `amr_wb` - Adaptive Multi-Rate Wideband codec. (`sample_rate` must
-        #     be 16000 Hz.) (AMR_WB)
-        #   * `ogg_opus` - Ogg Mapping for Opus. (OGG_OPUS)
-        #
-        #     Lossy codecs do not recommend, as they result in a lower-quality
-        #     speech transcription.
-        #   * `speex` - Speex with header byte. (SPEEX_WITH_HEADER_BYTE)
-        #
-        #     Lossy codecs do not recommend, as they result in a lower-quality
-        #     speech transcription. If you must use a low-bitrate encoder,
-        #     OGG_OPUS is preferred.
-        #
-        # @param [String,Symbol] language The language of the supplied audio as
-        #   a [BCP-47](https://tools.ietf.org/html/bcp47) language code. e.g.
-        #   "en-US" for English (United States), "en-GB" for English (United
-        #   Kingdom), "fr-FR" for French (France). See [Language
-        #   Support](https://cloud.google.com/speech/docs/languages) for a list
-        #   of the currently supported language codes. Optional.
-        # @param [Integer] sample_rate Sample rate in Hertz of the audio data
-        #   to be recognized. Valid values are: 8000-48000. 16000 is optimal.
-        #   For best results, set the sampling rate of the audio source to 16000
-        #   Hz. If that's not possible, use the native sample rate of the audio
-        #   source (instead of re-sampling). Optional.
-        # @param [String] max_alternatives The Maximum number of recognition
-        #   hypotheses to be returned. Default is 1. The service may return
-        #   fewer. Valid values are 0-30. Defaults to 1. Optional.
-        # @param [Boolean] profanity_filter When `true`, the service will
-        #   attempt to filter out profanities, replacing all but the initial
-        #   character in each filtered word with asterisks, e.g. "f***". Default
-        #   is `false`.
-        # @param [Array<String>] phrases A list of strings containing words and
-        #   phrases "hints" so that the speech recognition is more likely to
-        #   recognize them. See [usage
-        #   limits](https://cloud.google.com/speech/limits#content). Optional.
-        # @param [Boolean] words When `true`, return a list of words with
-        #   additional information about each word. Currently, the only
-        #   additional information provided is the the start and end time
-        #   offsets. See {Result#words}. Default is `false`.
-        #
-        # @return [Array<Result>] The transcribed text of audio recognized.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   results = speech.recognize "path/to/audio.raw",
-        #                              encoding: :linear16,
-        #                              language: "en-US",
-        #                              sample_rate: 16000
-        #
-        # @example With a Google Cloud Storage URI:
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   results = speech.recognize "gs://bucket-name/path/to/audio.raw",
-        #                              encoding: :linear16,
-        #                              language: "en-US",
-        #                              sample_rate: 16000
-        #
-        # @example With a Google Cloud Storage File object:
-        #   require "google/cloud/storage"
-        #
-        #   storage = Google::Cloud::Storage.new
-        #
-        #   bucket = storage.bucket "bucket-name"
-        #   file = bucket.file "path/to/audio.raw"
-        #
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   results = speech.recognize file,
-        #                              encoding: :linear16,
-        #                              language: "en-US",
-        #                              sample_rate: 16000,
-        #                              max_alternatives: 10
-        #
-        def recognize source, encoding: nil, language: nil, sample_rate: nil,
-                      max_alternatives: nil, profanity_filter: nil,
-                      phrases: nil, words: nil
-          ensure_service!
-
-          audio_obj = audio source, encoding: encoding, language: language,
-                                    sample_rate: sample_rate
-
-          config = audio_config(
-            encoding: audio_obj.encoding, sample_rate: audio_obj.sample_rate,
-            language: audio_obj.language, max_alternatives: max_alternatives,
-            profanity_filter: profanity_filter, phrases: phrases,
-            words: words
-          )
-
-          grpc = service.recognize_sync audio_obj.to_grpc, config
-          grpc.results.map do |result_grpc|
-            Result.from_grpc result_grpc
-          end
-        end
-
-        ##
-        # Performs asynchronous speech recognition. Requests are processed
-        # asynchronously, meaning a Operation is returned once the audio data
-        # has been sent, and can be refreshed to retrieve recognition results
-        # once the audio data has been processed.
-        #
-        # @see https://cloud.google.com/speech/docs/basics#async-responses
-        #   Asynchronous Speech API Responses
-        #
-        # @param [String, IO, Google::Cloud::Storage::File] source A string of
-        #   the path to the audio file to be recognized, or a File or other IO
-        #   object of the audio contents, or a Cloud Storage URI of the form
-        #   `"gs://bucketname/path/to/document.ext"`; or an instance of
-        #   Google::Cloud::Storage::File of the text to be annotated.
-        # @param [String, Symbol] encoding Encoding of audio data to be
-        #   recognized. Optional.
-        #
-        #   Acceptable values are:
-        #
-        #   * `linear16` - Uncompressed 16-bit signed little-endian samples.
-        #     (LINEAR16)
-        #   * `flac` - The [Free Lossless Audio
-        #     Codec](http://flac.sourceforge.net/documentation.html) encoding.
-        #     Only 16-bit samples are supported. Not all fields in STREAMINFO
-        #     are supported. (FLAC)
-        #   * `mulaw` - 8-bit samples that compand 14-bit audio samples using
-        #     G.711 PCMU/mu-law. (MULAW)
-        #   * `amr` - Adaptive Multi-Rate Narrowband codec. (`sample_rate` must
-        #     be 8000 Hz.) (AMR)
-        #   * `amr_wb` - Adaptive Multi-Rate Wideband codec. (`sample_rate` must
-        #     be 16000 Hz.) (AMR_WB)
-        #   * `ogg_opus` - Ogg Mapping for Opus. (OGG_OPUS)
-        #
-        #     Lossy codecs do not recommend, as they result in a lower-quality
-        #     speech transcription.
-        #   * `speex` - Speex with header byte. (SPEEX_WITH_HEADER_BYTE)
-        #
-        #     Lossy codecs do not recommend, as they result in a lower-quality
-        #     speech transcription. If you must use a low-bitrate encoder,
-        #     OGG_OPUS is preferred.
-        #
-        # @param [String,Symbol] language The language of the supplied audio as
-        #   a [BCP-47](https://tools.ietf.org/html/bcp47) language code. e.g.
-        #   "en-US" for English (United States), "en-GB" for English (United
-        #   Kingdom), "fr-FR" for French (France). See [Language
-        #   Support](https://cloud.google.com/speech/docs/languages) for a list
-        #   of the currently supported language codes. Optional.
-        # @param [Integer] sample_rate Sample rate in Hertz of the audio data
-        #   to be recognized. Valid values are: 8000-48000. 16000 is optimal.
-        #   For best results, set the sampling rate of the audio source to 16000
-        #   Hz. If that's not possible, use the native sample rate of the audio
-        #   source (instead of re-sampling). Optional.
-        # @param [String] max_alternatives The Maximum number of recognition
-        #   hypotheses to be returned. Default is 1. The service may return
-        #   fewer. Valid values are 0-30. Defaults to 1. Optional.
-        # @param [Boolean] profanity_filter When `true`, the service will
-        #   attempt to filter out profanities, replacing all but the initial
-        #   character in each filtered word with asterisks, e.g. "f***". Default
-        #   is `false`.
-        # @param [Array<String>] phrases A list of strings containing words and
-        #   phrases "hints" so that the speech recognition is more likely to
-        #   recognize them. See [usage
-        #   limits](https://cloud.google.com/speech/limits#content). Optional.
-        # @param [Boolean] words When `true`, return a list of words with
-        #   additional information about each word. Currently, the only
-        #   additional information provided is the the start and end time
-        #   offsets. See {Result#words}. Default is `false`.
-        #
-        # @return [Operation] A resource represents the long-running,
-        #   asynchronous processing of a speech-recognition operation.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   op = speech.process "path/to/audio.raw",
-        #                       encoding: :linear16,
-        #                       language: "en-US",
-        #                       sample_rate: 16000
-        #
-        #   op.done? #=> false
-        #   op.reload!
-        #
-        # @example With a Google Cloud Storage URI:
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   op = speech.process "gs://bucket-name/path/to/audio.raw",
-        #                       encoding: :linear16,
-        #                       language: "en-US",
-        #                       sample_rate: 16000
-        #
-        #   op.done? #=> false
-        #   op.reload!
-        #
-        # @example With a Google Cloud Storage File object:
-        #   require "google/cloud/storage"
-        #
-        #   storage = Google::Cloud::Storage.new
-        #
-        #   bucket = storage.bucket "bucket-name"
-        #   file = bucket.file "path/to/audio.raw"
-        #
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   op = speech.process file,
-        #                       encoding: :linear16,
-        #                       language: "en-US",
-        #                       sample_rate: 16000,
-        #                       max_alternatives: 10
-        #
-        #   op.done? #=> false
-        #   op.reload!
-        #
-        def process source, encoding: nil, sample_rate: nil, language: nil,
-                    max_alternatives: nil, profanity_filter: nil, phrases: nil,
-                    words: nil
-          ensure_service!
-
-          audio_obj = audio source, encoding: encoding, language: language,
-                                    sample_rate: sample_rate
-
-          config = audio_config(
-            encoding: audio_obj.encoding, sample_rate: audio_obj.sample_rate,
-            language: audio_obj.language, max_alternatives: max_alternatives,
-            profanity_filter: profanity_filter, phrases: phrases,
-            words: words
-          )
-
-          grpc = service.recognize_async audio_obj.to_grpc, config
-          Operation.from_grpc grpc
-        end
-        alias long_running_recognize process
-        alias recognize_job process
-
-        ##
-        # Creates a Stream object to perform bidirectional streaming
-        # speech-recognition: receive results while sending audio.
-        #
-        # @see https://cloud.google.com/speech/docs/basics#streaming-recognition
-        #   Streaming Speech API Recognition Requests
-        #
-        # @param [String, Symbol] encoding Encoding of audio data to be
-        #   recognized. Optional.
-        #
-        #   Acceptable values are:
-        #
-        #   * `linear16` - Uncompressed 16-bit signed little-endian samples.
-        #     (LINEAR16)
-        #   * `flac` - The [Free Lossless Audio
-        #     Codec](http://flac.sourceforge.net/documentation.html) encoding.
-        #     Only 16-bit samples are supported. Not all fields in STREAMINFO
-        #     are supported. (FLAC)
-        #   * `mulaw` - 8-bit samples that compand 14-bit audio samples using
-        #     G.711 PCMU/mu-law. (MULAW)
-        #   * `amr` - Adaptive Multi-Rate Narrowband codec. (`sample_rate` must
-        #     be 8000 Hz.) (AMR)
-        #   * `amr_wb` - Adaptive Multi-Rate Wideband codec. (`sample_rate` must
-        #     be 16000 Hz.) (AMR_WB)
-        #   * `ogg_opus` - Ogg Mapping for Opus. (OGG_OPUS)
-        #
-        #     Lossy codecs do not recommend, as they result in a lower-quality
-        #     speech transcription.
-        #   * `speex` - Speex with header byte. (SPEEX_WITH_HEADER_BYTE)
-        #
-        #     Lossy codecs do not recommend, as they result in a lower-quality
-        #     speech transcription. If you must use a low-bitrate encoder,
-        #     OGG_OPUS is preferred.
-        #
-        # @param [String,Symbol] language The language of the supplied audio as
-        #   a [BCP-47](https://tools.ietf.org/html/bcp47) language code. e.g.
-        #   "en-US" for English (United States), "en-GB" for English (United
-        #   Kingdom), "fr-FR" for French (France). See [Language
-        #   Support](https://cloud.google.com/speech/docs/languages) for a list
-        #   of the currently supported language codes. Optional.
-        # @param [Integer] sample_rate Sample rate in Hertz of the audio data
-        #   to be recognized. Valid values are: 8000-48000. 16000 is optimal.
-        #   For best results, set the sampling rate of the audio source to 16000
-        #   Hz. If that's not possible, use the native sample rate of the audio
-        #   source (instead of re-sampling). Optional.
-        # @param [String] max_alternatives The Maximum number of recognition
-        #   hypotheses to be returned. Default is 1. The service may return
-        #   fewer. Valid values are 0-30. Defaults to 1. Optional.
-        # @param [Boolean] profanity_filter When `true`, the service will
-        #   attempt to filter out profanities, replacing all but the initial
-        #   character in each filtered word with asterisks, e.g. "f***". Default
-        #   is `false`.
-        # @param [Array<String>] phrases A list of strings containing words and
-        #   phrases "hints" so that the speech recognition is more likely to
-        #   recognize them. See [usage
-        #   limits](https://cloud.google.com/speech/limits#content). Optional.
-        # @param [Boolean] words When `true`, return a list of words with
-        #   additional information about each word. Currently, the only
-        #   additional information provided is the the start and end time
-        #   offsets. See {Result#words}. Default is `false`.
-        # @param [Boolean] utterance When `true`, the service will perform
-        #   continuous recognition (continuing to process audio even if the user
-        #   pauses speaking) until the client closes the output stream (gRPC
-        #   API) or when the maximum time limit has been reached. Default is
-        #   `false`.
-        # @param [Boolean] interim When `true`, interim results (tentative
-        #   hypotheses) may be returned as they become available. Default is
-        #   `false`.
-        #
-        # @return [Stream] A resource that represents the streaming requests and
-        #   responses.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   stream = speech.stream encoding: :linear16,
-        #                          language: "en-US",
-        #                          sample_rate: 16000
-        #
-        #   # Stream 5 seconds of audio from the microphone
-        #   # Actual implementation of microphone input varies by platform
-        #   5.times do
-        #     stream.send MicrophoneInput.read(32000)
-        #   end
-        #
-        #   stream.stop
-        #   stream.wait_until_complete!
-        #
-        #   results = stream.results
-        #   result = results.first
-        #   result.transcript #=> "how old is the Brooklyn Bridge"
-        #   result.confidence #=> 0.9826789498329163
-        #
-        def stream encoding: nil, language: nil, sample_rate: nil,
-                   max_alternatives: nil, profanity_filter: nil, phrases: nil,
-                   words: nil, utterance: nil, interim: nil
-          ensure_service!
-
-          grpc_req = V1::StreamingRecognizeRequest.new(
-            streaming_config: V1::StreamingRecognitionConfig.new(
-              {
-                config: audio_config(encoding: convert_encoding(encoding),
-                                     language: language,
-                                     sample_rate: sample_rate,
-                                     max_alternatives: max_alternatives,
-                                     profanity_filter: profanity_filter,
-                                     phrases: phrases, words: words),
-                single_utterance: utterance,
-                interim_results: interim
-              }.delete_if { |_, v| v.nil? }
-            )
-          )
-
-          Stream.new service, grpc_req
-        end
-        alias stream_recognize stream
-
-        ##
-        # Performs asynchronous speech recognition. Requests are processed
-        # asynchronously, meaning a Operation is returned once the audio data
-        # has been sent, and can be refreshed to retrieve recognition results
-        # once the audio data has been processed.
-        #
-        # @see https://cloud.google.com/speech/reference/rpc/google.longrunning#google.longrunning.Operations
-        #   Long-running Operation
-        #
-        # @param [String] id The unique identifier for the long running
-        #   operation. Required.
-        #
-        # @return [Operation] A resource represents the long-running,
-        #   asynchronous processing of a speech-recognition operation.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   op = speech.operation "1234567890"
-        #
-        #   op.done? #=> false
-        #   op.reload!
-        #
-        def operation id
-          ensure_service!
-
-          grpc = service.get_op id
-          Operation.from_grpc grpc
-        end
-
-        protected
-
-        def audio_config encoding: nil, language: nil, sample_rate: nil,
-                         max_alternatives: nil, profanity_filter: nil,
-                         phrases: nil, words: nil
-          contexts = nil
-          contexts = [V1::SpeechContext.new(phrases: phrases)] if phrases
-          language = String(language) unless language.nil?
-          V1::RecognitionConfig.new({
-            encoding: convert_encoding(encoding),
-            language_code: language,
-            sample_rate_hertz: sample_rate,
-            max_alternatives: max_alternatives,
-            profanity_filter: profanity_filter,
-            speech_contexts: contexts,
-            enable_word_time_offsets: words
-          }.delete_if { |_, v| v.nil? })
-        end
-
-        def convert_encoding encoding
-          mapping = { linear: :LINEAR16, linear16: :LINEAR16,
-                      flac: :FLAC, mulaw: :MULAW, amr: :AMR, amr_wb: :AMR_WB,
-                      ogg_opus: :OGG_OPUS, speex: :SPEEX_WITH_HEADER_BYTE }
-          mapping[encoding] || encoding
-        end
-
-        ##
-        # @private Raise an error unless an active connection to the service is
-        # available.
-        def ensure_service!
-          raise "Must have active connection to service" unless service
-        end
-      end
-    end
-  end
-end