LiveSession
@PublicPreviewAPI
public final classLiveSession
This class is deprecated.
The Vertex AI in Firebase SDK (firebase-vertexai) has been replaced with the FirebaseAI SDK (firebase-ai) to accommodate the evolving set of supported features and services.For migration details, see the migration guide: https://firebase.google.com/docs/vertex-ai/migrate-to-latest-sdk
Represents a live WebSocket session capable of streaming content to and from the server.
Summary
Public methods | |
|---|---|
final void | close()Closes the client session. |
final @NonNullFlow<@NonNullLiveServerMessage> | receive()Receives responses from the model for both streaming and standard requests. |
final void | Sends |
final void | Sends text to the model. |
final void | sendFunctionResponse(Sends function calling responses to the model. |
final void | sendMediaStream(@NonNullList<@NonNullMediaData> mediaChunks)Streams client data to the model. |
final void | @RequiresPermission(value = "android.permission.RECORD_AUDIO")Starts an audio conversation with the model, which can only be stopped using |
final void | Stops the audio conversation with the model. |
final void | Stops receiving from the model. |
Public methods
close
public final void close()
Closes the client session.
Once aLiveSession is closed, it can not be reopened; you'll need to start a newLiveSession.
| See also | |
|---|---|
stopReceiving |
receive
public final @NonNullFlow<@NonNullLiveServerMessage> receive()
Receives responses from the model for both streaming and standard requests.
Callclose to stop receiving responses from the model.
| Returns | |
|---|---|
@NonNullFlow<@NonNullLiveServerMessage> | A |
| Throws | |
|---|---|
com.google.firebase.vertexai.type.SessionAlreadyReceivingException com.google.firebase.vertexai.type.SessionAlreadyReceivingException | when the session is already receiving. |
| See also | |
|---|---|
stopReceiving |
send
public final void send(@NonNullContent content)
Sendsdata to the model.
Calling this afterstartAudioConversation will play the response audio immediately.
send
public final void send(@NonNullString text)
Sends text to the model.
Calling this afterstartAudioConversation will play the response audio immediately.
sendFunctionResponse
public final void sendFunctionResponse(
@NonNullList<@NonNullFunctionResponsePart> functionList
)
Sends function calling responses to the model.
NOTE: If you're usingstartAudioConversation, the method will handle sending function responses to the model for you. You donot need to call this method in that case.
| Parameters | |
|---|---|
@NonNullList<@NonNullFunctionResponsePart> functionList | The list of |
sendMediaStream
public final void sendMediaStream(@NonNullList<@NonNullMediaData> mediaChunks)
Streams client data to the model.
Calling this afterstartAudioConversation will play the response audio immediately.
startAudioConversation
@RequiresPermission(value = "android.permission.RECORD_AUDIO")
public final void startAudioConversation(
Function1<@NonNullFunctionCallPart, @NonNullFunctionResponsePart> functionCallHandler
)
Starts an audio conversation with the model, which can only be stopped usingstopAudioConversation orclose.
| Parameters | |
|---|---|
Function1<@NonNullFunctionCallPart, @NonNullFunctionResponsePart> functionCallHandler | A callback function that is invoked whenever the model receives a function call. The |
stopAudioConversation
public final void stopAudioConversation()
Stops the audio conversation with the model.
This only needs to be called after a previous call tostartAudioConversation.
If there is no audio conversation currently active, this function does nothing.
stopReceiving
public final void stopReceiving()
Stops receiving from the model.
If this function is called during an ongoing audio conversation, the model's response will not be received, and no audio will be played; the live session object will no longer receive data from the server.
To resume receiving data, you must either handle it directly usingreceive, or indirectly by usingstartAudioConversation.
| See also | |
|---|---|
close |
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-21 UTC.