Concetti chiave key-concepts

Comprendere i concetti fondamentali del monitoraggio della concorrenza è essenziale per una corretta implementazione. Questa guida illustra gli elementi di base e il modo in cui funzionano insieme.

Concetti di base core-concepts

Sessioni

Una sessione rappresenta un'istanza di streaming video attiva. Consideralo come un "ticket" che consente a un utente di guardare i contenuti.

Ciclo di vita della sessione

Proprietà sessione

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

Criteri

I criteri sono regole aziendali che definiscono limiti e restrizioni per lo streaming simultaneo. Essi determinano quando gli utenti possono avviare nuovi flussi.

Componenti dei criteri

Esempio di criterio

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

Metadati

I metadati forniscono il contesto di ogni sessione. Include informazioni sul dispositivo, sul contenuto, sull’utente e sull’applicazione.

Categorie metadati

Metadati obbligatori e facoltativi

Identità e autenticazione identity-and-authentication

Provider di identità (IdP)

Un provider di identità è il servizio che autentica gli utenti e fornisce le relative informazioni di identità. Nell’integrazione di Adobe Pass, in genere si tratta di un MVPD.

Esempi di IdP

Oggetto

Un oggetto è l'identificatore univoco di un utente all'interno di un provider di identità. In genere si tratta dell’ID account o dell’ID dell’abbonato dell’utente.

Gestione delle sessioni session-management

Heartbeats

Gli heartbeat sono chiamate API periodiche che mantengono attive le sessioni. Dicono al sistema che "l'utente sta ancora guardando".

Requisiti Heartbeat

Terminazione sessione

Le sessioni possono essere terminate in diversi modi:

Valutazione dei criteri policy-evaluation

Funzionamento dei criteri

Risoluzione dei conflitti conflict-resolution

Che cos'è un conflitto?

Un conflitto si verifica quando un utente tenta di avviare un nuovo flusso ma supera i propri limiti.

Risposta al conflitto

Quando si verifica un conflitto, il sistema restituisce una risposta di conflitto 409 con informazioni dettagliate:

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

Strategie di risoluzione

LIFO (ultimo ingresso, primo uscita)

FIFO (primo ingresso, primo uscita)

Applicazioni e tenant applications-and-tenants

Applicazione

Un'applicazione application è un programma software che si integra con il monitoraggio della concorrenza. Ogni applicazione ha un ID univoco e può avere i propri criteri.

Esempi di applicazioni

Tenant

Un tenant è un'organizzazione proprietaria di una o più applicazioni. I tenant possono condividere i criteri tra le applicazioni.

Struttura tenant

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

Ambienti environments

Ambiente di staging

Ambiente di produzione

Flusso di integrazione integration-flow

Flusso di base

Gestione degli errori

Terminologia comune common-terminology