Conceptos clave key-concepts

Comprender los conceptos básicos de la monitorización de la concurrencia es esencial para una implementación exitosa. Esta guía explica los componentes básicos fundamentales y cómo funcionan juntos.

Conceptos principales core-concepts

Sesiones

Una sesión representa una instancia de flujo de vídeo activa. Considérelo como un "ticket" que permite a un usuario ver contenido.

Ciclo de vida de sesión

Propiedades de sesión

{
  "sessionId": "unique-session-identifier",
  "idp": "identity-provider",
  "subject": "user-identifier",
  "startTime": "2024-01-15T10:30:00Z",
  "expiresAt": "2024-01-15T10:40:00Z",
  "metadata": {
    "deviceId": "device-123",
    "channel": "Channel1",
    "contentType": "live"
  }
}

Políticas

Políticas son reglas comerciales que definen límites y restricciones para el streaming simultáneo. Determinan cuándo los usuarios pueden iniciar nuevas transmisiones.

Componentes de política

Política de ejemplo

{
  "name": "basic_stream_limit",
  "description": "Maximum 3 concurrent streams per user",
  "rules": [
    {
      "type": "maxstreams",
      "limit": 3,
      "message": "You have reached your maximum of 3 concurrent streams"
    }
  ]
}

Metadatos

Metadatos proporciona contexto sobre cada sesión. Incluye información sobre el dispositivo, el contenido, el usuario y la aplicación.

Categorías de metadatos

Metadatos obligatorios frente a opcionales

Identidad y autenticación identity-and-authentication

Proveedor de identidad (IdP)

Un proveedor de identidad es el servicio que autentica a los usuarios y proporciona su información de identidad. En la integración con Adobe Pass, suele ser un MVPD.

Ejemplos de IdP

Asunto

Un asunto es el identificador único de un usuario dentro de un proveedor de identidad. Normalmente, es el ID de cuenta o el ID de suscriptor del usuario.

Administración de sesión session-management

Latidos

Heartbeats son llamadas periódicas API que mantienen las sesiones activas. Le dicen al sistema "este usuario sigue mirando".

Requisitos de Heartbeat

Finalización de sesión

Las sesiones se pueden finalizar de varias formas:

Evaluación de políticas policy-evaluation

Cómo funcionan las políticas

Resolución de conflictos conflict-resolution

¿Qué es un conflicto?

Se produce un conflicto cuando un usuario intenta iniciar un nuevo flujo, pero sobrepasaría sus límites.

Respuesta al conflicto

Cuando se produce un conflicto, el sistema devuelve una respuesta de conflicto 409 con información detallada:

{
  "status": "error",
  "error": {
    "code": "POLICY_VIOLATION",
    "message": "Concurrent usage limit exceeded"
  },
  "evaluationResult": {
    "decision": "DENY",
    "associatedAdvice": [
      {
        "adviceType": "rule-violation",
        "attributes": {
          "rule": "max_streams",
          "threshold": 3,
          "current": 4,
          "conflicts": [
            {
              "sessionId": "session-123",
              "terminationCode": "term-456",
              "metadata": {...}
            }
          ]
        }
      }
    ]
  }
}

Estrategias de resolución

LIFO (Última entrada, primera salida)

FIFO (Primero en entrar, primero en salir)

Solicitudes e inquilinos applications-and-tenants

Aplicación

Una aplicación es un programa de software que se integra con la Monitorización de concurrencia. Cada aplicación tiene un ID único y puede tener sus propias políticas.

Ejemplos de aplicaciones

Inquilino

Un inquilino es una organización que posee una o más aplicaciones. Los inquilinos pueden compartir directivas entre aplicaciones.

Estructura del inquilino

Tenant: "Streaming Company"
├── Application: "Mobile App"
├── Application: "Web App"
└── Application: "TV App"

Entornos environments

Entorno de ensayo

Entorno de producción

Flujo de integración integration-flow

Flujo básico

Control de errores

Terminología común common-terminology