Class StreamingRecognizeResponse (4.24.0)

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 StreamingRecognizeResponses that might be returned while processing audio:

  1. endpointer_type: START_OF_SPEECH
  2. results { alternatives { transcript: "tube" } stability: 0.01 } result_index: 0
  3. results { alternatives { transcript: "to be a" } stability: 0.01 } result_index: 0
  4. results { alternatives { transcript: "to be" } stability: 0.9 } results { alternatives { transcript: " or not to be" } stability: 0.01 } result_index: 0
  5. 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
  6. results { alternatives { transcript: " that's" } stability: 0.01 } result_index: 1
  7. results { alternatives { transcript: " that is" } stability: 0.9 } results { alternatives { transcript: " the question" } stability: 0.01 } result_index: 1
  8. endpointer_type: END_OF_SPEECH
  9. results { alternatives { transcript: " that is the question" confidence: 0.98 } alternatives { transcript: " that was the question" } is_final: true } result_index: 1
  10. endpointer_type: END_OF_AUDIO Notes:
  11. 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".
  12. 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.
  13. The specific stability and confidence values shown above are only for illustrative purposes. Actual values may vary.
  14. 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

Static Fields

ENDPOINTER_TYPE_FIELD_NUMBER

public static final int ENDPOINTER_TYPE_FIELD_NUMBER
Field Value
TypeDescription
int

ERROR_FIELD_NUMBER

public static final int ERROR_FIELD_NUMBER
Field Value
TypeDescription
int

RESULTS_FIELD_NUMBER

public static final int RESULTS_FIELD_NUMBER
Field Value
TypeDescription
int

RESULT_INDEX_FIELD_NUMBER

public static final int RESULT_INDEX_FIELD_NUMBER
Field Value
TypeDescription
int

Static Methods

getDefaultInstance()

public static StreamingRecognizeResponse getDefaultInstance()
Returns
TypeDescription
StreamingRecognizeResponse

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
TypeDescription
Descriptor

newBuilder()

public static StreamingRecognizeResponse.Builder newBuilder()
Returns
TypeDescription
StreamingRecognizeResponse.Builder

newBuilder(StreamingRecognizeResponse prototype)

public static StreamingRecognizeResponse.Builder newBuilder(StreamingRecognizeResponse prototype)
Parameter
NameDescription
prototypeStreamingRecognizeResponse
Returns
TypeDescription
StreamingRecognizeResponse.Builder

parseDelimitedFrom(InputStream input)

public static StreamingRecognizeResponse parseDelimitedFrom(InputStream input)
Parameter
NameDescription
inputInputStream
Returns
TypeDescription
StreamingRecognizeResponse
Exceptions
TypeDescription
IOException

parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static StreamingRecognizeResponse parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
StreamingRecognizeResponse
Exceptions
TypeDescription
IOException

parseFrom(byte[] data)

public static StreamingRecognizeResponse parseFrom(byte[] data)
Parameter
NameDescription
databyte[]
Returns
TypeDescription
StreamingRecognizeResponse
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)

public static StreamingRecognizeResponse parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
databyte[]
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
StreamingRecognizeResponse
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteString data)

public static StreamingRecognizeResponse parseFrom(ByteString data)
Parameter
NameDescription
dataByteString
Returns
TypeDescription
StreamingRecognizeResponse
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)

public static StreamingRecognizeResponse parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
dataByteString
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
StreamingRecognizeResponse
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(CodedInputStream input)

public static StreamingRecognizeResponse parseFrom(CodedInputStream input)
Parameter
NameDescription
inputCodedInputStream
Returns
TypeDescription
StreamingRecognizeResponse
Exceptions
TypeDescription
IOException

parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public static StreamingRecognizeResponse parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
StreamingRecognizeResponse
Exceptions
TypeDescription
IOException

parseFrom(InputStream input)

public static StreamingRecognizeResponse parseFrom(InputStream input)
Parameter
NameDescription
inputInputStream
Returns
TypeDescription
StreamingRecognizeResponse
Exceptions
TypeDescription
IOException

parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static StreamingRecognizeResponse parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
StreamingRecognizeResponse
Exceptions
TypeDescription
IOException

parseFrom(ByteBuffer data)

public static StreamingRecognizeResponse parseFrom(ByteBuffer data)
Parameter
NameDescription
dataByteBuffer
Returns
TypeDescription
StreamingRecognizeResponse
Exceptions
TypeDescription
InvalidProtocolBufferException

parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)

public static StreamingRecognizeResponse parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
dataByteBuffer
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
StreamingRecognizeResponse
Exceptions
TypeDescription
InvalidProtocolBufferException

parser()

public static Parser<StreamingRecognizeResponse> parser()
Returns
TypeDescription
Parser<StreamingRecognizeResponse>

Methods

equals(Object obj)

public boolean equals(Object obj)
Parameter
NameDescription
objObject
Returns
TypeDescription
boolean
Overrides

getDefaultInstanceForType()

public StreamingRecognizeResponse getDefaultInstanceForType()
Returns
TypeDescription
StreamingRecognizeResponse

getEndpointerType()

public StreamingRecognizeResponse.EndpointerType getEndpointerType()

Output-only Indicates the type of endpointer event.

.google.cloud.speech.v1beta1.StreamingRecognizeResponse.EndpointerType endpointer_type = 4;

Returns
TypeDescription
StreamingRecognizeResponse.EndpointerType

getEndpointerTypeValue()

public int getEndpointerTypeValue()

Output-only Indicates the type of endpointer event.

.google.cloud.speech.v1beta1.StreamingRecognizeResponse.EndpointerType endpointer_type = 4;

Returns
TypeDescription
int

getError()

public Status getError()

Output-only If set, returns a google.rpc.Status message that specifies the error for the operation.

.google.rpc.Status error = 1;

Returns
TypeDescription
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
TypeDescription
com.google.rpc.StatusOrBuilder

getParserForType()

public Parser<StreamingRecognizeResponse> getParserForType()
Returns
TypeDescription
Parser<StreamingRecognizeResponse>
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
TypeDescription
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
NameDescription
indexint
Returns
TypeDescription
StreamingRecognitionResult

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
TypeDescription
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;

Returns
TypeDescription
List<StreamingRecognitionResult>

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
NameDescription
indexint
Returns
TypeDescription
StreamingRecognitionResultOrBuilder

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
TypeDescription
List<? extends com.google.cloud.speech.v1beta1.StreamingRecognitionResultOrBuilder>

getSerializedSize()

public int getSerializedSize()
Returns
TypeDescription
int
Overrides

getUnknownFields()

public final UnknownFieldSet getUnknownFields()
Returns
TypeDescription
UnknownFieldSet
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;

Returns
TypeDescription
boolean

hashCode()

public int hashCode()
Returns
TypeDescription
int
Overrides

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

newBuilderForType()

public StreamingRecognizeResponse.Builder newBuilderForType()
Returns
TypeDescription
StreamingRecognizeResponse.Builder

newBuilderForType(GeneratedMessageV3.BuilderParent parent)

protected StreamingRecognizeResponse.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
NameDescription
parentBuilderParent
Returns
TypeDescription
StreamingRecognizeResponse.Builder
Overrides

toBuilder()

public StreamingRecognizeResponse.Builder toBuilder()
Returns
TypeDescription
StreamingRecognizeResponse.Builder

writeTo(CodedOutputStream output)

public void writeTo(CodedOutputStream output)
Parameter
NameDescription
outputCodedOutputStream
Overrides
Exceptions
TypeDescription
IOException