voice.close()

The close() method disconnects from a real-time voice service and cleans up resources. This is important for properly ending voice sessions and preventing resource leaks.

Usage example

import { OpenAIRealtimeVoice } from '@mastra/voice-openai-realtime'
import { getMicrophoneStream } from '@mastra/node-audio'

// Initialize a real-time voice provider
const voice = new OpenAIRealtimeVoice({
  realtimeConfig: {
    model: 'gpt-5.1-realtime',
    apiKey: process.env.OPENAI_API_KEY,
  },
})

// Connect to the real-time service
await voice.connect()

// Start a conversation
voice.speak("Hello, I'm your AI assistant!")

// Stream audio from a microphone
const microphoneStream = getMicrophoneStream()
voice.send(microphoneStream)

// When the conversation is complete
setTimeout(() => {
  // Close the connection and clean up resources
  voice.close()
  console.log('Voice session ended')
}, 60000) // End after 1 minute

Parameters

This method doesn't accept any parameters.

Return value

This method doesn't return a value.

Notes

• Always call close() when you're done with a real-time voice session to free up resources
• After calling close(), you'll need to call connect() again if you want to start a new session
• This method is primarily used with real-time voice providers that maintain persistent connections
• If called on a voice provider that doesn't support real-time connections, it will log a debug message and do nothing
• Failing to close connections can lead to resource leaks and potential billing issues with voice service providers