Perguntas frequentes sobre o SDK do Amazon Chime

Somente participantes com um token de participação obrigatório. Ao usar o CreateAttendee,, ou BatchCreateAttendeeCreateMeetingWithAttendees APIs, você cria tokens de junção que você passa para os clientes e permite que eles participem de reuniões. Os tokens gerados por eles APIs são autenticados pelo serviço e isso concede permissão para participar da reunião.

As cotas de participantes são definidas por reunião. O SDK do Amazon Chime comporta 250 participantes em uma sessão padrão e 100 participantes em uma sessão de alta definição. Se você precisar de mais participantes, pense em usar a replicação de mídia. Isso permite até 10 mil participantes depois de solicitar um aumento de limite por meio do Console do AWS Support Center. Para ter mais informações sobre a replicação de mídia, consulte Usar replicação de mídia para reuniões do SDK do Amazon Chime no início deste guia.

Não. O SDK do Amazon Chime só cobra quando os participantes participam de uma reunião. Além disso, as reuniões terminam automaticamente cinco minutos após o último participante ativo ser retirado ou sair da reunião.

AttendeeLefté acionado quando um participante decide sair de uma reunião. AttendeeDroppedé acionado quando um participante é desconectado de uma reunião, geralmente devido a problemas de rede. AttendeeDeletedé acionado quando o DeleteAttendeeA API é chamada.

AttendeeLeft também é acionado quando:

Para ter mais informações sobre eventos de reunião, consulte Noções básicas sobre eventos do ciclo de vida de reuniões do SDK do Amazon Chime no início deste guia.

As reuniões terminam automaticamente quando:

Por padrão, a biblioteca cliente do Amazon Chime SDK JavaScript tenta se reconectar por dois minutos, conforme especificado no evento da reunião. MeetingSessionConfiguration Além disso, o SDK do Amazon Chime envia um evento AttendeeDropped caso o participante seja retirado da reunião e não se reconecte mais à sessão.

Para ter mais informações sobre eventos de reunião, consulte Monitoramento mais adiante nestas perguntas frequentes.

Sim. Todas as mídias são criptografadas em trânsito e fluem pelo serviço. A mídia é criptografada entre os clientes e a instância de mídia específica que hospeda a reunião. A instância de mídia descriptografa o áudio para mixagem e, depois, criptografa o áudio mixado para transmissão ao cliente. Se a mídia estiver sendo gravada por meio da captura de mídia, a mídia será criptografada entre a instância de mídia e a instância de captura.

Não. No entanto, os fluxos de vídeo podem ser pausados quando a largura de banda é restrita.

É possível controlar programaticamente os fluxos de vídeo que cada cliente assina. Isso permite implementar uma lógica, como “apresentador sempre visível” ou “anfitrião da reunião sempre visível” em uma tela paginada. Se um cliente tiver recursos limitados, será possível desativar os fluxos de menor prioridade. Para obter mais informações, consulte o Guia do usuário sobre a política de downlink baseada em prioridades em. GitHub

Suportamos transmissão simultânea de vídeo com H.264 VP8 e codificação de vídeo escalável com. VP9 A biblioteca cliente do Amazon Chime SDK JavaScript permite que você especifique as preferências de codec para o envio de vídeo. As bibliotecas de clientes do iOS e do Android selecionam automaticamente um codec para você, com base nos recursos do dispositivo. Para ter mais informações sobre codecs de vídeo, consulte Configurar codecs de vídeo para reuniões do SDK do Amazon Chime no início deste guia. Para obter mais informações sobre transmissão simultânea adaptativa e políticas diferentes, consulte Transmissão simultânea de vídeo em. GitHub

Não. A redução de eco é ativada no nível da reunião para todos os participantes quando você liga para o CreateMeeting ou CreateMeetingWithAttendees APIs. Para obter mais informações sobre como usar a redução de eco, consulte Adicionar redução de eco ao seu aplicativo e Habilitar o foco de voz com redução de eco, ambos em. GitHub

Usamos o Amazon Voice Focus, uma tecnologia de supressão de ruído criada pela AWS. Para saber mais sobre o Amazon Voice Focus, consulte Noções básicas VoiceFocus para o serviço de áudio Amazon Chime SDK PTSN e Como configurar para o Amazon Voice Focus no início deste guia.

Dependendo de como você codifica sua solução, os participantes da reunião geralmente ativam ou desativam a supressão de ruído. As bibliotecas de clientes do SDK do Amazon Chime expõem controles programáticos para supressão de ruído, e você escolhe como implementá-los. Por exemplo, é possível fornecer um botão de alternância ou uma configuração em nível de aplicação para controlar a supressão de ruído. Para obter mais informações, consulte Amazon Voice Focus on GitHub.

