Migrar para o namespace de reuniões do SDK do Amazon Chime - SDK do Amazon Chime

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á.

Migrar para o namespace de reuniões do SDK do Amazon Chime

O namespace Amazon Chime SDK Meetings é um local dedicado para quem cria e gerencia recursos de reuniões do APIs Amazon Chime SDK. Você usa o namespace para endereçar endpoints de API de reunião do SDK do Amazon Chime em qualquer região da AWS em que estejam disponíveis. Use esse namespace se você acabou de começar a usar o SDK do Amazon Chime. Para obter mais informações sobre as regiões, consulte Regiões da AWS disponíveis para o SDK do Amazon Chime neste guia.

Os aplicativos existentes que usam o namespace Amazon Chime devem planejar a migração para o namespace dedicado a fim de usar os recursos mais recentes. APIs

Motivos para migrar

Recomendamos que você migre para o namespace SDK do Amazon Chime Meetings pelos seguintes motivos:

Escolha do endpoint de API

O namespace SDK do Amazon Chime Meetings é o único namespace da API que pode usar endpoints da API em qualquer região que os disponibilize. Se quiser usar outros endpoints da API diferentes de us-east-1, você deve usar o namespace SDK do Amazon Chime Meetings.

Para obter mais informações sobre como as reuniões do Amazon Chime SDK usam AWS regiões, consulte Regiões de reunião neste guia.

Reunião atualizada e nova APIs

Só adicionamos ou atualizamos reuniões APIs no namespace Amazon Chime SDK Meetings.

Antes de migrar

Antes de migrar, observe as diferenças entre os namespaces. A tabela a seguir lista e descreve-os.

Namespace SDK do Amazon Chime Meetings Namespace Amazon Chime
AWS Namespace do SDK Carrilhão SDKMeetings Chime
Regiões Vários Somente us-east-1
Endpoints https://meetings-chime.region.amazonaws.com https://service.chime.aws.amazon.com
Entidade principal do serviço meetings.chime.amazonaws.com chime.amazonaws.com
APIs Somente APIs para reuniões APIs para reuniões e outras partes do Amazon Chime
CreateMeeting ExternalMeetingId e MediaRegion são obrigatórios. ExternalMeetingId e MediaRegion são opcionais.
CreateMeetingWithAttendees ExternalMeetingId e MediaRegion são obrigatórios. ExternalMeetingId e MediaRegion são opcionais.
ListMeetings Indisponível Disponível
ExternalMeetingId A validação inclui correspondência de padrões Disponível
ExternalUserId A validação inclui correspondência de padrões Disponível
Etiquetas de reunião APIs TagResource, UntagResource, ListTagsForResource TagMeeting, UntagMeeting, ListMeetingTags
Tags de participantes Indisponível Disponível
Redução de eco Disponível Indisponível
Identificação do idioma da transcrição ao vivo Disponível Indisponível
Recursos do participante Disponível Indisponível
Replicação de mídia Disponível Indisponível
AppKeys and TenantIds Disponível Indisponível
Pipelines de mídia Os pipelines de mídia oferecem suporte a várias regiões no namespace SDK do Amazon Chime Meetings. Para obter mais informações, consulte Migrar para o namespace de pipelines de mídia do SDK do Amazon Chime. Disponível por meio do endpoint us-east-1
Aplicativo de mídia SIP A ação JoinChimeMeeting exige MeetingId A ação JoinChimeMeeting não exige MeetingId

Integração direta com SIP

Indisponível Disponível

Diferenças entre os namespaces

As seções a seguir explicam as diferenças entre os namespaces Amazon Chime e Amazon Chime SDK Meetings.

O namespace SDK do Amazon Chime usa o nome formal Chime. O namespace SDK do Amazon Chime Meetings usa o nome formal ChimeSDKMeetings. O formato preciso do nome varia de acordo com a plataforma.

Por exemplo, se você usa o AWS SDK no Node.js para criar reuniões, você usa uma linha de código para endereçar o namespace.

const chimeMeetings = AWS.Chime();

