Compreensão VoiceFocus - Amazon Chime SDK

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Compreensão VoiceFocus

Permite aplicar a supressão de ruído do Amazon Voice Focus aos trechos de chamadas de entrada e saída em uma chamada pública de rede telefônica comutada (). PSTN Quando você aplica o Amazon Voice Focus, ele reduz o ruído de fundo sem afetar a fala humana. Isso pode facilitar a audição do alto-falante atual.

Para criar segmentos de chamada de entrada, você usa uma SIPregra que invoca uma AWS Lambda função com um evento. NewInboundCall Você pode criar segmentos de chamada de saída usando a CallAndBridge ação ou usando um CreateSIPMediaApplicationCallAPIoperação. Para obter mais informações sobre o Amazon Voice Focus, consulte Como funciona o cancelamento de ruído SDK do Amazon Chime.

O Amazon Voice Focus reduz ruídos indesejados que não são de fala, incluindo:

  • Ruídos ambientais – vento, ventiladores, água corrente

  • Ruídos de fundo – cortadores de grama, latido de cães

  • Ruídos em primeiro plano – digitação, embaralhamento de papéis

nota

Quando você usa o Amazon Voice Focus, AWS cobra pelos minutos de chamada ativos de cada trecho de chamada e por cada minuto de uso do aplicativo de SIP mídia.

Este exemplo mostra uma ação VoiceFocus típica.

{
    "SchemaVersion": "1.0",
    "Actions":[
        {
            "Type": "VoiceFocus",
            "Parameters": {
                "Enable": True|False,            // required
                "CallId": "call-id-1",           // required    
            }
        }
    ]
}
Enable

Descrição – Ativa ou desativa o Amazon Voice Focus

Valores permitidos: True | False

Obrigatório – Sim

Valor padrão: nenhum

CallId

Descrição — CallId do participante na CallDetails invocação da AWS Lambda função

Valores permitidos: um ID de chamada válido

Obrigatório – Sim

Valor padrão: nenhum

Este exemplo mostra um evento ACTION_SUCCESSFUL bem-sucedido para a ação VoiceFocus.

{
   "SchemaVersion": "1.0",
   "Sequence": 3,
   "InvocationEventType": "ACTION_SUCCESSFUL",
   "ActionData": {
      "Type": "VoiceFocus",
      "Parameters": {
         "Enable": True,
         "CallId": "call-id-1"
      }
   },
   "CallDetails":{
      .....
      .....
      "Participants":[
         {
            "CallId": "call-id-of-caller",
            .....   
            "Status": "Connected"
         },
         {
            "CallId": "call-id-of-callee",
            .....
            "Status": "Connected"
         }
      ]
   }
}

Este exemplo mostra um evento ACTION_FAILED típico para a ação VoiceFocus.

{
   "SchemaVersion": "1.0",
   "Sequence":2,
   "InvocationEventType": "ACTION_FAILED",
      "ActionData":{
      "Type": "VoiceFocus",
      "Parameters": {
         "Enable": True,
         "CallId": "call-id-1"
      }
      },
      "ErrorType": "SystemException",
      "ErrorMessage": "System error while running action"
   },
   "CallDetails":{
      .....
      .....
      "Participants":[
         {
            "CallId": "call-id-of-caller",
            .....   
         }
      ]
   }
}
Tratamento de erros

Por motivos de segurança, as ações PSTN de áudio têm um limite de 5 solicitações de chamada por segundo, por conta de cliente (CPS). Quando as solicitações de chamada excedem o CPS limite de 5, a ação retorna uma mensagem de erro. Esta tabela lista as mensagens de erro apresentadas pela ação VoiceFocus.

Erro Message Motivo

ActionExecutionThrottled

 Falha ao executar a ação. O número máximo de ações por segundo foi atingido.

O número de solicitações de ação do Voice Focus por segundo excedeu o limite do sistema.

MissingRequiredActionParameter

Parâmetro de ação obrigatório ausente.

Falta um ou mais dos parâmetros obrigatórios ao executar a ação.

SystemException

Erro do sistema ao executar a ação.

Ocorreu um erro do sistema na execução da ação.
Fluxos de chamadas

Este diagrama mostra o fluxo de chamadas para ativar e desativar o Amazon Voice Focus para uma CallAndBridge ação entre duas PSTN chamadas.

O fluxo de chamadas quando você ativa ou desativa o Amazon Voice Focus para duas PSTN chamadas interligadas.

Para o trecho de chamada externa, a AWS Lambda função permite que o Amazon Voice se concentre no chamador e retorna um conjunto de ações, inclusive. CallAndBridge Depois que a chamada é interrompida, a ação VoiceFocus retorna um evento ACTION_SUCCESSFUL e a função do Lambda retorna outro conjunto de eventos que habilita o Amazon Voice Focus para a pessoa que está sendo chamada. Esse conjunto de ações inclui VoiceFocus, Enable, True e o ID do chamador. Nenhuma outra ação é tomada até que o chamador desligue. Em seguida, a função Lambda envia uma Hangup ação para o aplicativo de SIP mídia. O aplicativo desliga a pessoa que está sendo chamada e envia uma função Hangup de volta para a função do Lambda, que não realiza nenhuma ação adicional.