Temos algoritmos v1 e v2. O algoritmo v1 tem quatro opções com base nas utilizações de CPU (10% a 40%). O algoritmo v2 efetivamente utiliza uma quantidade de desfoque alta, média ou baixa. A demonstração baseada em JavaScript navegador GitHub fornece um exemplo prático.

Para um JavaScript cliente, o navegador fornece os quadros de tela para a biblioteca do cliente. A resolução é a nativa da tela compartilhada, limitada pela resolução máxima comportada pela reunião. É possível definir taxas de quadros, mas lembre-se de que as mais altas aumentam as cargas de CPU.

Também é possível escolher um codec para compartilhamento. Na reunião de definição padrão, a resolução é 1080p e codificada em 1,5 Mbps. Em reuniões de alta definição, a resolução é codificada em 4K a 2,5 Mbps.

Os navegadores de dispositivos móveis não aceitam a captura nem o compartilhamento de tela. Você precisa usar o iOS ou o SDKs Android GitHub para desenvolver um aplicativo que ofereça suporte ao compartilhamento de tela. Para obter mais informações, consulte os seguintes tópicos sobre GitHub:

Use o Amazon Transcribe para remover PII. Quando você usa o StartMeetingTranscriptionAPI Para transcrever uma reunião, você pode especificar o tipo de redação do conteúdo e as diferentes entidades de PII a serem redigidas.

Sim. Se você assinar transcribeEvent, cada cliente receberá esse evento, e você poderá exibi-lo no cliente para os usuários finais. Para ter mais informações, consulte Noções básicas sobre os eventos de transcrição ao vivo do SDK do Amazon Chime no início deste guia.

O exemplo a seguir mostra um modo de assinar transcribeEvent.

useEffect(() => {
        if (audioVideo) {
            audioVideo.transcriptionController?.subscribeToTranscriptEvent((transcriptEvent) => {
                setTranscripts(transcriptEvent);
            });
        }
    }, [audioVideo]);

Para ter mais informações sobre como usar transcribeEvent, consulte Noções básicas sobre os eventos de transcrição ao vivo do SDK do Amazon Chime no início deste guia.

useEffect(() => {
        if (audioVideo) {
            audioVideo.transcriptionController?.subscribeToTranscriptEvent((transcriptEvent) => {
                setTranscripts(transcriptEvent);
            });
        }
    }, [audioVideo]);

Você usa o Amazon Transcribe para criar vocabulários e filtros de vocabulário personalizados, e quando liga para o StartMeetingTranscriptionAPI, você fornece VocabularyFilterName VocabularyFilterMethod valores para mascarar palavras indesejadas. Para ter mais informações, consulte Custom vocabularies e Creating a vocabulary filter no Guia do desenvolvedor do Amazon Transcribe.

Para transcrição ao vivo em tempo real, o Amazon Transcribe aceita:

Para ter mais informações sobre os idiomas disponíveis para transcrição em tempo real ou em lote, consulte Supported languages and language-specific features no Guia do desenvolvedor do Amazon Transcribe.

Sim. O Service Quotas é aplicado por endpoint da API. A mudança para outro endpoint de API aplica os limites padrão.

Consulte os seguintes tópicos neste guia:

Sim. Para usar os eventos, é necessário migrar do namespace chime para o namespace chimesdk. Para ter mais informações, consulte os seguintes tópicos neste guia:

Enviamos eventos para reuniões e participantes via Amazon EventBridge, Amazon SNS ou Amazon SQS. Os eventos contêm informações, como horários de início e de término da reunião e ações de entrada, de saída e de retirada de participantes. Para ter mais informações sobre eventos de reunião e como usá-los, consulte os seguintes tópicos:

As métricas são AttendeeAuthorizationSuccess, AttendeeAuthorizationErrors e AttendeeAudioDrops. Para saber mais sobre as métricas, consulte Entendendo CloudWatch as métricas da Amazon para reuniões do Amazon Chime SDK no início deste guia.

O SDK do Amazon Chime gera eventos de reunião com base em diferentes estados dos componentes na aplicação cliente, como áudio, vídeo, compartilhamento de tela ou atividades dos participantes. Você pode gravar esses eventos nos CloudWatch registros e, em seguida, criar um painel sobre esses registros. É possível incluir diferentes eventos, mensagens de erro e códigos de status para ajudar a extrair insights dos dados.

