Compartilhar via


Monitoramento de Tom

O monitoramento de tom monitora o fluxo de mídia de uma chamada para tons especificados. Um tom é descrito por suas frequências de componente e cadência. Uma implementação da API pode permitir que vários tons diferentes sejam monitorados simultaneamente. Um aplicativo pode marcar cada tom para poder distinguir os diferentes tons para os quais solicita detecção.

Um aplicativo pode habilitar ou desabilitar o monitoramento de tom em uma chamada especificada com lineMonitorTones. Com essa função, o aplicativo indica quais tons detectar em uma chamada especificada. Quando o monitoramento de tom está habilitado, os dígitos detectados fazem com que o aplicativo seja notificado com a mensagem LINE_MONITORTONE . Essa mensagem fornece o identificador de chamada no qual o tom foi detectado, bem como a marca do aplicativo para o tom.

O escopo do monitoramento de tom é associado pelo tempo de vida da chamada. O monitoramento de tom em uma chamada termina assim que a chamada se desconecta ou fica ociosa.

Observação

O monitoramento de tons, dígitos ou tipos de mídia geralmente requer o uso de recursos dos quais o provedor de serviços só pode ter uma quantidade finita. Uma solicitação de monitoramento poderá ser rejeitada se os recursos não estiverem disponíveis. Pelo mesmo motivo, um aplicativo deve desabilitar qualquer monitoramento desnecessário.