public final class StreamingRecognizeResponse extends GeneratedMessageV3 implements StreamingRecognizeResponseOrBuilder
StreamingRecognizeResponse is the only message returned to the client by
StreamingRecognize. A series of zero or more StreamingRecognizeResponse
messages are streamed back to the client. If there is no recognizable
audio, and single_utterance is set to false, then no messages are streamed
back to the client.
Here's an example of a series of StreamingRecognizeResponses that might be
returned while processing audio:
- results { alternatives { transcript: "tube" } stability: 0.01 }
- results { alternatives { transcript: "to be a" } stability: 0.01 }
- results { alternatives { transcript: "to be" } stability: 0.9 }
results { alternatives { transcript: " or not to be" } stability: 0.01 }
- results { alternatives { transcript: "to be or not to be"
confidence: 0.92 }
alternatives { transcript: "to bee or not to bee" }
is_final: true }
- results { alternatives { transcript: " that's" } stability: 0.01 }
- results { alternatives { transcript: " that is" } stability: 0.9 }
results { alternatives { transcript: " the question" } stability: 0.01 }
- results { alternatives { transcript: " that is the question"
confidence: 0.98 }
alternatives { transcript: " that was the question" }
is_final: true }
Notes:
- Only two of the above responses #4 and #7 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. #3 and #6 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.
- In each response, only one of these fields will be set:
error,
speech_event_type, or
one or more (repeated) results.
Protobuf type google.cloud.speech.v1.StreamingRecognizeResponse
Static Fields
ERROR_FIELD_NUMBER
public static final int ERROR_FIELD_NUMBER
| Field Value |
|---|
| Type | Description |
int | |
REQUEST_ID_FIELD_NUMBER
public static final int REQUEST_ID_FIELD_NUMBER
| Field Value |
|---|
| Type | Description |
int | |
RESULTS_FIELD_NUMBER
public static final int RESULTS_FIELD_NUMBER
| Field Value |
|---|
| Type | Description |
int | |
SPEECH_ADAPTATION_INFO_FIELD_NUMBER
public static final int SPEECH_ADAPTATION_INFO_FIELD_NUMBER
| Field Value |
|---|
| Type | Description |
int | |
SPEECH_EVENT_TIME_FIELD_NUMBER
public static final int SPEECH_EVENT_TIME_FIELD_NUMBER
| Field Value |
|---|
| Type | Description |
int | |
SPEECH_EVENT_TYPE_FIELD_NUMBER
public static final int SPEECH_EVENT_TYPE_FIELD_NUMBER
| Field Value |
|---|
| Type | Description |
int | |
TOTAL_BILLED_TIME_FIELD_NUMBER
public static final int TOTAL_BILLED_TIME_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()
getError()
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 | The error.
|
getErrorOrBuilder()
public StatusOrBuilder getErrorOrBuilder()
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
getRequestId()
public long getRequestId()
The ID associated with the request. This is a unique ID specific only to
the given request.
int64 request_id = 10;
| Returns |
|---|
| Type | Description |
long | The requestId.
|
getResults(int index)
public StreamingRecognitionResult getResults(int index)
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 (the interim results).
repeated .google.cloud.speech.v1.StreamingRecognitionResult results = 2;
| Parameter |
|---|
| Name | Description |
index | int
|
getResultsCount()
public int getResultsCount()
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 (the interim results).
repeated .google.cloud.speech.v1.StreamingRecognitionResult results = 2;
| Returns |
|---|
| Type | Description |
int | |
getResultsList()
public List<StreamingRecognitionResult> getResultsList()
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 (the interim results).
repeated .google.cloud.speech.v1.StreamingRecognitionResult results = 2;
getResultsOrBuilder(int index)
public StreamingRecognitionResultOrBuilder getResultsOrBuilder(int index)
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 (the interim results).
repeated .google.cloud.speech.v1.StreamingRecognitionResult results = 2;
| Parameter |
|---|
| Name | Description |
index | int
|
getResultsOrBuilderList()
public List<? extends StreamingRecognitionResultOrBuilder> getResultsOrBuilderList()
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 (the interim results).
repeated .google.cloud.speech.v1.StreamingRecognitionResult results = 2;
| Returns |
|---|
| Type | Description |
List<? extends com.google.cloud.speech.v1.StreamingRecognitionResultOrBuilder> | |
getSerializedSize()
public int getSerializedSize()
| Returns |
|---|
| Type | Description |
int | |
Overrides
getSpeechAdaptationInfo()
public SpeechAdaptationInfo getSpeechAdaptationInfo()
Provides information on adaptation behavior in response
.google.cloud.speech.v1.SpeechAdaptationInfo speech_adaptation_info = 9;
getSpeechAdaptationInfoOrBuilder()
public SpeechAdaptationInfoOrBuilder getSpeechAdaptationInfoOrBuilder()
Provides information on adaptation behavior in response
.google.cloud.speech.v1.SpeechAdaptationInfo speech_adaptation_info = 9;
getSpeechEventTime()
public Duration getSpeechEventTime()
Time offset between the beginning of the audio and event emission.
.google.protobuf.Duration speech_event_time = 8;
| Returns |
|---|
| Type | Description |
Duration | The speechEventTime.
|
getSpeechEventTimeOrBuilder()
public DurationOrBuilder getSpeechEventTimeOrBuilder()
Time offset between the beginning of the audio and event emission.
.google.protobuf.Duration speech_event_time = 8;
getSpeechEventType()
public StreamingRecognizeResponse.SpeechEventType getSpeechEventType()
Indicates the type of speech event.
.google.cloud.speech.v1.StreamingRecognizeResponse.SpeechEventType speech_event_type = 4;
getSpeechEventTypeValue()
public int getSpeechEventTypeValue()
Indicates the type of speech event.
.google.cloud.speech.v1.StreamingRecognizeResponse.SpeechEventType speech_event_type = 4;
| Returns |
|---|
| Type | Description |
int | The enum numeric value on the wire for speechEventType.
|
getTotalBilledTime()
public Duration getTotalBilledTime()
When available, billed audio seconds for the stream.
Set only if this is the last response in the stream.
.google.protobuf.Duration total_billed_time = 5;
| Returns |
|---|
| Type | Description |
Duration | The totalBilledTime.
|
getTotalBilledTimeOrBuilder()
public DurationOrBuilder getTotalBilledTimeOrBuilder()
When available, billed audio seconds for the stream.
Set only if this is the last response in the stream.
.google.protobuf.Duration total_billed_time = 5;
getUnknownFields()
public final UnknownFieldSet getUnknownFields()
Overrides
hasError()
public boolean hasError()
If set, returns a google.rpc.Status message that
specifies the error for the operation.
.google.rpc.Status error = 1;
| Returns |
|---|
| Type | Description |
boolean | Whether the error field is set.
|
hasSpeechAdaptationInfo()
public boolean hasSpeechAdaptationInfo()
Provides information on adaptation behavior in response
.google.cloud.speech.v1.SpeechAdaptationInfo speech_adaptation_info = 9;
| Returns |
|---|
| Type | Description |
boolean | Whether the speechAdaptationInfo field is set.
|
hasSpeechEventTime()
public boolean hasSpeechEventTime()
Time offset between the beginning of the audio and event emission.
.google.protobuf.Duration speech_event_time = 8;
| Returns |
|---|
| Type | Description |
boolean | Whether the speechEventTime field is set.
|
hasTotalBilledTime()
public boolean hasTotalBilledTime()
When available, billed audio seconds for the stream.
Set only if this is the last response in the stream.
.google.protobuf.Duration total_billed_time = 5;
| Returns |
|---|
| Type | Description |
boolean | Whether the totalBilledTime field is set.
|
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
newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Overrides
toBuilder()
public StreamingRecognizeResponse.Builder toBuilder()
writeTo(CodedOutputStream output)
public void writeTo(CodedOutputStream output)
Overrides