O Amazon Chime SDK também se integra à Amazon, EventBridge Amazon SQS e Amazon SNS para rastrear eventos do lado do servidor, como solicitações para criar ou excluir reuniões, participantes ou canais de mídia. Você pode configurar regras para filtrar os eventos nos quais está interessado e gravá-los nos CloudWatch registros.

Para saber mais sobre eventos de reunião e como usá-los para criar painéis, consulte:

Para experimentar, siga as instruções nestas publicações do blog:

As duas formas de encerrar uma reunião acionam o evento MeetingFailed. Se você não tiver uma trilha de nuvem ou uma EventBridge entrada para o DeleteMeetingAPI, você pode assumir que a reunião terminou automaticamente.

Execute o seguinte comando e sinalizadores: chrome —enable-logging —vmodule=*/webrtc/*=1. Isso ativa o registro em log IFO e VERBOSE para WebRTC. O log resultante é chamado de chrome_debug.log e salvo no diretório de dados do usuário do Chrome.

Siga estas etapas:

Faça o seguinte:

Esse erro geralmente ocorre quando o serviço não consegue resolver o ARN de um pipeline de mídia. Certifique-se de que o ARN pertença a um canal de mídia e não a uma reunião. MediaPipelineArnfaz parte do CreateMediaCapturePipelineResposta da API.

Esse erro é gerado quando o mesmo participante ingressa por meio de dois dispositivos. O erro é exibido no atributo meetingErrorMessage de um evento meetingFailed. Para evitar isso, certifique-se de que cada participante tenha uma resposta exclusiva ExternalUserId e certifique-se de não usar a mesma resposta do participante do CreateAttendee, BatchCreateAttendee, ou CreateMeetingWithAttendees APIs em duas ou mais reuniões simultaneamente.

Você está chamando uma API obsoleta do Amazon Chime. Para resolver o problema, migre para o namespace do SDK do Amazon Chime. Para ter mais informações, consulte os seguintes tópicos no início deste guia:

Você está chamando uma API obsoleta do Amazon Chime. Para resolver o problema, migre para o namespace do SDK do Amazon Chime. Para ter mais informações, consulte os seguintes tópicos no início deste guia:

O token de solicitação do cliente é um identificador exclusivo que torna as solicitações de API idempotentes. Esse erro ocorre quando o token está associado a um pipeline de mídia inativo. Para corrigir o problema, gere um token exclusivo e envie-o com a solicitação da API.

A captura de mídia usa o MP4 formato. Isso inclui segmentos de cinco segundos e arquivos combinados de gravação e de composição.

Para excluir os participantes da captura de mídia, você pode encerrar o pipeline ou ligar para o DeleteMediaCapturePipelineAPI.

Os pipelines de captura de mídia gravam diretamente no bucket do Amazon S3. A captura de mídia não impõe requisitos de largura de banda ou conectividade aos clientes.

Para escolher uma região para criar capturas de mídia, primeiro escolha um endpoint de API entre as regiões disponíveis do ambiente de gerenciamento de reuniões. Depois, crie a reunião e o pipeline de captura de mídia nessa região. A captura de mídia pode gravar em um bucket do Amazon S3 em sua conta em qualquer região de mídia do SDK do Amazon Chime. Para ter mais informações sobre as regiões e os endpoints disponíveis, o ambiente de gerenciamento do pipeline de mídia e as regiões de mídia, consulte Regiões da AWS disponíveis para o SDK do Amazon Chime no início deste guia e Amazon Chime SDK endpoints and quotas no Guia de referência da AWS .

Não. Um pipeline captura apenas os primeiros 25 fluxos de vídeo.

Você pode criar um mecanismo para chamar o DeleteMediaCapturePipelineAPI após um determinado número de minutos. Por exemplo, é possível criar uma função de etapa que comece quando a captura de mídia se inicia e tenha um tempo de espera predeterminado.

Você pode ligar para o DeleteMediaCapturePipelineAPI para finalizar as gravações, ou você pode chamar o DeleteMeetingAPI quando a reunião está programada para terminar. Durante uma reunião, se o participante da captura de mídia for o único participante restante, a reunião será encerrada automaticamente após cinco minutos.

Não. Não é possível direcionar um número que não seja dos EUA para um conector de voz usando áudio PSTN.

Sim. Primeiro, chame a ação Hangup para o trecho conectado à reunião. Isso desconecta o participante da reunião sem encerrar a chamada recebida. Depois, chame a ação JoinChimeMeeting para inserir os participantes na nova reunião.