voice.updateConfig()

updateConfig() メソッドは、実行時にボイスプロバイダーの設定を更新することができます。これは、ボイス設定やAPIキー、その他のプロバイダー固有のオプションを新しいインスタンスを作成せずに変更したい場合に便利です。

使用例


import { OpenAIRealtimeVoice } from "@mastra/voice-openai-realtime";
 
// Initialize a real-time voice provider
const voice = new OpenAIRealtimeVoice({
  realtimeConfig: {
    model: "gpt-4o-mini-realtime",
    apiKey: process.env.OPENAI_API_KEY,
  },
  speaker: "alloy",
});
 
// Connect to the real-time service
await voice.connect();
 
// Later, update the configuration
voice.updateConfig({
  voice: "nova", // Change the default voice
  turn_detection: {
    type: "server_vad",
    threshold: 0.5,
    silence_duration_ms: 1000,
  },
});
 
// The next speak() call will use the new configuration
await voice.speak("Hello with my new voice!");

パラメーター

options:

Record<string, unknown>

更新する設定オプション。具体的なプロパティは、音声プロバイダーによって異なります。

戻り値

このメソッドは値を返しません。

設定オプション

各音声プロバイダーは異なる設定オプションをサポートしています。

OpenAI リアルタイム

voice?:

string

音声合成に使用するボイスID（例: 'alloy', 'echo', 'nova'）

turn_detection?:

{ type: string, threshold?: number, silence_duration_ms?: number }

ユーザーが話し終えたことを検出するための設定

注意事項

デフォルトの実装では、プロバイダーがこのメソッドをサポートしていない場合に警告が記録されます
設定の更新は通常、進行中の操作ではなく、以降の操作に適用されます
コンストラクタで設定できるすべてのプロパティが、実行時に更新できるわけではありません
具体的な動作は、voiceプロバイダーの実装によって異なります
リアルタイムのvoiceプロバイダーの場合、一部の設定変更にはサービスへの再接続が必要な場合があります