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

Menu

Expand
Classifique esta página:

TwiML™ Voice: <Play>

O verbo <Play> reproduz um arquivo de áudio de volta para o autor da chamada. A Twilio recupera o arquivo de um URL fornecido.

Atributos do verbo

O verbo <Play> é compatível com seguintes atributos que modificam seu comportamento:

Nome do atributo Valores permitidos Valor padrão
loop integer >= 0 1
digits integer >= 0, w sem dígitos padrão para Play

loop

O atributo 'loop' especifica quantas vezes o arquivo de áudio é reproduzido. O comportamento padrão é reproduzir o áudio uma vez. A especificação de '0' fará com que o verbo <Play> fique em loop até que a chamada seja desligada ou até que mil iterações sejam realizadas.

Use‐o desta forma:

        
        
        

        Using Play with loop

        dígitos

        O atributo 'digits' permite reproduzir tons DTMF durante uma chamada.

        Por exemplo, se você precisar testar um sistema URA, poderá usar esse recurso para simular os dígitos que estão sendo pressionados para navegar pelas opções do menu.

        Inclua w para introduzir uma pausa de 0,5s entre os tons DTMF. Por exemplo, 1w2 dirá a Twilio para pausar 0,5 s antes de reproduzir o tom DTMF 2. Para incluir uma pausa de 1 s, basta acrescentar ww.

        Se você estiver discando um número de telefone e precisar reproduzir tons DTMF para inserir o ramal, deverá usar o atributo [sendDigits][sendDigits] para [<Number>][number].

        Substantivos

        O "substantivo" de um verbo TwiML é qualquer texto ou atributo adicional aninhado dentro do verbo e que não é o próprio verbo; é sobre o que o verbo age. Estes são os substantivos disponíveis para <Play>:

        Substantivo Descrição
        plain text O URL de um arquivo de áudio que a Twilio recupera e reproduz para o autor da chamada.

        Os parâmetros HTTP padrão passados pela Twilio ao fazer solicitações aos documentos TwiML, URLs de ação e retornos de chamada não são transmitidos ao fazer solicitações para URLs do verbo <Play>.

        Tipos de arquivos de áudio compatíveis

        A Twilio é compatível com os seguintes áudios do tipo MIME para arquivos de áudio recuperados pelo verbo <Play>:

        Tipo MIME Descrição
        audio/mpeg áudio mpeg layer-3
        audio/wav formato de áudio wav
        audio/wave formato de áudio wav
        audio/x-wav formato de áudio wav
        audio/aiff formato de arquivo de áudio interchange
        audio/x-aifc formato de arquivo de áudio interchange
        audio/x-aiff formato de arquivo de áudio interchange
        audio/x-gsm formato de áudio GSM
        audio/gsm formato de áudio GSM
        audio/ulaw formato de áudio μ-law

        Regras de aninhamento

        Não é possível aninhar verbos dentro de <Play>. Você pode aninhar <Play> dentro de um verbo <Gather>, com uma exceção importante: não é possível reproduzir "digits" em um <Gather>.

        Exemplos

        Exemplo 1: Reprodução simples

        Este documento TwiML diz à Twilio para fazer o download do arquivo cowbell.mp3 e reproduzir o áudio para o autor da chamada.

              
              
              

              Simple Play

              Exemplo 2: Usando dígitos

              Vamos testar nosso menu URA para garantir que os usuários possam navegar corretamente. Sabemos que a duração da saudação inicial e o número do menu que precisamos inserir. Podemos adicionar alguns caracteres 'w' para adicionar uma pausa. Cada caractere 'w' diz à Twilio para aguardar 0,5 segundos em vez de reproduzir um dígito. Isso permite ajustar o tempo de quando os dígitos começam a ser reproduzidos de acordo com o sistema telefônico que você está discando.

                    
                    
                    

                    Using digits

                    Dicas e usos avançados

                    • A Twilio tentará armazenar o arquivo de áudio em cache na primeira vez que ele for reproduzido. Isso significa que a primeira tentativa pode demorar a ser reproduzida devido ao tempo gasto fazendo o download do arquivo do servidor remoto. A Twilio pode reproduzir um som de processamento enquanto o arquivo está sendo baixado.
                    • A Twilio armazenará os arquivos em cache quando os cabeçalhos HTTP permitirem (por meio de cabeçalhos ETag e Last-Modified). Responder com Cache-Control: no-cache garante que a Twilio sempre verifique se o arquivo foi alterado, permitindo que seu servidor Web responda com uma nova versão ou com um código 304 Não Modificado para instruir a Twilio a usar sua versão armazenada em cache.
                    • O áudio reproduzido pela rede telefônica é transcodificado para um formato que a rede telefônica entende. Independentemente da qualidade do arquivo fornecido, nós transcodificaremos para que ele seja reproduzido corretamente. Isso pode resultar em uma qualidade inferior porque o número de telefone não é compatível com o áudio com alta taxa de bits.
                    • Arquivos codificados com perdas e alta taxa de bits, como arquivos mp3 de 128kbps, levarão mais tempo para serem transcodificados e, possivelmente, terão um som pior do que arquivos que estão em formatos 8kbps sem perdas. Isso se deve à inevitável degradação que ocorre ao converter de formatos compactados com perdas e ao processamento envolvido na conversão de taxas de bits mais altas para taxas de bits baixas.
                    • Reproduzir um arquivo <Play> com mais de 40 minutos pode resultar em uma chamada interrompida. Se você precisar reproduzir um arquivo <Play> com mais de 40 minutos, considere dividi‐lo em blocos menores.
                    Classifique esta página:

                    Precisa de ajuda?

                    Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.

                          
                          
                          

                          Obrigado pelo seu feedback!

                          Selecione o(s) motivo(s) para seu feedback. As informações adicionais que você fornece nos ajudam a melhorar nossa documentação:

                          Enviando seu feedback...
                          🎉 Obrigado pelo seu feedback!
                          Algo deu errado. Tente novamente.

                          Obrigado pelo seu feedback!

                          thanks-feedback-gif