Viktiga begrepp key-concepts

Det är viktigt att förstå de centrala begreppen för övervakning av samtidig användning (Concurrency Monitoring) för att implementeringen ska lyckas. Den här guiden förklarar de grundläggande byggstenarna och hur de fungerar tillsammans.

Kärnbegrepp core-concepts

Sessioner

En session representerar en aktiv videoströmningsinstans. Tänk på det som en biljett som gör att en användare kan titta på innehållet.

Sessionslivscykel

Sessionsegenskaper

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

Profiler

Principer är affärsregler som definierar begränsningar och begränsningar för samtidig direktuppspelning. De avgör när användare kan starta nya strömmar.

Principkomponenter

Exempel

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

Metadata

Metadata ger kontext om varje session. Den innehåller information om enheten, innehållet, användaren och programmet.

Metadatakategorier

Obligatoriska och valfria metadata

Identitet och autentisering identity-and-authentication

Identitetsleverantör (IdP)

En identitetsleverantör är den tjänst som autentiserar användare och tillhandahåller deras identitetsinformation. I Adobe Pass-integration är detta vanligtvis en MVPD.

IdP-exempel

Ämne

Ett ämne är den unika identifieraren för en användare inom en identitetsleverantör. Detta är vanligtvis användarens konto-ID eller prenumerations-ID.

Sessionshantering session-management

Hjärtslag

Heartbeats är periodiska API-anrop som håller sessionerna aktiva. De säger till systemet att "den här användaren fortfarande tittar".

Krav för pulsslag

Sessionsavslut

Sessioner kan avslutas på flera sätt:

Policyutvärdering policy-evaluation

Hur policyer fungerar

Konfliktlösning conflict-resolution

Vad är en konflikt?

En konflikt inträffar när en användare försöker starta en ny ström men skulle överskrida sina begränsningar.

Konfliktsvar

När en konflikt inträffar returnerar systemet ett 409-svar i konflikt med detaljerad information:

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

Strategier för resolution

LIFO (senaste in, första ut)

FIFO (först in, först ut)

Program och innehavare applications-and-tenants

Program

Ett program är ett program som integreras med Concurrency Monitoring. Varje program har ett unikt ID och kan ha egna profiler.

Programexempel

Klientorganisation

En klientorganisation är en organisation som äger ett eller flera program. Innehavare kan dela policyer mellan olika program.

Innehavarstruktur

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

Miljö environments

Mellanlagringsmiljö

Produktionsmiljö

Integreringsflöde integration-flow

Grundläggande flöde

Felhantering

Gemensam terminologi common-terminology