Participe de uma reunião do SDK do Amazon Chime fornecendo o token de participação do participante. Para isso, você faz chamadas do SDK da AWS para as APIs CreateMeeting e CreateAttendee para receber o token e transmiti-lo na ação. Veja o exemplo a seguir.
nota
Você não pode executar essa ação em uma chamada ancorada.
{
"Type": "JoinChimeMeeting",
"Parameters": {
"JoinToken": "meeting-attendee-join-token
",
"CallId": "call-id-1
",
"ParticipantTag": "LEG-A",
"MeetingId": "meeting-id"
}
}
- JoinToken
-
Descrição: um token de participação válido do participante da reunião do SDK do Amazon Chime
Valores permitidos: token de participação válido
Obrigatório – Sim
Valor padrão: nenhum
- CallId
-
Descrição –
CallId
do participante noCallDetails
da invocação do perfil AWS LambdaValores permitidos: um ID de chamada válido
Obrigatório – Não
Valor padrão: nenhum
- ParticipantTag
-
Descrição –
ParticipantTag
de um dos participantes conectados noCallDetails
Valores permitidos:
LEG-A
Obrigatório – Não
Valor-padrão:
ParticipantTag
docallLeg
invocado ignorado se você especificarCallId
- MeetingId
-
Descrição: um ID de reunião válido do SDK do Amazon Chime associado ao
JoinToken
. Se a reunião foi criada usando uma API no namespace Amazon Chime, o ID da reunião não é necessário. Se a reunião foi criada usando uma API no namespace SDK do Amazon Chime, o ID da reunião é necessário. A reunião é ingressada usando o endpoint da API usado para criar a reunião.Valores permitidos: um ID de reunião válido.
Obrigatório – Não.
Valor-padrão: nenhum.
O aplicativo de mídia SIP sempre invoca um perfil AWS Lambda depois de executar essa ação. Ele retorna os tipos de eventos de invocação ACTION_SUCCESSFUL
ou ACTION_FAILED
. O exemplo a seguir mostra uma estrutura de evento de invocação bem-sucedida.
{
"SchemaVersion": "1.0",
"Sequence": 4
,
"InvocationEvent": "ACTION_SUCCESSFUL",
"ActionData": {
"Type": "JoinChimeMeeting",
"Parameters": {
"JoinToken": "meeting-attendee-join-token
",
"CallId": "call-id-1
"
"ParticipantTag": "LEG-A"
}
}
"CallDetails": {
...
}
}
Tratamento de erros
Quando ocorre um erro de validação ao ancorar uma reunião, o aplicativo SIP chama seu perfil AWS Lambda com uma das mensagens de erro mostradas na tabela a seguir.
Erro | Message | Motivo |
---|---|---|
|
O valor do parâmetro |
Qualquer um dos outros parâmetros da ação é inválido ou está ausente. |
|
Erro do sistema ao executar a ação. |
Ocorreu outro tipo de erro do sistema na execução da ação. |
O exemplo a seguir mostra um evento de falha típico.
{
"SchemaVersion": "1.0",
"Sequence": 3
,
"InvocationEvent": "ACTION_FAILED",
"ActionData": {
"Type": "JoinChimeMeeting",
"Parameters": {
"JoinToken": "meeting-attendee-join-token
",
"CallId": "call-id-1
",
"ParticipantTag": "LEG-A"
},
"Error": "ErrorJoiningMeeting: Error while joining meeting."
}
"CallDetails": {
...
}
}
Veja um exemplo funcional no GitHub: https://github.com/aws-samples/amazon-chime-sma-update-call