RealtimeAPIClient

View as MarkdownOpen in Claude

Methods

addEventListener

Adds a handler for the specified Inworld.RealtimeAPIEvents or Inworld.Events event.

1addEventListener(event: Inworld.Events | Inworld.RealtimeAPIEvents | T, callback: (event: Inworld._RealtimeAPIClientEvents[T]) => any): void

Parameters

event
Inworld.Events | Inworld.RealtimeAPIEvents | TRequired
callback
(event: Inworld._RealtimeAPIClientEvents[T]) => anyRequired

clearMediaBuffer

Clears the Inworld WebSocket media buffer.

1clearMediaBuffer(parameters?: ClearMediaBufferParameters): void

Parameters

parameters
ClearMediaBufferParameters

close

Closes the Inworld connection (over WebSocket) or connection attempt.

1close(): void

conversationItemCreate

Add a conversation item (message, function call result, etc.). https://docs.inworld.ai/api-reference/realtimeAPI/realtime/realtime-websocket

1conversationItemCreate(parameters: Object): void

Parameters

parameters
ObjectRequired

conversationItemDelete

Delete a conversation item by ID. https://docs.inworld.ai/api-reference/realtimeAPI/realtime/realtime-websocket

1conversationItemDelete(parameters: Object): void

Parameters

parameters
ObjectRequired

conversationItemRetrieve

Retrieve a conversation item by ID. https://docs.inworld.ai/api-reference/realtimeAPI/realtime/realtime-websocket

1conversationItemRetrieve(parameters: Object): void

Parameters

parameters
ObjectRequired

conversationItemTruncate

Truncate an assistant message’s audio. https://docs.inworld.ai/api-reference/realtimeAPI/realtime/realtime-websocket

1conversationItemTruncate(parameters: Object): void

Parameters

parameters
ObjectRequired

id

Returns the RealtimeAPIClient id.

1id(): string

inputAudioBufferAppend

Append audio bytes to the input buffer. https://docs.inworld.ai/api-reference/realtimeAPI/realtime/realtime-websocket

1inputAudioBufferAppend(parameters: Object): void

Parameters

parameters
ObjectRequired

inputAudioBufferClear

Discard all audio in the input buffer. https://docs.inworld.ai/api-reference/realtimeAPI/realtime/realtime-websocket

1inputAudioBufferClear(parameters: Object): void

Parameters

parameters
ObjectRequired

inputAudioBufferCommit

Commit the buffered audio as a user message. https://docs.inworld.ai/api-reference/realtimeAPI/realtime/realtime-websocket

1inputAudioBufferCommit(parameters: Object): void

Parameters

parameters
ObjectRequired

outputAudioBufferClear

Clear the server’s output audio buffer, stopping playback. https://docs.inworld.ai/api-reference/realtimeAPI/realtime/realtime-websocket

1outputAudioBufferClear(parameters: Object): void

Parameters

parameters
ObjectRequired

removeEventListener

Removes a handler for the specified Inworld.RealtimeAPIEvents or Inworld.Events event.

1removeEventListener(event: Inworld.Events | Inworld.RealtimeAPIEvents | T, callback?: (event: Inworld._RealtimeAPIClientEvents[T]) => any): void

Parameters

event
Inworld.Events | Inworld.RealtimeAPIEvents | TRequired
callback
(event: Inworld._RealtimeAPIClientEvents[T]) => any

responseCancel

Cancel an in-progress response. https://docs.inworld.ai/api-reference/realtimeAPI/realtime/realtime-websocket

1responseCancel(parameters: Object): void

Parameters

parameters
ObjectRequired

responseCreate

Trigger a model response. The server streams back response events. https://docs.inworld.ai/api-reference/realtimeAPI/realtime/realtime-websocket

1responseCreate(parameters: Object): void

Parameters

parameters
ObjectRequired

sendMediaTo

Starts sending media from the Inworld (via WebSocket) to the media unit.

1sendMediaTo(mediaUnit: VoxMediaUnit, parameters?: SendMediaParameters): void

Parameters

mediaUnit
VoxMediaUnitRequired
parameters
SendMediaParameters

sessionUpdate

Update the session configuration. The server responds with a session.updated event. https://docs.inworld.ai/api-reference/realtimeAPI/realtime/realtime-websocket

1sessionUpdate(parameters: Object): void

Parameters

parameters
ObjectRequired

stopMediaTo

Stops sending media from the Inworld (via WebSocket) to the media unit.

1stopMediaTo(mediaUnit: VoxMediaUnit): void

Parameters

mediaUnit
VoxMediaUnitRequired

webSocketId

Returns the Inworld WebSocket id.

1webSocketId(): string