MultimediaTools
PlayText
Disponible desde la versión 8.3.9.
Sintaxis:
PlayText(<Texto>, <Idioma>, <Velocidad>, <Timbre>, <ControladorDetenerReproduccion>, <PermitirEnSegundoPlano>)
Parámetros:
<Texto> (obligatorio)
Tipo: String.
Texto que se reproducirá.
<Idioma> (opcional)
Tipo: String, MetadataObject: Language.
ID de idioma según el estándar BCP 47 (por ejemplo, “en-US” para inglés o “ru-RU” para ruso). Si no se especifica, se verificará la posibilidad de pronunciar el texto en el idioma actual del sistema operativo. Si se indica un ID con un error o el idioma seleccionado no es compatible con el sistema, se generará una excepción.
<Velocidad> (opcional)
Tipo: Number.
Velocidad de reproducción del texto en el rango de 0.5 a 2.0.
Valor predeterminado: 1.0.
<Timbre> (opcional)
Tipo: Number.
Desplazamiento del patrón de voz en el rango de 0.5 a 2.0.
Valor predeterminado: 1.0.
<ControladorDetenerReproduccion> (opcional)
Tipo: CallbackDescription.
Contiene una descripción del procedimiento que se llamará al detener o pausar la reproducción de texto con los siguientes parámetros:
- <Adicionalmente> – valor que se especificó durante la creación del objeto CallbackDescription.
<PermitirEnSegundoPlano> (opcional)
Tipo: Boolean.
Permite la reproducción en segundo plano del texto.
Valor predeterminado: False.
Descripción:
Reproduce el texto especificado con el sintetizador de voz del dispositivo.
Si otra aplicación está reproduciendo sonido o se está ejecutando el método PlayAudio, se detiene el sonido y se reproduce el texto.
Si se genera una notificación del sistema o una notificación de sonido del método PlaySoundAlert mientras se reproduce el texto, la plataforma móvil pausa la reproducción del texto, reproduce el sonido de la notificación y luego continúa reproduciendo el texto.
Este método no es compatible en todos los dispositivos. Llame al método AudioRecordingSupported para verificar la compatibilidad del dispositivo.
Disponibilidad:
Cliente móvil, aplicación móvil (cliente).
Nota:
Si se reproduce otro texto cuando se llama al método, la plataforma móvil detiene el texto anterior y reproduce el nuevo. La reproducción del texto anterior no desencadena el evento de finalización de la reproducción.
Ver también:
MultimediaTools, método AudioRecordingSupported
Disponible desde:
Disponible desde la versión 8.3.9.
