Principais conceitos key-concepts

Entender os conceitos principais de Monitoramento de simultaneidade é essencial para uma implementação bem-sucedida. Este guia explica os elementos fundamentais e como eles trabalham juntos.

Conceitos principais core-concepts

Sessões

Uma sessão representa uma instância de streaming de vídeo ativa. Pense nisso como um "tíquete" que permite ao usuário assistir ao conteúdo.

Ciclo de vida da sessão

Propriedades da sessão

{
  "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 são regras de negócios que definem limites e restrições para streaming simultâneo. Eles determinam quando os usuários podem iniciar novos fluxos.

Componentes da política

Exemplo de política

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

Metadados

Os metadados fornecem contexto sobre cada sessão. Inclui informações sobre o dispositivo, conteúdo, usuário e aplicativo.

Categorias de metadados

Metadados obrigatórios vs. opcionais

Identidade e autenticação identity-and-authentication

Provedor de identidade (IdP)

Um Provedor de Identidade é o serviço que autentica usuários e fornece suas informações de identidade. Na integração do Adobe Pass, geralmente é uma MVPD.

Exemplos de IdP

Assunto

Um assunto é o identificador exclusivo de um usuário em um Provedor de Identidade. Normalmente, é a ID da conta do usuário ou a ID do assinante.

Gerenciamento de sessão session-management

Heartbeats

Heartbeats são chamadas de API periódicas que mantêm as sessões ativas. Eles informam ao sistema "este usuário ainda está assistindo".

Requisitos do Heartbeat

Término da sessão

As sessões podem ser encerradas de várias maneiras:

Avaliação de política policy-evaluation

Como as políticas funcionam

Resolução de Conflitos conflict-resolution

O que é um conflito?

Um conflito ocorre quando um usuário tenta iniciar um novo fluxo, mas excede seus limites.

Resposta de Conflito

Quando ocorre um conflito, o sistema retorna uma resposta de Conflito 409 com informações detalhadas:

{
  "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": {...}
            }
          ]
        }
      }
    ]
  }
}

Estratégias de resolução

LIFO (Última Entrada, Primeira Saída)

FIFO (Primeiro a entrar, primeiro a sair)

Aplicativos e inquilinos applications-and-tenants

Aplicativo

Um aplicativo é um programa de software que se integra ao Monitoramento de Simultaneidade. Cada aplicativo tem uma ID exclusiva e pode ter suas próprias políticas.

Exemplos de aplicação

Inquilino

Um locatário é uma organização que possui um ou mais aplicativos. Os locatários podem compartilhar políticas entre aplicativos.

Estrutura do inquilino

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

Ambientes environments

Ambiente de preparo

Ambiente de produção

Fluxo de integração integration-flow

Fluxo básico

Tratamento de erros

Terminologia comum common-terminology