Home Assistant Unofficial Reference 2024.12.1
tts.py
Go to the documentation of this file.
1 """Support for the demo for text-to-speech service."""
2 
3 from __future__ import annotations
4 
5 import os
6 from typing import Any
7 
8 import voluptuous as vol
9 
10 from homeassistant.components.tts import (
11  CONF_LANG,
12  PLATFORM_SCHEMA as TTS_PLATFORM_SCHEMA,
13  Provider,
14  TtsAudioType,
15 )
16 from homeassistant.core import HomeAssistant
17 from homeassistant.helpers.typing import ConfigType, DiscoveryInfoType
18 
19 SUPPORT_LANGUAGES = ["en", "de"]
20 
21 DEFAULT_LANG = "en"
22 
23 PLATFORM_SCHEMA = TTS_PLATFORM_SCHEMA.extend(
24  {vol.Optional(CONF_LANG, default=DEFAULT_LANG): vol.In(SUPPORT_LANGUAGES)}
25 )
26 
27 
29  hass: HomeAssistant,
30  config: ConfigType,
31  discovery_info: DiscoveryInfoType | None = None,
32 ) -> Provider:
33  """Set up Demo speech component."""
34  return DemoProvider(config.get(CONF_LANG, DEFAULT_LANG))
35 
36 
37 class DemoProvider(Provider):
38  """Demo speech API provider."""
39 
40  def __init__(self, lang: str) -> None:
41  """Initialize demo provider."""
42  self._lang_lang = lang
43  self.namename = "Demo"
44 
45  @property
46  def default_language(self) -> str:
47  """Return the default language."""
48  return self._lang_lang
49 
50  @property
51  def supported_languages(self) -> list[str]:
52  """Return list of supported languages."""
53  return SUPPORT_LANGUAGES
54 
55  @property
56  def supported_options(self) -> list[str]:
57  """Return list of supported options like voice, emotions."""
58  return ["voice", "age"]
59 
61  self, message: str, language: str, options: dict[str, Any]
62  ) -> TtsAudioType:
63  """Load TTS from demo."""
64  filename = os.path.join(os.path.dirname(__file__), "tts.mp3")
65  try:
66  with open(filename, "rb") as voice:
67  data = voice.read()
68  except OSError:
69  return (None, None)
70 
71  return ("mp3", data)
TtsAudioType get_tts_audio(self, str message, str language, dict[str, Any] options)
Definition: tts.py:62
Provider get_engine(HomeAssistant hass, ConfigType config, DiscoveryInfoType|None discovery_info=None)
Definition: tts.py:32
None open(self, **Any kwargs)
Definition: lock.py:86