public static final class StreamingRecognizeResponse.Builder extends GeneratedMessageV3.Builder<StreamingRecognizeResponse.Builder> implements StreamingRecognizeResponseOrBuilder
StreamingRecognizeResponse
is the only message returned to the client by
StreamingRecognize
. A series of one or more StreamingRecognizeResponse
messages are streamed back to the client.
Here's an example of a series of ten StreamingRecognizeResponse
s that might
be returned while processing audio:
- endpointer_type: START_OF_SPEECH
- results { alternatives { transcript: "tube" } stability: 0.01 }
result_index: 0
- results { alternatives { transcript: "to be a" } stability: 0.01 }
result_index: 0
- results { alternatives { transcript: "to be" } stability: 0.9 }
results { alternatives { transcript: " or not to be" } stability: 0.01 }
result_index: 0
- results { alternatives { transcript: "to be or not to be"
confidence: 0.92 }
alternatives { transcript: "to bee or not to bee" }
is_final: true }
result_index: 0
- results { alternatives { transcript: " that's" } stability: 0.01 }
result_index: 1
- results { alternatives { transcript: " that is" } stability: 0.9 }
results { alternatives { transcript: " the question" } stability: 0.01 }
result_index: 1
- endpointer_type: END_OF_SPEECH
- results { alternatives { transcript: " that is the question"
confidence: 0.98 }
alternatives { transcript: " that was the question" }
is_final: true }
result_index: 1
- endpointer_type: END_OF_AUDIO
Notes:
- Only two of the above responses #5 and #9 contain final results, they are
indicated by
is_final: true
. Concatenating these together generates the
full transcript: "to be or not to be that is the question".
- The others contain interim
results
. #4 and #7 contain two interim
results
, the first portion has a high stability and is less likely to
change, the second portion has a low stability and is very likely to
change. A UI designer might choose to show only high stability results
.
- The specific
stability
and confidence
values shown above are only for
illustrative purposes. Actual values may vary.
- The
result_index
indicates the portion of audio that has had final
results returned, and is no longer being processed. For example, the
results
in #6 and later correspond to the portion of audio after
"to be or not to be".
Protobuf type google.cloud.speech.v1beta1.StreamingRecognizeResponse
Inherited Members
com.google.protobuf.GeneratedMessageV3.Builder.getUnknownFieldSetBuilder()
com.google.protobuf.GeneratedMessageV3.Builder.mergeUnknownLengthDelimitedField(int,com.google.protobuf.ByteString)
com.google.protobuf.GeneratedMessageV3.Builder.mergeUnknownVarintField(int,int)
com.google.protobuf.GeneratedMessageV3.Builder.parseUnknownField(com.google.protobuf.CodedInputStream,com.google.protobuf.ExtensionRegistryLite,int)
com.google.protobuf.GeneratedMessageV3.Builder.setUnknownFieldSetBuilder(com.google.protobuf.UnknownFieldSet.Builder)
Static Methods
getDescriptor()
public static final Descriptors.Descriptor getDescriptor()
Returns
Methods
addAllResults(Iterable<? extends StreamingRecognitionResult> values)
public StreamingRecognizeResponse.Builder addAllResults(Iterable<? extends StreamingRecognitionResult> values)
Output-only This repeated list contains zero or more results that
correspond to consecutive portions of the audio currently being processed.
It contains zero or one is_final=true
result (the newly settled portion),
followed by zero or more is_final=false
results.
repeated .google.cloud.speech.v1beta1.StreamingRecognitionResult results = 2;
Parameter
Name | Description |
values | Iterable<? extends com.google.cloud.speech.v1beta1.StreamingRecognitionResult>
|
Returns
addRepeatedField(Descriptors.FieldDescriptor field, Object value)
public StreamingRecognizeResponse.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters
Returns
Overrides
addResults(StreamingRecognitionResult value)
public StreamingRecognizeResponse.Builder addResults(StreamingRecognitionResult value)
Output-only This repeated list contains zero or more results that
correspond to consecutive portions of the audio currently being processed.
It contains zero or one is_final=true
result (the newly settled portion),
followed by zero or more is_final=false
results.
repeated .google.cloud.speech.v1beta1.StreamingRecognitionResult results = 2;
Parameter
Returns
addResults(StreamingRecognitionResult.Builder builderForValue)
public StreamingRecognizeResponse.Builder addResults(StreamingRecognitionResult.Builder builderForValue)
Output-only This repeated list contains zero or more results that
correspond to consecutive portions of the audio currently being processed.
It contains zero or one is_final=true
result (the newly settled portion),
followed by zero or more is_final=false
results.
repeated .google.cloud.speech.v1beta1.StreamingRecognitionResult results = 2;
Parameter
Returns
addResults(int index, StreamingRecognitionResult value)
public StreamingRecognizeResponse.Builder addResults(int index, StreamingRecognitionResult value)
Output-only This repeated list contains zero or more results that
correspond to consecutive portions of the audio currently being processed.
It contains zero or one is_final=true
result (the newly settled portion),
followed by zero or more is_final=false
results.
repeated .google.cloud.speech.v1beta1.StreamingRecognitionResult results = 2;
Parameters
Returns
addResults(int index, StreamingRecognitionResult.Builder builderForValue)
public StreamingRecognizeResponse.Builder addResults(int index, StreamingRecognitionResult.Builder builderForValue)
Output-only This repeated list contains zero or more results that
correspond to consecutive portions of the audio currently being processed.
It contains zero or one is_final=true
result (the newly settled portion),
followed by zero or more is_final=false
results.
repeated .google.cloud.speech.v1beta1.StreamingRecognitionResult results = 2;
Parameters
Returns
addResultsBuilder()
public StreamingRecognitionResult.Builder addResultsBuilder()
Output-only This repeated list contains zero or more results that
correspond to consecutive portions of the audio currently being processed.
It contains zero or one is_final=true
result (the newly settled portion),
followed by zero or more is_final=false
results.
repeated .google.cloud.speech.v1beta1.StreamingRecognitionResult results = 2;
Returns
addResultsBuilder(int index)
public StreamingRecognitionResult.Builder addResultsBuilder(int index)
Output-only This repeated list contains zero or more results that
correspond to consecutive portions of the audio currently being processed.
It contains zero or one is_final=true
result (the newly settled portion),
followed by zero or more is_final=false
results.
repeated .google.cloud.speech.v1beta1.StreamingRecognitionResult results = 2;
Parameter
Returns
build()
public StreamingRecognizeResponse build()
Returns
buildPartial()
public StreamingRecognizeResponse buildPartial()
Returns
clear()
public StreamingRecognizeResponse.Builder clear()
Returns
Overrides
clearEndpointerType()
public StreamingRecognizeResponse.Builder clearEndpointerType()
Output-only Indicates the type of endpointer event.
.google.cloud.speech.v1beta1.StreamingRecognizeResponse.EndpointerType endpointer_type = 4;
Returns
clearError()
public StreamingRecognizeResponse.Builder clearError()
Output-only If set, returns a google.rpc.Status message that
specifies the error for the operation.
.google.rpc.Status error = 1;
Returns
clearField(Descriptors.FieldDescriptor field)
public StreamingRecognizeResponse.Builder clearField(Descriptors.FieldDescriptor field)
Parameter
Returns
Overrides
clearOneof(Descriptors.OneofDescriptor oneof)
public StreamingRecognizeResponse.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter
Returns
Overrides
clearResultIndex()
public StreamingRecognizeResponse.Builder clearResultIndex()
Output-only Indicates the lowest index in the results
array that has
changed. The repeated StreamingRecognitionResult
results overwrite past
results at this index and higher.
int32 result_index = 3;
Returns
clearResults()
public StreamingRecognizeResponse.Builder clearResults()
Output-only This repeated list contains zero or more results that
correspond to consecutive portions of the audio currently being processed.
It contains zero or one is_final=true
result (the newly settled portion),
followed by zero or more is_final=false
results.
repeated .google.cloud.speech.v1beta1.StreamingRecognitionResult results = 2;
Returns
clone()
public StreamingRecognizeResponse.Builder clone()
Returns
Overrides
getDefaultInstanceForType()
public StreamingRecognizeResponse getDefaultInstanceForType()
Returns
getDescriptorForType()
public Descriptors.Descriptor getDescriptorForType()
Returns
Overrides
getEndpointerType()
public StreamingRecognizeResponse.EndpointerType getEndpointerType()
Output-only Indicates the type of endpointer event.
.google.cloud.speech.v1beta1.StreamingRecognizeResponse.EndpointerType endpointer_type = 4;
Returns
getEndpointerTypeValue()
public int getEndpointerTypeValue()
Output-only Indicates the type of endpointer event.
.google.cloud.speech.v1beta1.StreamingRecognizeResponse.EndpointerType endpointer_type = 4;
Returns
getError()
Output-only If set, returns a google.rpc.Status message that
specifies the error for the operation.
.google.rpc.Status error = 1;
Returns
Type | Description |
com.google.rpc.Status | |
getErrorBuilder()
public Status.Builder getErrorBuilder()
Output-only If set, returns a google.rpc.Status message that
specifies the error for the operation.
.google.rpc.Status error = 1;
Returns
Type | Description |
com.google.rpc.Status.Builder | |
getErrorOrBuilder()
public StatusOrBuilder getErrorOrBuilder()
Output-only If set, returns a google.rpc.Status message that
specifies the error for the operation.
.google.rpc.Status error = 1;
Returns
Type | Description |
com.google.rpc.StatusOrBuilder | |
getResultIndex()
public int getResultIndex()
Output-only Indicates the lowest index in the results
array that has
changed. The repeated StreamingRecognitionResult
results overwrite past
results at this index and higher.
int32 result_index = 3;
Returns
getResults(int index)
public StreamingRecognitionResult getResults(int index)
Output-only This repeated list contains zero or more results that
correspond to consecutive portions of the audio currently being processed.
It contains zero or one is_final=true
result (the newly settled portion),
followed by zero or more is_final=false
results.
repeated .google.cloud.speech.v1beta1.StreamingRecognitionResult results = 2;
Parameter
Returns
getResultsBuilder(int index)
public StreamingRecognitionResult.Builder getResultsBuilder(int index)
Output-only This repeated list contains zero or more results that
correspond to consecutive portions of the audio currently being processed.
It contains zero or one is_final=true
result (the newly settled portion),
followed by zero or more is_final=false
results.
repeated .google.cloud.speech.v1beta1.StreamingRecognitionResult results = 2;
Parameter
Returns
getResultsBuilderList()
public List<StreamingRecognitionResult.Builder> getResultsBuilderList()
Output-only This repeated list contains zero or more results that
correspond to consecutive portions of the audio currently being processed.
It contains zero or one is_final=true
result (the newly settled portion),
followed by zero or more is_final=false
results.
repeated .google.cloud.speech.v1beta1.StreamingRecognitionResult results = 2;
Returns
getResultsCount()
public int getResultsCount()
Output-only This repeated list contains zero or more results that
correspond to consecutive portions of the audio currently being processed.
It contains zero or one is_final=true
result (the newly settled portion),
followed by zero or more is_final=false
results.
repeated .google.cloud.speech.v1beta1.StreamingRecognitionResult results = 2;
Returns
getResultsList()
public List<StreamingRecognitionResult> getResultsList()
Output-only This repeated list contains zero or more results that
correspond to consecutive portions of the audio currently being processed.
It contains zero or one is_final=true
result (the newly settled portion),
followed by zero or more is_final=false
results.
repeated .google.cloud.speech.v1beta1.StreamingRecognitionResult results = 2;
Returns
getResultsOrBuilder(int index)
public StreamingRecognitionResultOrBuilder getResultsOrBuilder(int index)
Output-only This repeated list contains zero or more results that
correspond to consecutive portions of the audio currently being processed.
It contains zero or one is_final=true
result (the newly settled portion),
followed by zero or more is_final=false
results.
repeated .google.cloud.speech.v1beta1.StreamingRecognitionResult results = 2;
Parameter
Returns
getResultsOrBuilderList()
public List<? extends StreamingRecognitionResultOrBuilder> getResultsOrBuilderList()
Output-only This repeated list contains zero or more results that
correspond to consecutive portions of the audio currently being processed.
It contains zero or one is_final=true
result (the newly settled portion),
followed by zero or more is_final=false
results.
repeated .google.cloud.speech.v1beta1.StreamingRecognitionResult results = 2;
Returns
Type | Description |
List<? extends com.google.cloud.speech.v1beta1.StreamingRecognitionResultOrBuilder> | |
hasError()
public boolean hasError()
Output-only If set, returns a google.rpc.Status message that
specifies the error for the operation.
.google.rpc.Status error = 1;
Returns
internalGetFieldAccessorTable()
protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Overrides
isInitialized()
public final boolean isInitialized()
Returns
Overrides
mergeError(Status value)
public StreamingRecognizeResponse.Builder mergeError(Status value)
Output-only If set, returns a google.rpc.Status message that
specifies the error for the operation.
.google.rpc.Status error = 1;
Parameter
Name | Description |
value | com.google.rpc.Status
|
Returns
mergeFrom(StreamingRecognizeResponse other)
public StreamingRecognizeResponse.Builder mergeFrom(StreamingRecognizeResponse other)
Parameter
Returns
public StreamingRecognizeResponse.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Returns
Overrides
Exceptions
mergeFrom(Message other)
public StreamingRecognizeResponse.Builder mergeFrom(Message other)
Parameter
Returns
Overrides
mergeUnknownFields(UnknownFieldSet unknownFields)
public final StreamingRecognizeResponse.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter
Returns
Overrides
removeResults(int index)
public StreamingRecognizeResponse.Builder removeResults(int index)
Output-only This repeated list contains zero or more results that
correspond to consecutive portions of the audio currently being processed.
It contains zero or one is_final=true
result (the newly settled portion),
followed by zero or more is_final=false
results.
repeated .google.cloud.speech.v1beta1.StreamingRecognitionResult results = 2;
Parameter
Returns
setEndpointerType(StreamingRecognizeResponse.EndpointerType value)
public StreamingRecognizeResponse.Builder setEndpointerType(StreamingRecognizeResponse.EndpointerType value)
Output-only Indicates the type of endpointer event.
.google.cloud.speech.v1beta1.StreamingRecognizeResponse.EndpointerType endpointer_type = 4;
Parameter
Returns
setEndpointerTypeValue(int value)
public StreamingRecognizeResponse.Builder setEndpointerTypeValue(int value)
Output-only Indicates the type of endpointer event.
.google.cloud.speech.v1beta1.StreamingRecognizeResponse.EndpointerType endpointer_type = 4;
Parameter
Returns
setError(Status value)
public StreamingRecognizeResponse.Builder setError(Status value)
Output-only If set, returns a google.rpc.Status message that
specifies the error for the operation.
.google.rpc.Status error = 1;
Parameter
Name | Description |
value | com.google.rpc.Status
|
Returns
setError(Status.Builder builderForValue)
public StreamingRecognizeResponse.Builder setError(Status.Builder builderForValue)
Output-only If set, returns a google.rpc.Status message that
specifies the error for the operation.
.google.rpc.Status error = 1;
Parameter
Name | Description |
builderForValue | com.google.rpc.Status.Builder
|
Returns
setField(Descriptors.FieldDescriptor field, Object value)
public StreamingRecognizeResponse.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters
Returns
Overrides
setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
public StreamingRecognizeResponse.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)
Parameters
Returns
Overrides
setResultIndex(int value)
public StreamingRecognizeResponse.Builder setResultIndex(int value)
Output-only Indicates the lowest index in the results
array that has
changed. The repeated StreamingRecognitionResult
results overwrite past
results at this index and higher.
int32 result_index = 3;
Parameter
Returns
setResults(int index, StreamingRecognitionResult value)
public StreamingRecognizeResponse.Builder setResults(int index, StreamingRecognitionResult value)
Output-only This repeated list contains zero or more results that
correspond to consecutive portions of the audio currently being processed.
It contains zero or one is_final=true
result (the newly settled portion),
followed by zero or more is_final=false
results.
repeated .google.cloud.speech.v1beta1.StreamingRecognitionResult results = 2;
Parameters
Returns
setResults(int index, StreamingRecognitionResult.Builder builderForValue)
public StreamingRecognizeResponse.Builder setResults(int index, StreamingRecognitionResult.Builder builderForValue)
Output-only This repeated list contains zero or more results that
correspond to consecutive portions of the audio currently being processed.
It contains zero or one is_final=true
result (the newly settled portion),
followed by zero or more is_final=false
results.
repeated .google.cloud.speech.v1beta1.StreamingRecognitionResult results = 2;
Parameters
Returns
setUnknownFields(UnknownFieldSet unknownFields)
public final StreamingRecognizeResponse.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter
Returns
Overrides