google-cloud-dialogflow-v2 0.11.3 → 0.13.0

data/proto_docs/google/cloud/dialogflow/v2/session.rb

@@ -406,10 +406,11 @@ module Google
         #
         # Multiple response messages can be returned in order:
         #
-        # 1.  If the input was set to streaming audio, the first one or more messages
-        #     contain `recognition_result`. Each `recognition_result` represents a more
-        #     complete transcript of what the user said. The last `recognition_result`
-        #     has `is_final` set to `true`.
+        # 1.  If the `StreamingDetectIntentRequest.input_audio` field was
+        #     set, the `recognition_result` field is populated for one
+        #     or more messages.
+        #     See the {::Google::Cloud::Dialogflow::V2::StreamingRecognitionResult StreamingRecognitionResult} message for details
+        #     about the result message sequence.
         #
         # 2.  The next message contains `response_id`, `query_result`
         #     and optionally `webhook_status` if a WebHook was called.
@@ -450,35 +451,39 @@ module Google
         # that is currently being processed or an indication that this is the end
         # of the single requested utterance.
         #
-        # Example:
-        #
-        # 1.  transcript: "tube"
-        #
-        # 2.  transcript: "to be a"
-        #
-        # 3.  transcript: "to be"
-        #
-        # 4.  transcript: "to be or not to be"
-        #     is_final: true
-        #
-        # 5.  transcript: " that's"
-        #
-        # 6.  transcript: " that is"
-        #
-        # 7.  message_type: `END_OF_SINGLE_UTTERANCE`
-        #
-        # 8.  transcript: " that is the question"
-        #     is_final: true
-        #
-        # Only two of the responses contain final results (#4 and #8 indicated by
-        # `is_final: true`). Concatenating these generates the full transcript: "to be
-        # or not to be that is the question".
-        #
-        # In each response we populate:
-        #
-        # *  for `TRANSCRIPT`: `transcript` and possibly `is_final`.
-        #
-        # *  for `END_OF_SINGLE_UTTERANCE`: only `message_type`.
+        # While end-user audio is being processed, Dialogflow sends a series of
+        # results. Each result may contain a `transcript` value. A transcript
+        # represents a portion of the utterance. While the recognizer is processing
+        # audio, transcript values may be interim values or finalized values.
+        # Once a transcript is finalized, the `is_final` value is set to true and
+        # processing continues for the next transcript.
+        #
+        # If `StreamingDetectIntentRequest.query_input.audio_config.single_utterance`
+        # was true, and the recognizer has completed processing audio,
+        # the `message_type` value is set to `END_OF_SINGLE_UTTERANCE and the
+        # following (last) result contains the last finalized transcript.
+        #
+        # The complete end-user utterance is determined by concatenating the
+        # finalized transcript values received for the series of results.
+        #
+        # In the following example, single utterance is enabled. In the case where
+        # single utterance is not enabled, result 7 would not occur.
+        #
+        # ```
+        # Num | transcript              | message_type            | is_final
+        # --- | ----------------------- | ----------------------- | --------
+        # 1   | "tube"                  | TRANSCRIPT              | false
+        # 2   | "to be a"               | TRANSCRIPT              | false
+        # 3   | "to be"                 | TRANSCRIPT              | false
+        # 4   | "to be or not to be"    | TRANSCRIPT              | true
+        # 5   | "that's"                | TRANSCRIPT              | false
+        # 6   | "that is                | TRANSCRIPT              | false
+        # 7   | unset                   | END_OF_SINGLE_UTTERANCE | unset
+        # 8   | " that is the question" | TRANSCRIPT              | true
+        # ```
+        #
+        # Concatenating the finalized transcripts with `is_final` set to true,
+        # the complete utterance becomes "to be or not to be that is the question".
         # @!attribute [rw] message_type
         #   @return [::Google::Cloud::Dialogflow::V2::StreamingRecognitionResult::MessageType]
         #     Type of the result message.

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-dialogflow-v2
 version: !ruby/object:Gem::Version
-  version: 0.11.3
+  version: 0.13.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-10-18 00:00:00.000000000 Z
+date: 2022-01-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -290,6 +290,7 @@ files:
 - proto_docs/google/cloud/dialogflow/v2/entity_type.rb
 - proto_docs/google/cloud/dialogflow/v2/environment.rb
 - proto_docs/google/cloud/dialogflow/v2/fulfillment.rb
+- proto_docs/google/cloud/dialogflow/v2/gcs.rb
 - proto_docs/google/cloud/dialogflow/v2/human_agent_assistant_event.rb
 - proto_docs/google/cloud/dialogflow/v2/intent.rb
 - proto_docs/google/cloud/dialogflow/v2/knowledge_base.rb
@@ -327,7 +328,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.17
+rubygems_version: 3.3.4
 signing_key: 
 specification_version: 4
 summary: API Client library for the Dialogflow V2 API