Api-Roll 53: 2017-08-21

generated/googleapis/lib/speech/v1.dart

 // This is a generated file (see the discoveryapis_generator project).
 
 library googleapis.speech.v1;
 
 import 'dart:core' as core;
 import 'dart:async' as async;
 import 'dart:convert' as convert;
 
 import 'package:_discoveryapis_commons/_discoveryapis_commons.dart' as commons;
 import 'package:http/http.dart' as http;
@@ skipping 563 matching lines @@
     return _json;
   }
 }
 
 /**
  * Provides information to the recognizer that specifies how to process the
  * request.
  */
 class RecognitionConfig {
   /**
-   * *Optional* If `true`, a list of `words` are returned in the top result,
-   * containing the start and end timestamps for those words. The default value,
-   * 'false' does not return any word-level timing information.
+   * *Optional* If `true`, the top result includes a list of words and
+   * the start and end time offsets (timestamps) for those words. If
+   * `false`, no word-level time offset information is returned. The default is
+   * `false`.
    */
   core.bool enableWordTimeOffsets;
   /**
    * *Required* Encoding of audio data sent in all `RecognitionAudio` messages.
    * Possible string values are:
    * - "ENCODING_UNSPECIFIED" : Not specified. Will return result
    * google.rpc.Code.INVALID_ARGUMENT.
    * - "LINEAR16" : Uncompressed 16-bit signed little-endian samples (Linear
    * PCM).
    * - "FLAC" : [`FLAC`](https://xiph.org/flac/documentation.html) (Free
@@ skipping 221 matching lines @@
    * only for `is_final=true` results. Clients should not rely on the
    * `confidence` field as it is not guaranteed to be accurate or consistent.
    * The default of 0.0 is a sentinel value indicating `confidence` was not set.
    */
   core.double confidence;
   /**
    * *Output-only* Transcript text representing the words that the user spoke.
    */
   core.String transcript;
   /**
-   * *Output-only* List of word-specific information for each recognized word.
+   * *Output-only* A list of word-specific information for each recognized word.
    */
   core.List<WordInfo> words;
 
   SpeechRecognitionAlternative();
 
   SpeechRecognitionAlternative.fromJson(core.Map _json) {
     if (_json.containsKey("confidence")) {
       confidence = _json["confidence"];
     }
     if (_json.containsKey("transcript")) {
@@ skipping 17 matching lines @@
     }
     return _json;
   }
 }
 
 /** A speech recognition result corresponding to a portion of the audio. */
 class SpeechRecognitionResult {
   /**
    * *Output-only* May contain one or more recognition hypotheses (up to the
    * maximum specified in `max_alternatives`).
-   * These alternatives are ordered in terms of accuracy, with the first/top
+   * These alternatives are ordered in terms of accuracy, with the top (first)
    * alternative being the most probable, as ranked by the recognizer.
    */
   core.List<SpeechRecognitionAlternative> alternatives;
 
   SpeechRecognitionResult();
 
   SpeechRecognitionResult.fromJson(core.Map _json) {
     if (_json.containsKey("alternatives")) {
       alternatives = _json["alternatives"].map((value) => new SpeechRecognitionAlternative.fromJson(value)).toList();
     }
@@ skipping 105 matching lines @@
       _json["details"] = details;
     }
     if (message != null) {
       _json["message"] = message;
     }
     return _json;
   }
 }
 
 /**
- * Word-specific information detected along with speech recognition when certain
- * request parameters are set.
+ * Word-specific information for recognized words. Word information is only
+ * included in the response when certain request parameters are set, such
+ * as `enable_word_time_offsets`.
  */
 class WordInfo {
   /**
    * *Output-only* Time offset relative to the beginning of the audio,
    * and corresponding to the end of the spoken word.
    * This field is only set if `enable_word_time_offsets=true` and only
    * in the top hypothesis.
    * This is an experimental feature and the accuracy of the time offset can
    * vary.
    */
@@ skipping 31 matching lines @@
     }
     if (startTime != null) {
       _json["startTime"] = startTime;
     }
     if (word != null) {
       _json["word"] = word;
     }
     return _json;
   }
 }