google-genai/com.google.genai.types/LiveClientRealtimeInput

LiveClientRealtimeInput

public abstract class LiveClientRealtimeInput extends JsonSerializable

User input that is sent in real time.

This is different from `LiveClientContent` in a few ways:

- Can be sent continuously without interruption to model generation. - If there is a need to mix data interleaved across the `LiveClientContent` and the `LiveClientRealtimeInput`, server attempts to optimize for best response, but there are no guarantees. - End of turn is not explicitly specified, but is rather derived from user activity (for example, end of speech). - Even before the end of turn, the data is processed incrementally to optimize for a fast start of the response from the model. - Is always assumed to be the user's input (cannot be used to populate conversation history).

Constructors

LiveClientRealtimeInput

public void LiveClientRealtimeInput()

Types

public abstract class Builder

Builder for LiveClientRealtimeInput.

Properties

MAX_READ_LENGTH_PROPERTY

public final static String MAX_READ_LENGTH_PROPERTY

System property to override the default max JSON string length (20MB) in read constraints.

Functions

public abstract Optional<ActivityEnd> activityEnd()

Marks the end of user activity.

public abstract Optional<ActivityStart> activityStart()

Marks the start of user activity.

public abstract Optional<Blob> audio()

The realtime audio input stream.

public abstract Optional<Boolean> audioStreamEnd()

Indicates that the audio stream has ended, e.g.

public static LiveClientRealtimeInput.Builder builder()

Instantiates a builder for LiveClientRealtimeInput.

public static LiveClientRealtimeInput fromJson(String jsonString)

Deserializes a JSON string to a LiveClientRealtimeInput object.

@InternalApi()

public static T fromJsonNode<T extends JsonSerializable>(JsonNode jsonNode, Class<T> clazz)

Deserializes a JsonNode to an object of the given type.

@InternalApi()

public static T fromJsonString<T extends JsonSerializable>(String jsonString, Class<T> clazz)

Deserializes a Json string to an object of the given type.

public abstract Optional<List<Blob>> mediaChunks()

Inlined bytes data for media input.

public static ObjectMapper objectMapper()

setMaxReadLength

public static void setMaxReadLength(int maxReadLength)

Overrides the default maximum JSON string length (20MB) for the JSON parser.

stringToJsonNode

public static JsonNode stringToJsonNode(String string)

Converts a Json string to a JsonNode.

public abstract Optional<String> text()

The realtime text input stream.

public abstract LiveClientRealtimeInput.Builder toBuilder()

Creates a builder with the same values as this instance.

public String toJson()

Serializes the instance to a Json string.

public static JsonNode toJsonNode(Object object)

Serializes an object to a JsonNode.

public static String toJsonString(Object object)

Serializes an object to a Json string.

public abstract Optional<Blob> video()

The realtime video input stream.