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á.
Como migrar para o namespace SDK Meetings do Amazon Chime
O namespace SDK do Amazon Chime Meetings é um local dedicado às APIs que criam e gerenciam recursos de reunião do SDK do Amazon Chime. 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 disponíveis neste guia.
Os aplicativos existentes que usam o namespace Amazon Chime devem planejar a migração para o namespace dedicado para usar as APIs e atributos mais recentes.
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.
- APIs de reunião atualizadas e novas
Só adicionamos ou atualizamos as APIs de reuniões no namespace SDK do Amazon Chime 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 | ChimeSDKMeetings | 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 | Available (Disponível) |
ExternalMeetingId |
A validação inclui correspondência de padrões | Available (Disponível) |
ExternalUserId |
A validação inclui correspondência de padrões | Available (Disponível) |
| APIs de tags de reunião | TagResource, UntagResource, ListTagsForResource |
TagMeeting, UntagMeeting, ListMeetingTags |
| Etiquetas de participantes | Indisponível | Available (Disponível) |
| Redução de eco | Available (Disponível) | Indisponível |
| Identificação do idioma da transcrição ao vivo | Available (Disponível) | Indisponível |
| Recursos do participante | Available (Disponível) | Indisponível |
| Replicação de mídia | Available (Disponível) | Indisponível |
| AppKeys e TenantIds | Available (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 ter mais informações, consulte Como migrar para o namespace ChimeSdkMediaPipelines. | 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 | Available (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 disponíveis 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 SDK do Amazon Chime Meetings contém somente APIs para criar e gerenciar reuniões. O namespace Amazon Chime inclui APIs para reuniões e outras partes do serviço Amazon Chime.
No namespace Amazon Chime SDK Meetings, as CreateMeetingWithAttendeesAPIs CreateMeetinge exigem que os campos e sejam especificadosExternalMeetingId. MediaRegion
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 Como usar replicação de mídia 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 Usando AppKeys e inquilinando IDs 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 de 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.
