google-cloud-speech 0.29.0 → 0.30.0

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

@@ -1,240 +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/speech/convert"
-
-module Google
-  module Cloud
-    module Speech
-      ##
-      # # Result
-      #
-      # A speech recognition result corresponding to a portion of the audio.
-      #
-      # See {Project#recognize} and {Operation#results}.
-      #
-      # @see https://cloud.google.com/speech/reference/rpc/google.cloud.speech.V1#google.cloud.speech.V1.SpeechRecognitionResult
-      #   SpeechRecognitionResult
-      #
-      # @attr_reader [String] transcript Transcript text representing the words
-      #   that the user spoke.
-      # @attr_reader [Float] confidence The confidence estimate between 0.0 and
-      #   1.0. A higher number means the system is more confident that the
-      #   recognition is correct. This field is typically provided only for the
-      #   top hypothesis. A value of 0.0 is a sentinel value indicating
-      #   confidence was not set.
-      # @attr_reader [Array<Result::Word>] words A list of words with additional
-      #   information about each word. Currently, the only additional
-      #   information provided is the the start and end time offsets. Available
-      #   when using the `words` argument in relevant methods.
-      # @attr_reader [Array<Result::Alternative>] alternatives Additional
-      #   recognition hypotheses (up to the value specified in
-      #   `max_alternatives`). The server may return fewer than
-      #   `max_alternatives`.
-      #
-      # @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 Result
-        attr_reader :transcript, :confidence, :words, :alternatives
-
-        ##
-        # @private Creates a new Results instance.
-        def initialize transcript, confidence, words = [], alternatives = []
-          @transcript   = transcript
-          @confidence   = confidence
-          @words        = words
-          @alternatives = alternatives
-        end
-
-        ##
-        # @private New Results from a SpeechRecognitionAlternative object.
-        def self.from_grpc grpc
-          head, *tail = *grpc.alternatives
-          return nil if head.nil?
-          words = Array(head.words).map do |w|
-            Word.new w.word, Convert.duration_to_number(w.start_time),
-                     Convert.duration_to_number(w.end_time)
-          end
-          alternatives = tail.map do |alt|
-            Alternative.new alt.transcript, alt.confidence
-          end
-          new head.transcript, head.confidence, words, alternatives
-        end
-
-        ##
-        # Word-specific information for recognized words. Currently, the only
-        # additional information provided is the the start and end time offsets.
-        # Available when using the `words` argument in relevant methods.
-        #
-        # @attr_reader [String] word The word corresponding to this set of
-        #   information.
-        # @attr_reader [Numeric] start_time Time offset relative to the
-        #   beginning of the audio, and corresponding to the start of the spoken
-        #   word. This field is only set if `words` was specified. This is an
-        #   experimental feature and the accuracy of the time offset can vary.
-        # @attr_reader [Numeric] end_time Time offset relative to the
-        #   beginning of the audio, and corresponding to the end of the spoken
-        #   word. This field is only set if `words` was specified. This is an
-        #   experimental feature and the accuracy of the time offset can vary.
-        class Word
-          attr_reader :word, :start_time, :end_time
-          alias to_str word
-
-          ##
-          # @private Creates a new Result::Word instance.
-          def initialize word, start_time, end_time
-            @word       = word
-            @start_time = start_time
-            @end_time   = end_time
-          end
-        end
-
-        ##
-        # # Result::Alternative
-        #
-        # A speech recognition result corresponding to a portion of the audio.
-        #
-        # @attr_reader [String] transcript Transcript text representing the
-        #   words that the user spoke.
-        # @attr_reader [Float] confidence The confidence estimate between 0.0
-        #   and 1.0. A higher number means the system is more confident that the
-        #   recognition is correct. This field is typically provided only for
-        #   the top hypothesis. A value of 0.0 is a sentinel value indicating
-        #   confidence was not set.
-        #
-        # @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
-        #   alternative = result.alternatives.first
-        #   alternative.transcript #=> "how old is the Brooklyn brim"
-        #   alternative.confidence #=> 0.22030000388622284
-        #
-        class Alternative
-          attr_reader :transcript, :confidence
-
-          ##
-          # @private Creates a new Result::Alternative instance.
-          def initialize transcript, confidence
-            @transcript = transcript
-            @confidence = confidence
-          end
-        end
-      end
-
-      ##
-      # # InterimResult
-      #
-      # A streaming speech recognition result corresponding to a portion of the
-      # audio that is currently being processed.
-      #
-      # See {Project#stream} and {Stream#on_interim}.
-      #
-      # @see https://cloud.google.com/speech/reference/rpc/google.cloud.speech.V1#google.cloud.speech.V1.SpeechRecognitionResult
-      #   SpeechRecognitionResult
-      # @see https://cloud.google.com/speech/reference/rpc/google.cloud.speech.V1#google.cloud.speech.V1.StreamingRecognitionResult
-      #   StreamingRecognitionResult
-      #
-      # @attr_reader [String] transcript Transcript text representing the words
-      #   that the user spoke.
-      # @attr_reader [Float] confidence The confidence estimate between 0.0 and
-      #   1.0. A higher number means the system is more confident that the
-      #   recognition is correct. This field is typically provided only for the
-      #   top hypothesis. A value of 0.0 is a sentinel value indicating
-      #   confidence was not set.
-      # @attr_reader [Float] stability An estimate of the probability that the
-      #   recognizer will not change its guess about this interim result. Values
-      #   range from 0.0 (completely unstable) to 1.0 (completely stable). Note
-      #   that this is not the same as confidence, which estimates the
-      #   probability that a recognition result is correct.
-      # @attr_reader [Array<Result::Alternative>] alternatives Additional
-      #   recognition hypotheses (up to the value specified in
-      #   `max_alternatives`).
-      #
-      # @example
-      #   require "google/cloud/speech"
-      #
-      #   speech = Google::Cloud::Speech.new
-      #
-      #   stream = speech.stream encoding: :linear16,
-      #                          language: "en-US",
-      #                          sample_rate: 16000
-      #
-      #   # register callback for when an interim result is returned
-      #   stream.on_interim do |final_results, interim_results|
-      #     interim_result = interim_results.first
-      #     puts interim_result.transcript # "how old is the Brooklyn Bridge"
-      #     puts interim_result.confidence # 0.9826789498329163
-      #     puts interim_result.stability # 0.8999
-      #   end
-      #
-      #   # 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
-      #
-      class InterimResult
-        attr_reader :transcript, :confidence, :stability, :alternatives
-
-        ##
-        # @private Creates a new InterimResult instance.
-        def initialize transcript, confidence, stability, alternatives = []
-          @transcript = transcript
-          @confidence = confidence
-          @stability = stability
-          @alternatives = alternatives
-        end
-
-        ##
-        # @private New InterimResult from a StreamingRecognitionResult object.
-        def self.from_grpc grpc
-          head, *tail = *grpc.alternatives
-          return nil if head.nil?
-          alternatives = tail.map do |alt|
-            Result::Alternative.new alt.transcript, alt.confidence
-          end
-          new head.transcript, head.confidence, grpc.stability, alternatives
-        end
-      end
-    end
-  end
-end

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