Para migrar para o SDK do Amazon Chime Meetings, atualize essa linha de código com o novo namespace e a região do endpoint.

const chimeMeetings = AWS.ChimeSDKMeetings({ region: "eu-central-1" });

O namespace Amazon Chime só pode referenciar endpoints de API na região us-east-1. O namespace SDK do Amazon Chime Meetings pode endereçar os endpoints da API de reuniões do SDK do Amazon Chime em qualquer região em que estejam disponíveis. Para obter uma lista atual das regiões de reunião, consulte Regiões da AWS disponíveis para o SDK do Amazon Chime neste guia.

O namespace SDK do Amazon Chime Meetings usa endpoints de API diferentes do namespace Amazon Chime.

Somente o endpoint usado para criar uma reunião pode ser usado para modificá-la. Isso significa que uma reunião criada por meio de um endpoint no EU-CENTRAL-1 só pode ser modificada por meio do EU-CENTRAL-1. Isso também significa que você não pode abordar uma reunião criada por meio do namespace Chime com o namespace ChimeSDKMeetings em US-EAST-1. Para obter mais informações sobre os endpoints atuais, consulte Mapeamento de API neste guia.

O namespace SDK do Amazon Chime Meetings usa uma nova entidade principal de serviço: meetings.chime.amazonaws.com. Se você tiver SQS, SNS ou outras políticas de acesso do IAM que concedem acesso ao serviço, precisará atualizá-las para conceder acesso à nova entidade principal de serviço.

O namespace Amazon Chime SDK Meetings contém apenas APIs para criar e gerenciar reuniões. O namespace Amazon Chime inclui APIs reuniões e outras partes do serviço Amazon Chime.

No namespace Amazon Chime SDK Meetings, o CreateMeeting e CreateMeetingWithAttendees APIs exigem que os MediaRegion campos ExternalMeetingId e sejam especificados.

O namespace SDK do Amazon Chime Meetings impõe a validação adicional dos valores que podem ser usados para ExternalMeetingId e ExternalUserId.

O namespace SDK do Amazon Chime Meetings oferece redução de eco baseada em machine learning para ajudar a evitar que o ruído e o som do alto-falante local circulem de volta para a reunião. Consulte o guia em GitHub para obter mais informações.

O namespace SDK do Amazon Chime Meetings fornece controle granular sobre os recursos dos participantes em uma reunião para enviar e receber áudio, vídeo e conteúdo.

O namespace SDK do Amazon Chime Meetings oferece replicação de mídia para vincular uma reunião principal a reuniões de réplica para reunir até 10.000 pessoas em uma sessão em tempo real. Os participantes conectados a uma sessão de réplica recebem a mídia dos apresentadores conectados à sessão principal, mas podem ser promovidos à reunião principal. Para obter mais informações, consulte Usar replicação de mídia para reuniões do SDK do Amazon Chime neste guia.

O namespace SDK do Amazon Chime Meetings fornece uma forma de limitar o acesso de uma rede a reuniões específicas do SDK do Amazon Chime. Para obter mais informações, consulte Uso AppKeys e locatário IDs para o Amazon Chime SDK neste guia.

Os pipelines de mídia do SDK do Amazon Chime funcionam com reuniões criadas por qualquer endpoint de reuniões, com o namespace SDK do Amazon Chime Meetings ou Amazon Chime. Consulte as Regiões disponíveis para obter a lista mais recente de regiões do pipeline de mídia.

Os aplicativos de mídia de SIP do SDK do Amazon Chime funcionam com reuniões criadas por qualquer endpoint de reuniões, com o namespace SDK do Amazon Chime Meetings ou Amazon Chime. Ao usar aplicativos de mídia SIP com uma reunião criada por meio do namespace SDK do Amazon Chime Meetings, a ação JoinChimeMeeting exige o parâmetro MeetingId.

O namespace Meetings tem uma lista crescente do APIs que o namespace Chime não tem. Se você está começando a usar o SDK do Amazon Chime, use o namespace Meetings para acessar os atributos mais recentes.