Uso de Amazon EventBridge con la transmisión en tiempo real de IVS - Amazon IVS
Creación de reglas de Amazon EventBridge para Amazon IVSEjemplos: cambio del estado de la composiciónEjemplos: actualización de una fase

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Uso de Amazon EventBridge con la transmisión en tiempo real de IVS

Puede utilizar Amazon EventBridge para monitorear sus transmisiones de Amazon Interactive Video Service (IVS).

Amazon IVS envía eventos de cambio sobre el estado de sus transmisiones a Amazon EventBridge. Todos los eventos que se entregan son válidos. Sin embargo, los eventos se envían en la medida de lo posible, lo que significa que no hay garantía de que:

  • Los eventos se entregan: puede producirse un evento designado (por ejemplo, se publica un participante), pero es posible que Amazon IVS no envíe un evento correspondiente a EventBridge. Amazon IVS intenta entregar eventos durante varias horas antes de darse por vencido.

  • Los eventos que se entregan llegarán en un periodo de tiempo especificado: es posible que reciba eventos de hasta unas pocas horas de antigüedad.

  • Los eventos se entregan en orden: los eventos pueden estar desordenados, especialmente si se envían con poco tiempo de diferencia. Por ejemplo, puede ver un participante no publicado antes que un participante publicado.

Si bien es raro que los eventos falten, se retrasen o estén fuera de secuencia, debe gestionar estas posibilidades si escribe programas críticos para el negocio que dependen del orden o la existencia de los eventos de notificación.

Puede crear reglas de EventBridge para cualquiera de los siguientes eventos.

Tipo de evento Evento Enviado cuando…
Cambio de estado de composición del IVS Error en el destino Falló un intento de enviar la salida a un destino. Por ejemplo, se produjo un error en la transmisión a un canal porque no había ninguna clave de transmisión o se estaba produciendo otra transmisión.
Cambio de estado de composición del IVS Inicio de destino La salida a un destino se inició correctamente.
Cambio de estado de composición del IVS Fin de destino La salida a un destino ha finalizado.
Cambio de estado de composición del IVS Reconexión de destino Se interrumpió la salida a un destino y se está intentando volver a conectar.
Cambio de estado de composición del IVS Inicio de la sesión Se creó una sesión de Composición. Este evento se desencadena cuando una canalización de un proceso de Composición se inicializa correctamente. En este momento, el proceso de composición se ha suscrito correctamente a un Escenario y recibe contenido multimedia y puede componer vídeo.
Cambio de estado de composición del IVS Fin de la sesión Se ha completado una sesión de composición.
Cambio de estado de composición del IVS Error de sesión No se pudo inicializar una canalización de Composición debido a que los recursos de Escenario no estaban disponibles o a algún otro error interno.
Actualización de una fase de IVS Participante publicado Un participante comienza a publicar en una fase.
Actualización de una fase de IVS Participante no publicado Un participante ha dejado de publicar en una fase.

Creación de reglas de Amazon EventBridge para Amazon IVS

Puede crear una regla que se active en función de un evento que emita Amazon IVS. Siga los pasos que se indican en Crear una regla en Amazon EventBridge en la Guía del usuario de Amazon EventBridge. Cuando seleccione un servicio, elija Interactive Video Service (IVS).

Ejemplos: cambio del estado de la composición

Error de destino: este evento se envía cuando se produce un error al intentar enviarlo a un destino. Por ejemplo, la transmisión a un canal falló porque no había ninguna clave de transmisión o se estaba produciendo otra transmisión.

{
   "version": "0",
   "id": "01234567-0123-0123-0123-012345678901",
   "detail-type": "IVS Composition State Change",
   "source": "aws.ivs",
   "account": "aws_account_id",
   "time": "2017-06-12T10:23:43Z",
   "region": "us-east-1",
   "resources": [
     "arn:aws:ivs:us-east-1:aws_account_id:composition/123456789012"
   ],
   "detail": {
     "event_name": "Destination Failure",
     "stage_arn": "<stage-arn>",
     "id": "<Destination-id>",
     "reason": "eg. stream key invalid"
   }
}

Inicio de destino: este evento se envía cuando la salida a un destino se inicia correctamente.