@@ -1,121 +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/credentials"
-require "google/cloud/speech/version"
-require "google/cloud/speech/v1"
-
-module Google
-  module Cloud
-    module Speech
-      ##
-      # @private Represents the gRPC Speech service, including all the API
-      # methods.
-      class Service
-        attr_accessor :project, :credentials, :timeout, :client_config
-
-        ##
-        # LRO client configured for Speech
-        class SpeechOperationsClient < Google::Longrunning::OperationsClient
-          SERVICE_ADDRESS = V1::SpeechClient::SERVICE_ADDRESS
-        end
-
-        ##
-        # Creates a new Service instance.
-        def initialize project, credentials, timeout: nil, client_config: nil
-          @project = project
-          @credentials = credentials
-          @timeout = timeout
-          @client_config = client_config || {}
-        end
-
-        def service
-          return mocked_service if mocked_service
-          @service ||= \
-            V1::SpeechClient.new(
-              credentials: credentials,
-              timeout: timeout,
-              client_config: client_config,
-              lib_name: "gccl",
-              lib_version: Google::Cloud::Speech::VERSION
-            )
-        end
-        attr_accessor :mocked_service
-
-        def ops
-          return mocked_ops if mocked_ops
-          @ops ||= \
-            SpeechOperationsClient.new(
-              credentials: credentials,
-              timeout: timeout,
-              client_config: client_config,
-              lib_name: "gccl",
-              lib_version: Google::Cloud::Speech::VERSION
-            )
-        end
-        attr_accessor :mocked_ops
-
-        def recognize_sync audio, config
-          execute do
-            service.recognize config, audio, options: default_options
-          end
-        end
-
-        def recognize_async audio, config
-          execute do
-            service.long_running_recognize \
-              config, audio, options: default_options
-          end
-        end
-
-        def recognize_stream request_enum
-          # No need to handle errors here, they are handled in the enum
-          service.streaming_recognize request_enum, options: default_options
-        end
-
-        def get_op name
-          execute do
-            Google::Gax::Operation.new \
-              ops.get_operation(name), ops,
-              V1::LongRunningRecognizeResponse,
-              V1::LongRunningRecognizeMetadata
-          end
-        end
-
-        def inspect
-          "#{self.class}(#{@project})"
-        end
-
-        protected
-
-        def default_headers
-          { "google-cloud-resource-prefix" => "projects/#{@project}" }
-        end
-
-        def default_options
-          Google::Gax::CallOptions.new kwargs: default_headers
-        end
-
-        def execute
-          yield
-        rescue Google::Gax::GaxError => e
-          # GaxError wraps BadStatus, but exposes it as #cause
-          raise Google::Cloud::Error.from_error(e.cause)
-        end
-      end
-    end
-  end
-end

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

