public final class StreamingRecognizeResponse extends GeneratedMessageV3 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.<ListT>makeMutableCopy(ListT)
com.google.protobuf.GeneratedMessageV3.<ListT>makeMutableCopy(ListT,int)
com.google.protobuf.GeneratedMessageV3.<T>emptyList(java.lang.Class<T>)
com.google.protobuf.GeneratedMessageV3.internalGetMapFieldReflection(int)
Static Fields
ENDPOINTER_TYPE_FIELD_NUMBER
public static final int ENDPOINTER_TYPE_FIELD_NUMBER
Field Value |
Type |
Description |
int |
|
ERROR_FIELD_NUMBER
public static final int ERROR_FIELD_NUMBER
Field Value |
Type |
Description |
int |
|
RESULTS_FIELD_NUMBER
public static final int RESULTS_FIELD_NUMBER
Field Value |
Type |
Description |
int |
|
RESULT_INDEX_FIELD_NUMBER
public static final int RESULT_INDEX_FIELD_NUMBER
Field Value |
Type |
Description |
int |
|
Static Methods
getDefaultInstance()
public static StreamingRecognizeResponse getDefaultInstance()
getDescriptor()
public static final Descriptors.Descriptor getDescriptor()
newBuilder()
public static StreamingRecognizeResponse.Builder newBuilder()
newBuilder(StreamingRecognizeResponse prototype)
public static StreamingRecognizeResponse.Builder newBuilder(StreamingRecognizeResponse prototype)
public static StreamingRecognizeResponse parseDelimitedFrom(InputStream input)
public static StreamingRecognizeResponse parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
parseFrom(byte[] data)
public static StreamingRecognizeResponse parseFrom(byte[] data)
Parameter |
Name |
Description |
data |
byte[]
|
parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
public static StreamingRecognizeResponse parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
parseFrom(ByteString data)
public static StreamingRecognizeResponse parseFrom(ByteString data)
parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
public static StreamingRecognizeResponse parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
public static StreamingRecognizeResponse parseFrom(CodedInputStream input)
public static StreamingRecognizeResponse parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
public static StreamingRecognizeResponse parseFrom(InputStream input)
public static StreamingRecognizeResponse parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
parseFrom(ByteBuffer data)
public static StreamingRecognizeResponse parseFrom(ByteBuffer data)
parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
public static StreamingRecognizeResponse parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
parser()
public static Parser<StreamingRecognizeResponse> parser()
Methods
equals(Object obj)
public boolean equals(Object obj)
Parameter |
Name |
Description |
obj |
Object
|
Overrides
getDefaultInstanceForType()
public StreamingRecognizeResponse getDefaultInstanceForType()
getEndpointerType()
public StreamingRecognizeResponse.EndpointerType getEndpointerType()
Output-only Indicates the type of endpointer event.
.google.cloud.speech.v1beta1.StreamingRecognizeResponse.EndpointerType endpointer_type = 4;
getEndpointerTypeValue()
public int getEndpointerTypeValue()
Output-only Indicates the type of endpointer event.
.google.cloud.speech.v1beta1.StreamingRecognizeResponse.EndpointerType endpointer_type = 4;
Returns |
Type |
Description |
int |
|
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 |
|
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 |
|
getParserForType()
public Parser<StreamingRecognizeResponse> getParserForType()
Overrides
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 |
Type |
Description |
int |
|
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 |
Name |
Description |
index |
int
|
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 |
Type |
Description |
int |
|
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;
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 |
Name |
Description |
index |
int
|
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> |
|
getSerializedSize()
public int getSerializedSize()
Returns |
Type |
Description |
int |
|
Overrides
getUnknownFields()
public final UnknownFieldSet getUnknownFields()
Overrides
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;
hashCode()
Returns |
Type |
Description |
int |
|
Overrides
internalGetFieldAccessorTable()
protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Overrides
isInitialized()
public final boolean isInitialized()
Overrides
newBuilderForType()
public StreamingRecognizeResponse.Builder newBuilderForType()
newBuilderForType(GeneratedMessageV3.BuilderParent parent)
protected StreamingRecognizeResponse.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Overrides
toBuilder()
public StreamingRecognizeResponse.Builder toBuilder()
writeTo(CodedOutputStream output)
public void writeTo(CodedOutputStream output)
Overrides