You are viewing the Spanish (Mexico) site, but your language preference is set to English. Switch to English site →

Menu

Expand
Calificar esta página:

TwiML™ Voice: <Play>

El verbo <Play> reproduce un archivo de audio para el agente de llamada. Twilio recupera el archivo de una URL que proporciones.

Atributos del verbo

El verbo <Play> admite los siguientes atributos que modifican su comportamiento:

Nombre de atributo Valores permitidos Valor predeterminado
loop Número entero >= 0 1
digits Número entero >= 0, w No hay dígitos predeterminados para reproducir

loop

El atributo 'loop' especifica cuántas veces se reproduce el archivo de audio. El comportamiento predeterminado es reproducir el audio una vez. Especificar '0' hará que el verbo<Play> se detenga hasta que la llamada se cuelgue o se realicen 1000 iteraciones.

Utilízalo así:

Loading Code Sample...
        
        

        Using Play with loop

        digits

        El atributo ‘digits’ te permite reproducir tonos DTMF durante una llamada.

        Por ejemplo, si necesitas probar un sistema IVR, puedes utilizar esta función para simular que se pulsan los dígitos a fin de desplazarte por las opciones del menú.

        Incluye w para introducir una pausa 0,5 s entre tonos DTMF. Por ejemplo, 1w2 te dirá a Twilio que haga una pausa de 0,5 s antes de reproducir el tono DTMF 2. Para incluir 1 s de pausa, solo agrega ww.

        Si estás marcando un número de teléfono y necesitas reproducir tonos DTMF para introducir la extensión, debes utilizar el atributo [sendDigits][senddigits] en el [número][<number>].

        Sustantivos

        El "sustantivo" de un verbo TwiML es cualquier texto adicional o atributo anidado dentro del verbo que no es un verbo en sí; es aquello sobre lo que actúa el verbo. Estos son los sustantivos disponibles para <Play>:

        Sustantivo Descripción
        Texto sin formato La URL de un archivo de audio que Twilio recuperará y reproducirá al agente de llamada.

        Los parámetros HTTP estándar pasados por Twilio cuando se hacen peticiones a tus documentos TwiML, URL de acción y devoluciones de llamada no se pasan al hacer peticiones a URL de verbo <Play>.

        Tipos de archivos de audio compatibles

        Twilio admite los siguientes tipos de MIME de audio para archivos de audio que el verbo <Play> recupera:

        Tipo de MIME Descripción
        audio/mpeg mpeg con audio de 3 capas
        audio/wav formato wav de audio
        audio/onda formato wav audio
        audio/wave formato wav audio
        audio/aiff formato de archivo de intercambio de audio
        audio/x-aifc formato de archivo de intercambio de audio
        audio/x-aiff formato de archivo de intercambio de audio
        audio/x-gsm formato de audio GSM
        audio/gsm formato audio GSM
        audio/ulaw formato de audio μ-law

        Reglas de anidamiento

        No puedes anidar ningún verbo dentro de <Play>. Puedes anidar <Play> dentro de un verbo <Gather>, con una excepción importante: no puedes reproducir "dígitos" dentro de <Gather>.

        Ejemplos

        Ejemplo 1: reproducción simple

        Este documento TwiML le dice a Twilio que descargue el archivo cowbell.mp3 y reproduzca el audio al agente de llamada.

        Loading Code Sample...
              
              

              Simple Play

              Ejemplo 2: usar dígitos

              Vamos a probar nuestro menú IVR para asegurarnos de que los usuarios pueden navegar de forma correcta. Conocemos la longitud del saludo inicial y el número de menú que necesitamos introducir. Podemos añadir algunos caracteres 'w' iniciales para añadir una pausa. Cada carácter 'w' le dice a Twilio que espere 0,5 segundos en lugar de reproducir un dígito. Esto te permite ajustar la sincronización de cuando los dígitos comienzan a reproducirse para adaptarse al sistema telefónico que estás marcando.

              Loading Code Sample...
                    
                    

                    Using digits

                    Consejos y usos avanzados

                    • Twilio intentará almacenar en caché el archivo de audio la primera vez que se reproduzca. Esto significa que la reproducción del primer intento puede ser lenta debido al tiempo empleado en descargar el archivo desde el servidor remoto. Twilio puede reproducir un sonido de procesamiento mientras se descarga el archivo.
                    • Twilio almacenará en caché los archivos cuando los encabezados HTTP lo permitan (mediante ETag y los encabezados modificados por última vez). Responder con Cache-Control: no-cache, garantizará que Twilio siempre compruebe si el archivo ha cambiado, lo que permite que tu servidor web responda con una nueva versión o con un error 304 No modificado para indicar a Twilio que utilice su versión en caché.
                    • El audio reproducido mediante la red telefónica se transcodifica a un formato que la red telefónica entiende. Independiente de la calidad del archivo que nos proporciones, lo transcodificaremos para que se reproduzca de forma correcta. Esto puede dar como resultado una calidad inferior porque el número de teléfono no admite audio de alta velocidad de bits.
                    • Los archivos codificados con pérdidas a alta velocidad de bits, como los archivos mp3 de 128 kbps, tardarán más en transcodificarse y es posible que suenen peor que los archivos que están en formatos 8 kbps sin pérdidas. Esto se debe a la inevitable degradación que se produce cuando se convierten los formatos comprimidos con pérdida y al procesamiento que implica convertir de velocidades de bits más altas en velocidades de bits bajas.
                    • Reproducir con <Play> un archivo que dura más de 40 minutos puede dar como resulto una llamada perdida. Si necesitas usar <Play> en un archivo de más de 40 minutos, considera dividirlo en fragmentos más pequeños.
                    Calificar esta página:

                    ¿Necesitas ayuda?

                    Todos la necesitamos a veces; la programación es difícil. Obtén ayuda ahora de nuestro equipo de soporte, o recurre a la sabiduría de la multitud visitando Stack Overflow Collective de Twilio o navegando por la etiqueta de Twilio en Stack Overflow.

                    Loading Code Sample...
                          
                          
                          

                          Gracias por tus comentarios.

                          Selecciona los motivos de tus comentarios. La información adicional que nos brindas nos ayuda a mejorar nuestra documentación:

                          Enviando tus comentarios…
                          🎉 Gracias por tus comentarios.
                          Se produjo un error. Inténtalo de nuevo.

                          Gracias por tus comentarios.

                          thanks-feedback-gif