@@ -1,564 +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/speech/result"
-require "monitor"
-require "forwardable"
-
-module Google
-  module Cloud
-    module Speech
-      ##
-      # # 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
-      #
-      class Stream
-        include MonitorMixin
-        ##
-        # @private Creates a new Speech Stream instance.
-        # This must always be private, since it may change as the implementation
-        # changes over time.
-        def initialize service, streaming_recognize_request
-          @service = service
-          @streaming_recognize_request = streaming_recognize_request
-          @results = []
-          @callbacks = Hash.new { |h, k| h[k] = [] }
-          super() # to init MonitorMixin
-        end
-
-        ##
-        # Starts the stream. The stream will be started in the first #send call.
-        def start
-          return if @request_queue
-          @request_queue = EnumeratorQueue.new(self)
-          @request_queue.push @streaming_recognize_request
-
-          Thread.new { background_run }
-        end
-
-        ##
-        # Checks if the stream has been started.
-        #
-        # @return [boolean] `true` when started, `false` otherwise.
-        def started?
-          synchronize do
-            !(!@request_queue)
-          end
-        end
-
-        ##
-        # Sends audio content to the server.
-        #
-        # @param [String] bytes A string of binary audio data to be recognized.
-        #   The data should be encoded as `ASCII-8BIT`.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   audio = speech.audio "path/to/audio.raw"
-        #
-        #   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 send bytes
-          start # lazily call start if the stream wasn't started yet
-          # TODO: do not send if stopped?
-          synchronize do
-            req = V1::StreamingRecognizeRequest.new(
-              audio_content: bytes.encode("ASCII-8BIT")
-            )
-            @request_queue.push req
-          end
-        end
-
-        ##
-        # Stops the stream. Signals to the server that no more data will be
-        # sent.
-        def stop
-          synchronize do
-            return if @request_queue.nil?
-            @request_queue.push self
-            @stopped = true
-          end
-        end
-
-        ##
-        # Checks if the stream has been stopped.
-        #
-        # @return [boolean] `true` when stopped, `false` otherwise.
-        def stopped?
-          synchronize do
-            @stopped
-          end
-        end
-
-        ##
-        # The speech recognition results for the audio.
-        #
-        # @return [Array<Result>] The transcribed text of audio recognized.
-        #
-        # @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
-        #
-        #   results = stream.results
-        #   results.each do |result|
-        #     puts result.transcript
-        #     puts result.confidence
-        #   end
-        #
-        def results
-          synchronize do
-            @results
-          end
-        end
-
-        ##
-        # Whether all speech recognition results have been returned.
-        #
-        # @return [Boolean] All speech recognition results have been returned.
-        #
-        # @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!
-        #   stream.complete? #=> true
-        #
-        #   results = stream.results
-        #   results.each do |result|
-        #     puts result.transcript
-        #     puts result.confidence
-        #   end
-        #
-        def complete?
-          synchronize do
-            @complete
-          end
-        end
-
-        ##
-        # Blocks until all speech recognition results have been returned.
-        #
-        # @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!
-        #   stream.complete? #=> true
-        #
-        #   results = stream.results
-        #   results.each do |result|
-        #     puts result.transcript
-        #     puts result.confidence
-        #   end
-        #
-        def wait_until_complete!
-          complete_check = nil
-          synchronize { complete_check = @complete }
-          while complete_check.nil?
-            sleep 1
-            synchronize { complete_check = @complete }
-          end
-        end
-
-        ##
-        # Register to be notified on the reception of an interim result.
-        #
-        # @yield [callback] The block for accessing final and interim results.
-        # @yieldparam [Array<Result>] final_results The final results.
-        # @yieldparam [Array<Result>] interim_results The interim results.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   stream = speech.stream encoding: :linear16,
-        #                          language: "en-US",
-        #                          sample_rate: 16000
-        #
-        #   # register callback for when an interim result is returned
-        #   stream.on_interim do |final_results, interim_results|
-        #     interim_result = interim_results.first
-        #     puts interim_result.transcript # "how old is the Brooklyn Bridge"
-        #     puts interim_result.confidence # 0.9826789498329163
-        #     puts interim_result.stability # 0.8999
-        #   end
-        #
-        #   # 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
-        #
-        def on_interim &block
-          synchronize do
-            @callbacks[:interim] << block
-          end
-        end
-
-        ##
-        # @private yields two arguments, all final results and the
-        # non-final/incomplete result
-        def pass_interim! interim_results
-          synchronize do
-            @callbacks[:interim].each { |c| c.call results, interim_results }
-          end
-        end
-
-        ##
-        # Register to be notified on the reception of a final result.
-        #
-        # @yield [callback] The block for accessing final results.
-        # @yieldparam [Array<Result>] results The final results.
-        #
-        # @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 on_result &block
-          synchronize do
-            @callbacks[:result] << block
-          end
-        end
-
-        ##
-        # @private add a result object, and call the callbacks
-        def pass_result! result_grpc
-          synchronize do
-            @results << Result.from_grpc(result_grpc)
-            @callbacks[:result].each { |c| c.call @results }
-          end
-        end
-
-        ##
-        # Register to be notified when the end of the audio stream has been
-        # reached.
-        #
-        # @yield [callback] The block to be called when the end of the audio
-        #   stream has been reached.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   stream = speech.stream encoding: :linear16,
-        #                          language: "en-US",
-        #                          sample_rate: 16000
-        #
-        #   # register callback for when stream has ended.
-        #   stream.on_complete do
-        #     puts "Stream has ended."
-        #   end
-        #
-        #   # 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
-        #
-        def on_complete &block
-          synchronize do
-            @callbacks[:complete] << block
-          end
-        end
-
-        ##
-        # @private yields when the end of the audio stream has been reached.
-        def pass_complete!
-          synchronize do
-            @complete = true
-            @callbacks[:complete].each(&:call)
-          end
-        end
-
-        ##
-        # Register to be notified when the server has detected the end of the
-        # user's speech utterance and expects no additional speech. Therefore,
-        # the server will not process additional audio. The client should stop
-        # sending additional audio data. This event only occurs when `utterance`
-        # is `true`.
-        #
-        # @yield [callback] The block to be called when the end of the audio
-        #   stream has been reached.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   stream = speech.stream encoding: :linear16,
-        #                          language: "en-US",
-        #                          sample_rate: 16000,
-        #                          utterance: true
-        #
-        #   # register callback for when utterance has occurred.
-        #   stream.on_utterance do
-        #     puts "Utterance has occurred."
-        #     stream.stop
-        #   end
-        #
-        #   # 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 unless stream.stopped?
-        #
-        def on_utterance &block
-          synchronize do
-            @callbacks[:utterance] << block
-          end
-        end
-
-        ##
-        # @private returns single final result once :END_OF_SINGLE_UTTERANCE is
-        # received.
-        def pass_utterance!
-          synchronize do
-            @callbacks[:utterance].each(&:call)
-          end
-        end
-
-        ##
-        # Register to be notified of an error received during the stream.
-        #
-        # @yield [callback] The block for accessing final results.
-        # @yieldparam [Exception] error The error raised.
-        #
-        # @example
-        #   require "google/cloud/speech"
-        #
-        #   speech = Google::Cloud::Speech.new
-        #
-        #   stream = speech.stream encoding: :linear16,
-        #                          language: "en-US",
-        #                          sample_rate: 16000
-        #
-        #   # register callback for when an error is returned
-        #   stream.on_error do |error|
-        #     puts "The following error occurred while streaming: #{error}"
-        #     stream.stop
-        #   end
-        #
-        #   # 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
-        #
-        def on_error &block
-          synchronize do
-            @callbacks[:error] << block
-          end
-        end
-
-        # @private returns error object from the stream thread.
-        def error! err
-          synchronize do
-            @callbacks[:error].each { |c| c.call err }
-          end
-        end
-
-        protected
-
-        def background_run
-          response_enum = @service.recognize_stream @request_queue.each_item
-          response_enum.each do |response|
-            begin
-              background_results response
-              background_event_type response.speech_event_type
-              background_error response.error
-            rescue StandardError => e
-              error! Google::Cloud::Error.from_error(e)
-            end
-          end
-        rescue StandardError => e
-          error! Google::Cloud::Error.from_error(e)
-        ensure
-          pass_complete!
-          Thread.pass
-        end
-
-        def background_results response
-          # Handle the results (StreamingRecognitionResult)
-          return unless response.results && response.results.any?
-
-          final_grpc, interim_grpcs = *response.results
-          unless final_grpc && final_grpc.is_final
-            # all results are interim
-            final_grpc = nil
-            interim_grpcs = response.results
-          end
-
-          # convert to Speech object from GRPC object
-          interim_results = Array(interim_grpcs).map do |grpc|
-            InterimResult.from_grpc grpc
-          end
-
-          # callback for interim results received
-          pass_interim! interim_results if interim_results.any?
-          # callback for final results received, if any
-          pass_result! final_grpc if final_grpc
-        end
-
-        def background_event_type event_type
-          # Handle the event_type by raising events
-          # TODO: do we automatically call stop here?
-          pass_utterance! if event_type == :END_OF_SINGLE_UTTERANCE
-        end
-
-        def background_error error
-          return if error.nil?
-
-          require "grpc/errors"
-          raise GRPC::BadStatus.new(error.code, error.message)
-        end
-
-        # @private
-        class EnumeratorQueue
-          extend Forwardable
-          def_delegators :@q, :push
-
-          # @private
-          def initialize sentinel
-            @q = Queue.new
-            @sentinel = sentinel
-          end
-
-          # @private
-          def each_item
-            return enum_for(:each_item) unless block_given?
-            loop do
-              r = @q.pop
-              break if r.equal? @sentinel
-              raise r if r.is_a? Exception
-              yield r
-            end
-          end
-        end
-      end
-    end
-  end
-end