RealtimeAPIClient

View as Markdown

Methods

addEventListener

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

addEventListener(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.

clearMediaBuffer(parameters?: ClearMediaBufferParameters): void

Parameters

parameters
ClearMediaBufferParameters

close

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

close(): void

conversationItemCreate

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

conversationItemCreate(parameters: Object): void

Parameters

parameters
ObjectRequired

conversationItemDelete

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

conversationItemDelete(parameters: Object): void

Parameters

parameters
ObjectRequired

conversationItemRetrieve

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

conversationItemRetrieve(parameters: Object): void

Parameters

parameters
ObjectRequired

conversationItemTruncate

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

conversationItemTruncate(parameters: Object): void

Parameters

parameters
ObjectRequired

id

Returns the RealtimeAPIClient id.

id(): string

inputAudioBufferAppend

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

inputAudioBufferAppend(parameters: Object): void

Parameters

parameters
ObjectRequired

inputAudioBufferClear

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

inputAudioBufferClear(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

inputAudioBufferCommit(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

outputAudioBufferClear(parameters: Object): void

Parameters

parameters
ObjectRequired

removeEventListener

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

removeEventListener(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

responseCancel(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

responseCreate(parameters: Object): void

Parameters

parameters
ObjectRequired

sendMediaTo

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

sendMediaTo(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

sessionUpdate(parameters: Object): void

Parameters

parameters
ObjectRequired

stopMediaTo

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

stopMediaTo(mediaUnit: VoxMediaUnit): void

Parameters

mediaUnit
VoxMediaUnitRequired

webSocketId

Returns the Inworld WebSocket id.

webSocketId(): string