Uso do Amazon EventBridge com o streaming em tempo real do IVS

Você pode usar o Amazon EventBridge para monitorar seus streams do Amazon Interactive Video Service (IVS).

O Amazon IVS envia eventos de alteração sobre o status de seus streams para o Amazon EventBridge. Todos os eventos que são fornecidos são válidos. No entanto, os eventos são enviados em uma base de melhor esforço, o que significa que não há garantia de que:

• Os eventos serão entregues: um evento designado pode ocorrer (por exemplo, um participante realiza uma publicação), mas é possível que o Amazon IVS não envie um evento correspondente para o EventBridge. O Amazon IVS tenta entregar eventos por várias horas antes de desistir.

• Os eventos que são entregues vão chegar em um período especificado: você pode receber eventos com até algumas horas de atraso.

• Os eventos serão entregues: os eventos podem estar fora de ordem, especialmente se forem enviados com um curto intervalo de tempo. Por exemplo, você pode visualizar o participante como não publicado antes de visualizá-lo como publicado.

Embora seja raro que os eventos estejam ausentes, atrasados ou fora de sequência, você deve lidar com essas possibilidades se você escrever programas críticos para os negócios que dependem da ordem ou da existência de eventos de notificação.

Você pode criar regras do EventBridge para qualquer um dos seguintes eventos.

Tipo de evento	Evento	Enviado quando …
Atualização de palco do IVS	Publicação por participante	Um participante começa a publicar em um palco.
Atualização de palco do IVS	Publicação interrompida por participante	Um participante parou de publicar em um palco.

Criação de regras do Amazon EventBridge para o Amazon IVS

Você pode criar uma regra do que é acionado em um evento emitido pelo Amazon IVS. Siga as etapas em Create a rule in Amazon EventBridge no Guia do usuário do Amazon EventBridge. Quando for necessário selecionar um serviço, escolha Interactive Video Service (IVS).

Exemplos: atualização de palco

Os eventos de atualização de palco incluem um nome de evento (que classifica o evento) e metadados sobre o evento. Os metadados incluem o ID do participante que acionou o evento, os IDs de sessão e palco associados e o ID do usuário.

Publicação por participante: este evento é enviado quando um participante começa a publicar em um palco.

{
    "version": "0",
    "id": "12345678-1a23-4567-a1bc-1a2b34567890",
    "detail-type": "IVS Stage Update",
    "source": "aws.ivs",
    "account": "123456789012",
    "time": "2020-06-23T20:12:36Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:ivs:us-west-2:123456789012:stage/AbCdef1G2hij"
    ],
    "detail": {
        "session_id": "st-1234567890",
        "event_name": "Participant Published",
        "user_id": "Your User Id",
        "participant_id": "xYz1c2d3e4f"
    }
}

Publicação interrompida por participante: este evento é enviado quando um participante para de publicar em um palco.

{
    "version": "0",
    "id": "12345678-1a23-4567-a1bc-1a2b34567890",
    "detail-type": "IVS Stage Update",
    "source": "aws.ivs",
    "account": "123456789012",
    "time": "2020-06-23T20:12:36Z",
    "region": "us-west-2",
    "resources": [
        "arn:aws:ivs:us-west-2:123456789012:stage/AbCdef1G2hij"
    ],
    "detail": {
        "session_id": "st-1234567890",
        "event_name": "Participant Unpublished",
        "user_id": "Your User Id",
        "participant_id": "xYz1c2d3e4f"
    }
}