{
   "version": "0",
   "id": "01234567-0123-0123-0123-012345678901",
   "detail-type": "IVS Composition State Change",
   "source": "aws.ivs",
   "account": "aws_account_id",
   "time": "2017-06-12T10:23:43Z",
   "region": "us-east-1",
   "resources": [
     "arn:aws:ivs:us-east-1:aws_account_id:composition/123456789012"
   ],
   "detail": {
     "event_name": "Destination Start",
     "stage_arn": "<stage-arn>",
     "id": "<destination-id>",
   }
}

Final de destino: este evento se envía cuando finaliza la salida a un destino.

{
   "version": "0",
   "id": "01234567-0123-0123-0123-012345678901",
   "detail-type": "IVS Composition State Change",
   "source": "aws.ivs",
   "account": "aws_account_id",
   "time": "2017-06-12T10:23:43Z",
   "region": "us-east-1",
   "resources": [
     "arn:aws:ivs:us-east-1:aws_account_id:composition/123456789012"
   ],
   "detail": {
     "event_name": "Destination End",
     "stage_arn": "<stage-arn>",
     "id": "<Destination-id>",
   }
}

Reconexión de destino: este evento se envía cuando se interrumpe la salida a un destino y se intenta volver a conectar.

{
   "version": "0",
   "id": "01234567-0123-0123-0123-012345678901",
   "detail-type": "IVS Composition State Change",
   "source": "aws.ivs",
   "account": "aws_account_id",
   "time": "2017-06-12T10:23:43Z",
   "region": "us-east-1",
   "resources": [
     "arn:aws:ivs:us-east-1:aws_account_id:composition/123456789012"
   ],
   "detail": {
     "event_name": "Destination Reconnecting",
     "stage_arn": "<stage-arn>",
     "id": "<Destination-id>",
   }
}

Inicio de sesión: este evento se envía cuando se crea una sesión de composición. Este evento se desencadena cuando una canalización de un proceso de composición se inicializa correctamente. En este momento, el proceso de composición se ha suscrito correctamente a un escenario y recibe contenido multimedia y puede componer vídeo. 

{
   "version": "0",
   "id": "01234567-0123-0123-0123-012345678901",
   "detail-type": "IVS Composition State Change",
   "source": "aws.ivs",
   "account": "aws_account_id",
   "time": "2017-06-12T10:23:43Z",
   "region": "us-east-1",
   "resources": [
     "arn:aws:ivs:us-east-1:aws_account_id:composition/123456789012"
   ],
   "detail": {
     "event_name": "Session Start",
     "stage_arn": "<stage-arn>"
   }
}

Fin de sesión: este evento se envía cuando se completa una sesión de composición y se eliminan todos los recursos.

{
   "version": "0",
   "id": "01234567-0123-0123-0123-012345678901",
   "detail-type": "IVS Composition State Change",
   "source": "aws.ivs",
   "account": "aws_account_id",
   "time": "2017-06-12T10:23:43Z",
   "region": "us-east-1",
   "resources": [
     "arn:aws:ivs:us-east-1:aws_account_id:composition/123456789012"
   ],
   "detail": {
     "event_name": "Session End",
     "stage_arn": "<stage-arn>"
   }
}

Error de sesión: este evento se envía cuando una canalización de composición no se pudo inicializar debido a que los recursos del escenario no estaban disponibles, no había participantes en el escenario o a algún otro error interno.

{
   "version": "0",
   "id": "01234567-0123-0123-0123-012345678901",
   "detail-type": "IVS Composition State Change",
   "source": "aws.ivs",
   "account": "aws_account_id",
   "time": "2017-06-12T10:23:43Z",
   "region": "us-east-1",
   "resources": [
     "arn:aws:ivs:us-east-1:aws_account_id:composition/123456789012"
   ],
   "detail": {
     "event_name": "Session Failure",
     "stage_arn": "<stage-arn>",
     "reason": "eg. no participants in the stage"
   }
}

Ejemplos: actualización de una fase

Los eventos de actualización de fases incluyen un nombre de evento (que clasifica el evento) y metadatos sobre el evento. Los metadatos incluyen el ID del participante que activó el evento, los ID de fase y sesión asociados y el ID de usuario.

Participante publicado: este evento se envía cuando un participante comienza a publicar en una fase.

{
    "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"
    }
}

Participante no publicado: este evento se envía cuando un participante ha dejado de publicar en una fase.

{
    "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"
    }
}