edgetts

func (*Provider) Close ¶

func (p *Provider) Close()

Close releases resources held by the provider. If voice caching is enabled, its background goroutine (if any) is stopped. Close is safe to call multiple times.

func (*Provider) FormatRegistry ¶

func (p *Provider) FormatRegistry() *tts.FormatRegistry

FormatRegistry returns the provider's format registry.

func (*Provider) IsAvailable ¶

func (p *Provider) IsAvailable(ctx context.Context) bool

IsAvailable checks if the provider is available by attempting a WebSocket connection to the Edge TTS service.

To monitor availability continuously, wrap IsAvailable with tts.ProviderHealth:

p := edgetts.New()
health := tts.NewProviderHealth(func(ctx context.Context) bool {
    return p.IsAvailable(ctx)
}, tts.WithCheckInterval(5*time.Minute))
health.Start(context.Background())
defer health.Stop()
if health.IsHealthy() { /* provider is reachable */ }

func (*Provider) ListVoices ¶

func (p *Provider) ListVoices(ctx context.Context, locale string) ([]tts.Voice, error)

ListVoices lists available voices for the specified locale. When voice caching is enabled (via WithVoiceCache), the cached list is used and filtered by locale. Otherwise the list is fetched from the remote API.

func (*Provider) Name ¶

func (p *Provider) Name() string

func (*Provider) OutputOptions ¶

func (p *Provider) OutputOptions() []tts.OutputOption

OutputOptions 返回 EdgeTTS 支持的输出格式选项列表（按比特率从低到高排列）。

格式来源: 通过实际调用 Edge TTS WebSocket API 探测验证（2026-02-21）。 Edge TTS 注册表中共 37 个格式，其中 9 个验证为可用（FormatAvailable）， 28 个验证为不可用（FormatUnavailable）。本方法仅返回推荐的 5 种常用格式。 完整的 9 个可用格式可通过 provider.FormatRegistry().Available() 获取。

如需重新验证:

go test -v -tags probe -run TestEdgeTTSFormatProbe ./providers/edgetts/

使用示例:

provider := edgetts.New()
for _, opt := range provider.OutputOptions() {
    fmt.Printf("%-45s %s\n", opt.FormatID, opt.Label)
}

func (*Provider) SupportedFormats ¶

func (p *Provider) SupportedFormats() []tts.OutputFormat

SupportedFormats returns all formats verified as available in the registry.

func (*Provider) Synthesize ¶

func (p *Provider) Synthesize(ctx context.Context, opts *SynthesizeOptions) ([]byte, error)

Synthesize synthesizes text to speech

func (*Provider) SynthesizeStream ¶

func (p *Provider) SynthesizeStream(ctx context.Context, opts *SynthesizeOptions) (tts.AudioStream, error)

SynthesizeStream returns a streaming audio reader

func (*Provider) WithClientToken ¶

func (p *Provider) WithClientToken(token string) *Provider

WithClientToken sets custom client token

func (*Provider) WithConnectTimeout ¶

func (p *Provider) WithConnectTimeout(timeout time.Duration) *Provider

WithConnectTimeout sets WebSocket connection timeout

func (*Provider) WithFormatRegistry ¶

func (p *Provider) WithFormatRegistry(r *tts.FormatRegistry) *Provider

WithFormatRegistry replaces the default format registry with a custom one. Useful for testing or providers that need isolated format state.

func (*Provider) WithHTTPTimeout ¶

func (p *Provider) WithHTTPTimeout(timeout time.Duration) *Provider

WithHTTPTimeout sets HTTP client timeout

func (*Provider) WithMaxAttempts ¶

func (p *Provider) WithMaxAttempts(attempts int) *Provider

WithMaxAttempts sets maximum retry attempts (including first try)

func (*Provider) WithProxy ¶

func (p *Provider) WithProxy(proxyURL string) *Provider

WithProxy sets proxy URL

func (*Provider) WithReceiveTimeout ¶

func (p *Provider) WithReceiveTimeout(timeout time.Duration) *Provider

WithReceiveTimeout sets WebSocket receive timeout

func (*Provider) WithVoiceCache ¶

func (p *Provider) WithVoiceCache(opts ...tts.VoiceCacheOption) *Provider

WithVoiceCache enables voice list caching. The cache fetches the full voice list once and filters by locale on each ListVoices call. Pass VoiceCacheOption values (e.g. tts.WithTTL, tts.WithBackgroundRefresh) to customise cache behaviour.